Hoppa till huvudinnehåll

​
1. Introduktion

Den här dokumentationen beskriver hur du strukturerar dina datafiler — produkter, beställningar, returer och relaterad data — inom vår SFTP-miljö när ditt dedikerade utrymme har etablerats. Om du driver flera butiker eller har flera miljöer (prod, preprod, etc.), vänligen skapa en separat undermapp för varje (det kan också vara olika varumärken, olika länder, etc.).

​
Exempel på katalogstruktur

/root_space
    /shop_fr
    /shop_en
    /shop_it

​
2. Schema för dataöverföring

Datafiler bör helst överföras dagligen mellan:
  • 02:00
  • 05:00
Denna tidsram säkerställer optimal bearbetning och datainmatning.

​
3. Standarder för filorganisation

Inom varje butikskatalogg, vänligen skapa följande mappar:
  • products
  • orders
  • returns
  • return_reasons (valfritt)
  • misc (valfritt)
Noteringar:
  • Mappen return_reasons används för exportfiler som innehåller ytterligare returdata, till exempel skäl som kunder angett. Dessa exporter är valfria.
  • Mappen misc kan innehålla diverse filer. Om du vill använda den här mappen, diskutera hierarkin och strukturen med oss i förväg för att säkerställa kompatibilitet.
Varje export ska placeras i lämplig mapp och nollstämplas med ett tidsstämplat filnamn.

​
Exempel på filnamnsformat

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

​
4. Krav på exportinnehåll

En detaljerad specifikation av förväntade fält, format och begränsningar för varje datauppsättningstyp finns i dokumentationen Dataöverföringar: Mall. Viktiga krav för produktkatalogexporter:
  • Exportera alla produktvarianter, inklusive varor som är slut i lager
  • Inkludera ett fält för senaste ändringsdatum för inkrementell bearbetning
  • Behåll fullständig variantinformation för att möjliggöra korrekt storleksanalys
  • Lägg valfritt till en avaktiveringsflagga för Kleep-närvaro-kontroll
Se mallen för fullständiga fältdefinitioner och exempel.

​
5. Hantering av upprepade data mellan exporter

Poster kan legitimt förekomma i flera dagliga exporter. Till exempel kan en given retur ingå flera gånger i olika filer. Vårt inmatningssystem hanterar automatiskt deduplicering och behandlar bara den senaste versionen av varje post.

​
6. Riktlinjer för dataformat

Alla exporter ska tillhandahållas i CSV-format. Excel-filer (.xlsx) avråds från eftersom de introducerar formateringsinkonsekvenser och kan komplicera automatiserade inmatningsarbetsflöden.
  • Datum/tid: Använd ISO 8601-format: YYYY-MM-DDTHH:MM:SSZ, exempel: 2025-01-15T14:30:00Z
  • Kodning: UTF-8-kodning för alla textfält, korrekt undantagstecken för specialtecken i CSV
  • Booleska värden: Använd true/false (gemener) eller True/False
  • Decimalvärden: Använd punkt (.) som decimalseparator. Exempel: 129.99 inte 129,99
  • Nullvärden: Tom sträng för saknade valfria textfält i csv:er, använd null i json:er

​
Namnkonvention för filer

Enligt vad som specificeras i dokumentationen för SFTP-datastruktur, använd följande format: 
{data_type}_{timestamp}.csv
Exempel:
  • products_2025-01-15T02-00-00.csv
  • orders_2025-01-15T02-00-00.csv
  • returns_2025-01-15T02-00-00.csv

​
7. Exportera historiska data

Om du behöver tillhandahålla historiska data (d.v.s. data som inte ingår i de dagliga exporterna) kan du exportera upp till ett års historiska poster för alla datatyper, inklusive:
  • Produkter
  • Beställningar
  • Returer
Historiska datamängder kan överföras antingen via SFTP eller, om det är mer praktiskt, via ett annat överenskommet medium.

​
Exempel på en komplett 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  (optional)
        /misc
            (optional, please discuss hierarchy with us)

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

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