Spring til hovedindhold

​
1. Introduktion

Denne dokumentation beskriver, hvordan du strukturerer dine datafiler — produkter, ordrer, returneringer og relaterede data — i vores SFTP-miljø, når dit dedikerede rum er klargjort. Hvis du driver flere butikker eller har flere miljøer (prod, preprod osv.), skal du oprette en separat undermappe for hver (det kan også være forskellige brands, forskellige lande osv.).

​
Eksempel på mappestruktur

/root_space
    /shop_fr
    /shop_en
    /shop_it

​
2. Dataoverførselsplan

Datafiler bør ideelt set overføres dagligt mellem:
  • 02:00
  • 05:00
Dette tidsrum sikrer optimal behandling og dataindsamling.

​
3. Filorganiseringsstandarder

I hver butikmappe skal du oprette følgende mapper:
  • products
  • orders
  • returns
  • return_reasons (valgfri)
  • misc (valgfri)
Bemærkninger:
  • Mappen return_reasons bruges til eksportfiler med yderligere returdata såsom årsager angivet af kunder. Disse eksporter er valgfrie.
  • Mappen misc kan indeholde diverse filer. Hvis du ønsker at bruge denne mappe, bedes du drøfte hierarkiet og strukturen med os på forhånd for at sikre kompatibilitet.
Hver eksport skal placeres i den passende mappe og nul-dateret ved hjælp af et tidsstemplet filnavn.

​
Eksempel på filnavnsformat

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

​
4. Krav til eksportindhold

En detaljeret specifikation af forventede felter, formater og begrænsninger for hver datasetkategori er tilgængelig i dokumentationen Dataoverførsler: Skabelon. Nøglekrav til produktkatalogseksporter:
  • Eksportér alle produktvarianter, inkl. udsolgte varer
  • Inkludér et felt for seneste ændringsdato til inkrementel behandling
  • Vedligehold komplet variantinformation for at muliggøre korrekt størrelsesanalyse
  • Tilføj valgfrit et deaktiveringsflag til Kleep-tilstedeværelseskontrol
Se venligst skabelonen for omfattende feltdefinitioner og eksempler.

​
5. Håndtering af gentagne data på tværs af eksporter

Poster kan legitimt forekomme i flere daglige eksporter. F.eks. kan en given returnering være inkluderet flere gange på tværs af forskellige filer. Vores indsamlingssystem håndterer automatisk deduplikering og behandler kun den seneste version af hver post.

​
6. Retningslinjer for dataformat

Alle eksporter bør leveres i CSV-format. Excel-filer (.xlsx) frarådes, da de introducerer formateringsinkonsekvenser og kan komplicere automatiserede indsamlingsworkflows.
  • Datetime: Brug ISO 8601-format: YYYY-MM-DDTHH:MM:SSZ, eksempel: 2025-01-15T14:30:00Z
  • Kodning: UTF-8-kodning for alle tekstfelter, escap specialtegn korrekt i CSV
  • Booleske værdier: Brug true/false (med små bogstaver) eller True/False
  • Decimalværdier: Brug punktum (.) som decimalseparator. Eksempel: 129.99 ikke 129,99
  • Null-værdier: Tom streng for manglende valgfrie tekstfelter i CSV’er, brug null i JSON’er

​
Filnavnskonvention

Som specificeret i SFTP-datastrukturdokumentationen skal du bruge følgende format: 
{data_type}_{timestamp}.csv
Eksempler:
  • products_2025-01-15T02-00-00.csv
  • orders_2025-01-15T02-00-00.csv
  • returns_2025-01-15T02-00-00.csv

​
7. Eksport af historiske data

Hvis du skal levere historiske data (dvs. data, der ikke er en del af de daglige eksporter), kan du eksportere op til ét år af historiske poster for alle datatyper, inkl.:
  • Produkter
  • Ordrer
  • Returneringer
Historiske datasæt kan overføres enten via SFTP eller, hvis det er mere belejligt, via et andet aftalt medie.

​
Eksempel på en komplet SFTP-struktur

/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  (valgfri)
        /misc
            (valgfri, drøft venligst hierarki med os)

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

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