Zum Hauptinhalt springen

​
1. Einführung

Diese Dokumentation beschreibt, wie Sie Ihre Datendateien — Produkte, Bestellungen, Retouren und zugehörige Daten — innerhalb unserer SFTP-Umgebung strukturieren, sobald Ihr dedizierter Speicherplatz bereitgestellt wurde. Wenn Sie mehrere Shops betreiben oder mehrere Umgebungen haben (Prod, Preprod usw.), erstellen Sie bitte für jeden einen separaten Unterordner (es könnten auch verschiedene Marken, verschiedene Länder usw. sein).

​
Beispiel-Verzeichnisstruktur

/root_space
    /shop_fr
    /shop_en
    /shop_it

​
2. Zeitplan für die Datenübertragung

Datendateien sollten idealerweise täglich zwischen folgenden Zeiten übertragen werden:
  • 02:00 Uhr
  • 05:00 Uhr
Dieser Zeitrahmen gewährleistet eine optimale Verarbeitung und Datenaufnahme.

​
3. Standards für die Dateiorganisation

Erstellen Sie in jedem Shop-Verzeichnis folgende Ordner:
  • products
  • orders
  • returns
  • return_reasons (optional)
  • misc (optional)
Hinweise:
  • Der Ordner return_reasons wird für Exportdateien mit zusätzlichen Retouren-Daten verwendet, z. B. von Kunden angegebene Gründe. Diese Exporte sind optional.
  • Der Ordner misc kann verschiedene Dateien enthalten. Wenn Sie diesen Ordner verwenden möchten, besprechen Sie die Hierarchie und Struktur bitte vorher mit uns, um die Kompatibilität sicherzustellen.
Jeder Export sollte im entsprechenden Ordner abgelegt werden und einen zeitgestempelten Dateinamen verwenden.

​
Beispiel-Dateinamenformat

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

​
4. Anforderungen an den Exportinhalt

Eine detaillierte Spezifikation der erwarteten Felder, Formate und Einschränkungen für jeden Datensatztyp finden Sie in der Dokumentation Datenübertragungen: Vorlage. Hauptanforderungen für Produktkatalogexporte:
  • Exportieren Sie alle Produktvarianten, einschließlich nicht vorrätige Artikel
  • Fügen Sie ein Feld Letzte Änderungsdatum für die inkrementelle Verarbeitung ein
  • Vollständige Varianteninformationen beibehalten, um eine korrekte Größenanalyse zu ermöglichen
  • Optional ein Deaktivierungsflag für die Kleep-Präsenzkontrolle hinzufügen
Weitere Informationen zu Felddefinitionen und Beispielen finden Sie in der Vorlage.

​
5. Umgang mit wiederholten Daten in Exporten

Datensätze können legitim in mehreren täglichen Exporten erscheinen. Beispielsweise kann eine bestimmte Retoure in mehreren Dateien vorkommen. Unser Aufnahmesystem verarbeitet Deduplizierung automatisch und verarbeitet nur die aktuellste Version jedes Datensatzes.

​
6. Richtlinien für das Datenformat

Alle Exporte sollten im CSV-Format bereitgestellt werden. Excel-Dateien (.xlsx) werden abgeraten, da sie Formatierungsinkonsistenzen einführen und automatisierte Aufnahmeworkflows erschweren können.
  • Datum/Uhrzeit: Verwenden Sie das ISO 8601-Format: YYYY-MM-DDTHH:MM:SSZ, Beispiel: 2025-01-15T14:30:00Z
  • Kodierung: UTF-8-Kodierung für alle Textfelder, Sonderzeichen in CSV korrekt escapen
  • Boolesche Werte: Verwenden Sie true/false (Kleinbuchstaben) oder True/False
  • Dezimalwerte: Verwenden Sie den Punkt (.) als Dezimaltrennzeichen. Beispiel: 129.99 nicht 129,99
  • Nullwerte: Leerer String für fehlende optionale Textfelder in CSVs, null in JSONs verwenden

​
Dateinamenskonvention

Wie in der SFTP-Datenstrukturdokumentation angegeben, verwenden Sie folgendes Format: 
{data_type}_{timestamp}.csv
Beispiele:
  • products_2025-01-15T02-00-00.csv
  • orders_2025-01-15T02-00-00.csv
  • returns_2025-01-15T02-00-00.csv

​
7. Export historischer Daten

Wenn Sie historische Daten bereitstellen müssen (d. h. Daten, die nicht Teil der täglichen Exporte sind), können Sie bis zu einem Jahr historischer Datensätze für alle Datentypen exportieren, einschließlich:
  • Produkte
  • Bestellungen
  • Retouren
Historische Datensätze können entweder über das SFTP oder, wenn praktischer, über ein anderes vereinbartes Medium übertragen werden.

​
Beispiel einer vollständigen 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, bitte Hierarchie vorher mit uns besprechen)

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

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