Die CSV-Datei muss sich an diesem Schema orientieren, damit der Upload funktioniert. Weiter unten in diesem Artikel findet Ihr auch nochmal eine Beschreibung der wichtigsten Felder inklusive Beispielen auf Deutsch.
Beachtet bitte folgende Punkte bei der Erstellung der CSV-Datei:
- Es dürfen keine Leerzeilen enthalten sein, auch nicht am Ende.
- Es dürfen keine leeren Spalten vorhanden sein.
- Die Datei muss UTF-8 kodiert sein.
- Es dürfen keine Semikolon am Ende einer Zeile stehen.
- Nutzt zur Fehlersuche gegebenenfalls auch einen Texteditor, indem Ihr die Datei in einem solchen Programm öffnet. Programme wie Microsoft Excel zeigen die oben genannten Fehler oftmals nicht an.
Feldbeschreibung und Beispiele
Eine Zeile in der CSV-Datei repräsentiert immer eine einzelne Bestellposition.
Alle Feldnamen, die fett gedruckt sind, sind verpflichtend, müssen also in der Datei in jedem Fall angegeben werden. Bei den Feldern paymentDate und sentDate hängt es vom Typ der Transaktion ab, ob diese anzugeben sind (siehe Beschreibung).
Ob auch ein Inhalt für ein Feld angegeben werden muss, könnt Ihr der Spalte "Beispiel" entnehmen. Ist der Wert hier fettgedruckt, muss ein Wert des in "Beschreibung / Mögliche Werte" angegebenen Formats eingegeben werden. Ist der Wert nicht fett gedruckt, darf auch ein leerer Inhalt übergeben werden.
Feldname | Beispiel | Beschreibung / Mögliche Werte |
type | Sale | Die Art der Transaktion (Sale, Refund) |
channelIdentifier | WEB | Abkürzung für die Verkaufsplattform (2-8 Buchstaben); bei einer Transaktion vom Typ "Refund" ist hier der Wert der gutgeschriebenen Bestellposition anzugeben;
stellt sicher, dass für Transaktionen, die über einen Marktplatz abgewickelt wurden, der korrekte identifier angegeben wird (die Werte findet Ihr hier) |
channelTransactionNumber | AN57398 | Die Transaktionsnummer, in der Regel die Bestellnummer (1-100 Zeichen); bei einer Transaktion vom Typ "Refund" ist hier der Wert der gutgeschriebenen Bestellposition anzugeben |
channelItemNumber | 1 | Eindeutige Nummer für die Position in einer Bestellung; anzugeben, wenn es mehrere Positionen gibt (0-100 Zeichen, Standard 0); bei einer Transaktion vom Typ "Refund" ist hier der Wert der gutgeschriebenen Bestellposition anzugeben |
paymentDate |
2023-03-21T12:00:00+02:00 (+02:00 steht für die Zeitzone, hier UTC+2; die angegebenen Daten werden in UTC umgerechnet) |
Zahlungsdatum im Format YYYY-MM-DDTHH:MM:SSZ; verpflichtend für Transaktionen vom Typ "Refund"; für Transaktionen vom Typ "Sale" muss entweder ein paymentDate oder ein sentDate angegeben werden |
sentDate |
2023-03-21T12:00:00+02:00 (+02:00 steht für die Zeitzone, hier UTC+2; die angegebenen Daten werden in UTC umgerechnet) |
Versanddatum im Format YYYY-MM-DDTHH:MM:SSZ; ignoriert für Transaktionen vom Typ "Refund"; für Transaktionen vom Typ "Sale" muss entweder ein paymentDate oder ein sentDate angegeben werden |
deliveryFullName | Max Mustermann | Name (Empfänger) |
deliveryStreet1 | Musterstraße 1 | Straße (Empfänger) |
deliveryZip |
1010 | Postleitzahl (Empfänger) |
deliveryCity | Wien | Stadt (Empfänger) |
deliveryState | Wien | Bundesland oder Äquivalent (Empfänger) |
deliveryCountry | AT | Land (Empfänger) (ISO-3166 ALPHA-2) |
senderZip | 20355 | Postleitzahl (Absender) |
senderCity | Hamburg | Stadt (Absender) |
senderState | Hamburg | Bundesland oder Äquivalent (Absender) |
senderCountry | DE | Land (Absender) (ISO-3166) |
buyerVatNumber | DE123456789 | Die Umsatzsteuer-ID des Käufers (anzugeben bei B2B Bestellungen) |
quantity | 3 | Die Menge der in der Bestellposition enthaltenen Artikel (Ganzzahl) |
productIdentifier | T456 | Die Artikelnummer (SKU) |
description | T-Shirt (rot), Größe M | Die Beschreibung des Artikels |
transactionCurrency | EUR | Währung (ISO-4217) |
itemPrice | 10,99 |
Der Gesamtwert der Bestellposition; Brutto; Dezimalzahl > 0 für Transaktionen vom Typ "Sale", Dezimalzahl < 0 für Transaktionen vom Typ "Refund"; Wichtig: dieser Wert wird nicht mit dem für quantity angegebenen Wert multipliziert |
itemDiscount | -1,99 |
Der anteilige Rabatt der Bestellposition; Brutto; Dezimalzahl <= 0 für Transaktionen vom Typ "Sale", Dezimalzahl >= 0 für Transaktionen vom Typ "Refund" Wichtig: dieser Wert wird nicht mit dem für quantity angegebenen Wert multipliziert |
shipping | 4,99 |
Die anteiligen Versandkosten der Bestellposition; Brutto; Dezimalzahl >= 0 für Transaktionen vom Typ "Sale", Dezimalzahl <= 0 für Transaktionen vom Typ "Refund" Wichtig: dieser Wert wird nicht mit dem für quantity angegebenen Wert multipliziert |
invoiceNumber | RE854723 | Die Belegnummer der Bestellung / der Gutschrift |
invoiceDate |
2023-03-21T12:00:00+02:00 (+02:00 steht für die Zeitzone, hier UTC+2; die angegebenen Daten werden in UTC umgerechnet) |
Das Rechnungsdatum im Format YYYY-MM-DDTHH:MM:SSZ |
Beispieldateien
Im Anhang (am Ende dieses Artikels) findet Ihr zwei Beispieldateien, von denen eine alle in der obenstehenden Tabelle aufgeführten Felder und die andere alle verfügbaren Felder enthält. Die erste Datei sollte für die meisten Transaktionen ausreichen.
Antworten auf die häufigsten Fragen findet Ihr auch in unserem FAQ Artikel zum manuellen Transaktionsupload.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.