• Trust
  • Anfrage einreichen

    • Need assistance with your Emarsys product?
    We'll get you the help you need!

     

    Emarsys client

     

    Emarsys client
    SAP for Me Login

    You can contact our support team via the SAP for Me.

    The Emarsys component: CEC-EMA

    		Login to the Help Portal and Submit your request. 
    1. Emarsys
    2. Einstiegshilfe
    3. Preparing for Integration

    Sales Data Batch Loads:: Standardanforderungen für das Salesdaten-CSV
    Aktualisiert

    Um unsere Lösung Sales Data Batch Loads nutzen zu können, müssen Sie Ihr Salesdaten-CSV gemäß den auf dieser Seite beschriebenen Spezifikationen und Richtlinien formatieren.

    Allgemeine Anforderungen

    • Ihre Salesdaten-Datei sollte eine einfache .csv-Tabelle sein, wobei eine Zeile jeweils die Attribute einer einzelnen Position (eines "line item") beschreibt.
    • Der Name der Datei muss mit dem in der Konfiguration angegebenen Muster übereinstimmen.
    • Die Erweiterung der Datei muss .csv sein.
    • Sie können keine Dateien hochladen, die größer als 100 GB sind.
    • Verwenden Sie UTF-8-Codierung.
    • Die Datei muss mit einer Header-Zeile (z.B. den Feldnamen) beginnen. Die Spalten im Header Ihrer Salesdaten-Datei müssen die bei der Konfiguration definierte Reihenfolge haben.
    • Sie können die Felder nennen, wie Sie wollen, aber sie müssen Ihrer Konfiguration entsprechen.
    • Bestellungsaktualisierungen sind nicht erlaubt. Stellen Sie sicher, dass Sie die einzelnen Bestellungen jeweils nur einmal hochladen und dieselbe Kombination aus Transaktions-ID und Transaktionstyp nicht noch einmal verwenden. Bei duplizierten Datensätzen ersetzen die neuen Transaktionen die älteren.
    • Sie müssen das vollständige Bild einer Bestellung laden (keine Deltas) und sicherstellen, dass alle in einer Transaktion enthaltenen Artikel in derselben Datei hochgeladen werden.
    • Zur Trennung von Feldern in einer Zeile verwenden Sie ein beliebiges Standard-Trennzeichen, z.B. ein Komma ',', ein Semikolon ';', ein Tab '\t', einen Leerraum ' ' oder eine Pipe '|'.
    • Bei der Verwendung von Zeilenvorschubzeichen ist darauf zu achten, dass diese in Anführungszeichen gesetzt werden.
    • Sie können einfache oder doppelte Anführungszeichen verwenden.
    • Die optionalen Felder müssen in die CSV-Datei aufgenommen werden, ihre Werte können jedoch leer bleiben.
    • Laden Sie nicht mehr als 20 benutzerdefinierte Felder hoch.

    Unterstützte Datentypen

    Folgende Datentypen werden unterstützt:

    • string
    • date
    • float
    • integer

    Unterstütztes Timestamp-Format

    Sales Data Batch Loads unterstützt einen Teilbereich von ISO 8601:

    • Sie müssen Zeitdaten mit Sekundengenauigkeit angeben.
    • Sie können Sekundenbruchteile mit bis zu 6 Stellen angeben.
    • Sie müssen die Zeitzone angeben:
      • Geben Sie entweder explizit UTC Timestamps an oder
      • verwenden Sie Offsets

    Die Funktion "Sales Data Batch Loads" kann folgende Formate verarbeiten:

    • 2022-06-16T12:18:51Z
    • 2022-06-16T12:18:51.545Z
    • 2024-04-11T07:00:24-07:00
    • 2024-04-11T07:00:24.2-07:00
    • 2022-06-16T12:18:51.123456Z

    Beispiele für ungültige Angaben:

    • Wed Apr 16 2022 21:44:48 GMT-0400 (Eastern Daylight Saving Time): Dieses Beispiel folgt nicht dem ISO 8601 Standard.
    • 2023-07-15 12:00:00.000000 UTC: Dieses Beispiel folgt nicht dem ISO 8601 Standard.
    • 2024-04-11: Dieses Beispiel enthält keine Zeitdaten und Zeitzoneninformationen.
    • 2022-06-16T12:18:51.1234567Z: In diesem Beispiel werden für Sekundenbruchteile mehr als 6 Stellen verwendet (Sales Data Batch Loads kann nur 6 Stellen verarbeiten).

    Benutzerdefinierte Felder

    • Es können bis zu 20 benutzerdefinierte Felder hochgeladen werden.
    • Benutzerdefinierte Felder sind optional.
    • Die Lösung "Sales Data Batch Loads" validiert auch die Datentypen der benutzerdefinierten Felder.

    Beispiel-CSV

    So sieht eine CSV-Datei aus:

    Klicken Sie hier, um die CSV-Beispieldatei herunterzuladen.

    transactionType,transactionId,referencedOrderId,externalContactIdType,externalContactId,accountCurrency,transactionCurrency,transactionCreatedDateTime,transactionLastChangedDateTime,storeId,salesChannel,productId,quantity,amountInAccountCurrency,amountInTransactionCurrency,custom_color order,123,123,email,3,EUR,EUR,2023-07-19T12:18:51.545Z,2023-07-20T12:18:51.545Z,12,online,111,1,120,120,black order,234,234,email,3,EUR,EUR,2023-07-21T12:18:51.545Z,2023-07-22T12:18:51.545Z,12,online,222,5,1200,1200,orange order,345,345,email,3,EUR,EUR,2023-07-23T12:18:51.545Z,2023-07-24T12:18:51.545Z,12,online,333,1.5,1200,1200,blue order,456,456,email,3,EUR,EUR,2023-07-25T12:18:51.545Z,2023-07-26T12:18:51.545Z,12,online,444,140,1200,1200,purple order,456,456,email,3,EUR,EUR,2023-07-25T12:18:51.545Z,2023-07-26T12:18:51.545Z,12,online,23,140,1200,1200,purple
    Für Kopieren klicken

    Erforderliche Felder

    Folgende Felder sind für Sales Data Batch Loads erforderlich:

    Feld Typ Erforderlichkeit Beschreibung
    transactionType string Pflichtfeld
    • Beschreibt eine Bestellung oder Rückerstattung.
    • Mögliche Werte: order oder refund
    • Muss für jedes Line Item einer bestimmten Transaktion gleich sein.
    transactionId string Pflichtfeld
    • Die eindeutige Kennung der Bestellung oder Rückerstattung.
    • Bei Bestellungen oder Rückerstattungen, die mehrere Produkte umfassen, muss für jedes Line Item dieselbe transactionId verwendet werden.
    referencedOrderId string Pflichtfeld für den Typ refund
    • Kennung der Bestellung, auf die sich die Rückerstattung bezieht.
    • Ist ein Pflichtfeld, aber die Rückerstattung wird auch dann bearbeitet und geladen, wenn die referenzierte Bestellung in Emarsys nicht gefunden werden kann.
    • Muss für jedes Line Item in der Rückerstattung gleich sein.
    externalContactIdType string Pflichtfeld
    • Typ der Kontaktkennung für die Transaktion. Zum Beispiel: E-Mail, Telefonnummer.
    • Muss für jedes Line Item einer bestimmten Transaktion gleich sein.
    externalContactId string Pflichtfeld
    • Kennung des Kontakts für die Transaktion.
    • Kann eine E-Mail-Adresse, Telefonnummer etc. sein.
    • Muss für jedes Line Item einer bestimmten Transaktion gleich sein.
    account_currency string Pflichtfeld
    • Währung im ISO-Format.
    • Sie sollte mit der zentralen Währungseinstellung Ihres Accounts übereinstimmen, die bei Einrichten des Accounts festgelegt wurde.
    • Muss für jedes Line Item einer bestimmten Transaktion gleich sein.
    transaction_currency string Pflichtfeld Währung im ISO-Format.
    transactionCreatedDateTime timestamp Pflichtfeld
    • Der Zeitpunkt, zu dem die Transaktion (Bestellung oder Rückerstattung) im externen System (POS-System, Shopify, Adobe Commerce oder SAP Commerce Cloud) erstellt wurde.
    • transactionCreatedDateTime sollte immer vor jenem Zeitpunkt liegen, zu dem der Kauf geladen wurde. In der Zukunft liegende Daten werden nicht akzeptiert.
    • Muss für jedes Line Item einer bestimmten Transaktion gleich sein.
    transactionLastChangedDateTime timestamp Pflichtfeld
    • Der Zeitpunkt, zu dem die Transaktion im externen System (POS-System, Shopify, Adobe Commerce, SAP Commerce Cloud) zuletzt geändert wurde.
    • transactionLastChangedDateTime sollte immer vor jenem Zeitpunkt liegen, zu dem der Kauf geladen wurde. In der Zukunft liegende Daten werden nicht akzeptiert.
    • Muss für jedes Line Item einer bestimmten Transaktion gleich sein.
    productId string Pflichtfeld
    • Die eindeutige ID, die zur Identifizierung des Produkts verwendet wird.
    • Die hier übergebene ID sollte in Ihrer Emarsys Produktdatenbank enthalten sein.
    • Für Bestellungen, die mehrere Produkte umfassen, muss jedes Produkt (auch bekannt als Line Item) in einer eigenen Zeile mit derselben Order ID übergeben werden.
    quantity float Pflichtfeld
    • Die Anzahl der gekauften Artikel.
    • Geben Sie für Bestellungen immer einen positiven Wert oder null an.
    • Für Rückvergütungen verwenden Sie immer einen negativen Wert.
    amount_in_account_currency float Pflichtfeld
    • Der Preis pro Einheit multipliziert mit der Menge in der in Ihrem Account definierten Währung.
    • Für Rückvergütungen verwenden Sie immer einen negativen Wert.
    amount_in_transaction_currency float Pflichtfeld
    • Der Preis pro Einheit multipliziert mit der Menge in der für die Transaktion definierten Währung.
    • Für Rückvergütungen verwenden Sie immer einen negativen Wert.
    • Schließen Sie die Währung nicht mit ein.

    Optionale Felder

    Folgende Felder sind für Sales Data Batch Loads optional:

    Feld Typ Erforderlichkeit Beschreibung
    storeId string optional
    • Die Kennung des Geschäfts, die von Ihrem externen System kommt.
    • Muss für jedes Line Item einer bestimmten Transaktion gleich sein.
    salesChannel string optional
    • Der Sales-Kanal der Transaktion.
    • Muss für jedes Line Item einer bestimmten Transaktion gleich sein.