Naar hoofdinhoud gaan

​
1. Inleiding

Deze documentatie beschrijft hoe u uw gegevensbestanden — producten, bestellingen, retouren en gerelateerde gegevens — structureert binnen onze SFTP-omgeving zodra uw speciale ruimte is ingericht. Als u meerdere winkels beheert, of meerdere omgevingen heeft (prod, preprod, enz.), maak dan een aparte submap aan voor elk (dit kunnen ook verschillende merken, verschillende landen, enz. zijn).

​
Voorbeeldmappenstructuur

/root_space
    /shop_fr
    /shop_en
    /shop_it

​
2. Schema voor gegevensoverdracht

Gegevensbestanden dienen bij voorkeur dagelijks te worden overgedragen tussen:
  • 02:00
  • 05:00
Dit tijdvenster zorgt voor optimale verwerking en data-inname.

​
3. Normen voor bestandsorganisatie

Maak binnen elke winkelmap de volgende mappen aan:
  • products
  • orders
  • returns
  • return_reasons (optioneel)
  • misc (optioneel)
Opmerkingen:
  • De map return_reasons wordt gebruikt voor exportbestanden met aanvullende retourgegevens zoals redenen die door klanten zijn opgegeven. Deze exports zijn optioneel.
  • De map misc kan diverse bestanden bevatten. Als u deze map wilt gebruiken, bespreek dan vooraf de hiërarchie en structuur met ons om compatibiliteit te garanderen.
Elke export moet in de juiste map worden geplaatst en nuldatering gebruiken met een bestandsnaam met tijdstempel.

​
Voorbeeldformaat voor bestandsnamen

products_2025-01-15T02-00-00.csv

​
4. Vereisten voor exportinhoud

Een gedetailleerde specificatie van verwachte velden, formaten en beperkingen voor elk gegevenstype is beschikbaar in de documentatie Gegevensoverdrachten: Sjabloon. Belangrijkste vereisten voor productcatalogusexports:
  • Exporteer alle productvarianten, inclusief artikelen die niet op voorraad zijn
  • Neem een veld datum van laatste wijziging op voor incrementele verwerking
  • Behoud volledige variantinformatie om een juiste maatanalyse mogelijk te maken
  • Voeg optioneel een deactiveringsvlag toe voor beheer van Kleep-aanwezigheid
Raadpleeg het sjabloon voor uitgebreide velddefinities en voorbeelden.

​
5. Omgaan met herhaalde gegevens in exports

Records kunnen legitiem in meerdere dagelijkse exports voorkomen. Een bepaalde retour kan bijvoorbeeld in meerdere bestanden zijn opgenomen. Ons ingeestsysteem verwerkt automatisch deduplicatie en verwerkt alleen de meest recente versie van elk record.

​
6. Richtlijnen voor gegevensformaat

Alle exports dienen te worden aangeleverd in CSV-formaat. Excel-bestanden (.xlsx) worden afgeraden omdat ze opmaakinconsistenties introduceren en geautomatiseerde ingesteworkflows kunnen bemoeilijken.
  • Datum/tijd: Gebruik het ISO 8601-formaat: YYYY-MM-DDTHH:MM:SSZ, voorbeeld: 2025-01-15T14:30:00Z
  • Codering: UTF-8-codering voor alle tekstvelden, speciale tekens in CSV correct ontsnappen
  • Booleaanse waarden: Gebruik true/false (kleine letters) of True/False
  • Decimale waarden: Gebruik een punt (.) als decimaalteken. Voorbeeld: 129.99 niet 129,99
  • Null-waarden: Lege string voor ontbrekende optionele tekstvelden in csv’s, gebruik null in json’s

​
Naamgevingsconventie voor bestanden

Zoals gespecificeerd in de SFTP-gegevensstructuurdocumentatie, gebruik het volgende formaat: 
{data_type}_{timestamp}.csv
Voorbeelden:
  • products_2025-01-15T02-00-00.csv
  • orders_2025-01-15T02-00-00.csv
  • returns_2025-01-15T02-00-00.csv

​
7. Historische gegevens exporteren

Als u historische gegevens moet aanleveren (d.w.z. gegevens die geen deel uitmaken van de dagelijkse exports), kunt u tot één jaar aan historische records exporteren voor alle gegevenstypen, waaronder:
  • Producten
  • Bestellingen
  • Retouren
Historische datasets kunnen worden overgedragen via de SFTP of, indien handiger, via een ander overeengekomen medium.

​
Voorbeeld van een complete SFTP-structuur

/root_space
    /shop_fr
        /products
            products_2025-01-15T02-00-00.csv
            products_2025-01-16T02-00-00.csv
        /orders
            orders_2025-01-15T02-00-00.csv
            orders_2025-01-16T02-00-00.csv
        /returns
            returns_2025-01-15T02-00-00.csv
            returns_2025-01-16T02-00-00.csv
        /return_reasons
            return_reasons_2025-01-15T02-00-00.csv  (optioneel)
        /misc
            (optioneel, bespreek de hiërarchie vooraf met ons)

    /shop_en
        /products
        /orders
        /returns
        /return_reasons
        /misc

    /shop_it
        /products
        /orders
        /returns
        /return_reasons
        /misc