TB.One > Auftragsdaten und Auftragsabwicklung > Auftragsbearbeitung via CSV > Message Data Fields (CSV)

Message Data Fields (CSV)

Über die Schnittstelle kannst du entweder Aufträge in Gänze liefermelden (DESADV_ORD), oder individuell den Status jeder Auftragsposition (geliefert, storniert, retourniert) melden (DESADV_POS).
Felder mit grünem Hintergrund sind Systemfelder. Sie werden automatisch von TB.One erstellt und befüllt.

TIPP:
Die erste Zeile der CSV-Datei muss stets die Spaltenüberschriften enthalten.

Ein Beispiel für eine CSV-Meldungsdatei findest du hier.

1. MELDUNGEN AUF POSITIONSEBENE

Dateiname: DESADV_POS_{timestamp}.csv

FELD	PFILCHT	DATENTYP	BESCHREIBUNG
TB_ORDER_ID	Ja	INT	Auftrags-/Order-ID; eindeutige, von TB.One vergebene Auftragsnummer
ORDER_PAID	Nein	INT	Zahlstatus des Auftrags; mögliche Werte: 0 = nicht bezahlt 1 = bezahlt 2 = Zahlungsausfall Wird die Spalte nicht geliefert, geht TB.One von "0" aus
POS_TB_ID	Ja	INT	Über alle Aufträge hinweg eindeutige Nummer der Position
POS_ANR	Ja	CHAR(50)	Artikelnummer
SHIP_QUANTITY	Ja	INT	Liefermenge
DIFF_QUANTITY	Nein	INT	Stornierte Menge
TYPE	Nein	CHAR(20)	Meldungstyp; nur wenn DIFF_QUANTITY > 0 diff_stock = Storno (Lagerbestand) diff_customer = Storno (Kundenwunsch) Wird die Spalte nicht geliefert, geht TB.One von "diff_stock" aus
RETURN_QUANTITY	Nein	INT	Retourenmenge
RETURN_CAUSE	Nein	CHAR(50)	Importschlüssel des Retourengrundes
RETURN_STATE	Nein	CHAR(50)	Importschlüssel des Retourenzustandes
PARCEL_TYPE	Ja	CHAR(50)	Pakettyp des versendeten Artikels. Gib den in TB.One angelegten Import-Key des Pakettyps an. Historisch bedingt sind außerdem die unten aufgelisteten Werte möglich. TB.One wird versuchen, sie einem Import-Key zuzuordnen: DHL_STD = DHL-Standardpaket DHL_LAN = DHL-Langpaket SPED = Speditionsversand SONSTIGER = Sonstiger Verkehrsträger
SHIP_CODE	Nein	CHAR(30)	Versandnummer des Verkehrsträgers
IDCODE_RETURN_PROPOSAL	Nein	CHAR(30)	Vorgeschlagener Retourencode aus dem Nummernkreis
COMMENT_INTERN	Nein	CHAR	Interner Kommentar zum Auftrag. Falls bereits ein Auftragskommentar vorliegt, wird dieser überschrieben, wenn ein neuer Kommentar per CSV geliefert wird.
DEDUCT_SHIPPING	Nein	FLOAT	Versandkostenabschlag (=gutzuschreibender Betrag)
ACK_QUANTITY	Nein	INT	Auftragsbestätigung
EST_SHIP_DATE	Nein	DATE(yyyy-mm-dd)	Zusammen mit der Spalte "ACK_QUANTITY" kann hier der voraussichtliche Liefertermin gemeldet werden.
COMMENT	Nein	CHAR	Kommentar zur Meldung
MESSAGE_CHANNEL_DATA[key]	Nein	CHAR(50)	Kann, je nach Kanal, unterschiedlich genutzt werden. Stelle sicher, dass du den richtigen Key angibst. Lagerstandorte: Gib für jede Position deine ID für den entsprechenden Lagerstandort ein. Nutze den Key "logistic_center_id").

TIPP:
TB.One addiert die gemeldeten Mengen ("SHIP_QUANTITY", "DIFF_QUANTITY", "RETURN_QUANTITY"). Teillieferungen müssen deshalb (statt für jeden Status die gesamte Position zu melden) in separaten Zeilen übermittelt werden, die jeweils die zugehörige Menge angeben.

Beispiel:
Die Bestellmenge ("POS_QUANTITY") ist 10. Der Auftrag wird in zwei Paketen mit jeweils 5 Artikeln geliefert. In der CSV würden in diesem Fall zwei Zeilen, jeweils mit "SHIP_QUANTITY" = "5" angegeben.

Wenn keine Angaben für das Feld "PARCEL_TYPE" vorliegen, nimmt TB.One an, dass der Standardpakettyp verwendet wurde.
Wenn das Feld "SHIP_CODE" nicht Teil der CSV ist, übernimmt TB.One die Versandnummer aus den Auftragsdaten des Kanals.

TIPP:
Für das optionale Feld "DIFF_QUANTITY" kannst du in TB.One folgendes Verhalten aktivieren:

Falls für eine Position weniger als die bestellte Menge liefergemeldet wird, erstellt die Software automatisch eine Stornomeldung für die fehlende Menge.

Beispiel:

Die bestellte Menge ("POS_QUANTITY") ist "5". Die Versandmenge ("SHIP_QUANTITY") ist "3". Falls die entsprechende Option in TB.One aktiviert wurde, meldet die Software in diesem Fall automatisch eine Stornomenge von "2" an den Kanal.

Wenn mit der Meldung lediglich der Zahlstatus "bezahlt" gesetzt werden soll, dürfen die "QUANTITY"-Felder leer bleiben. Falls mehrere Meldungen für einen Auftrag erstellt werden, muss stets der aktuelle Zahlstatus mitgeliefert werden.

2. MELDUNGEN AUF AUFTRAGSEBENE

Falls du keine Möglichkeit hast, positionsbezogene Lieferrückmeldungen zu generieren, dann kannst du Aufträge in Gänze als geliefert melden. Im Falle einer DESADV_ORD-Meldung werden für alle noch offenen Positionen und Mengen eines Auftrags Liefermeldungen erzeugt.

Dateiname: DESADV_ORD_{timestamp}.csv

FELD	PFILCHT	DATENTYP	BESCHREIBUNG
TB_ORDER_ID	Ja	INT	Auftrags-/Order-ID; eindeutige, von TB.One vergebene Auftragsnummer.
ORDER_PAID	Ja	INT	Zahlstatus des Auftrags; mögliche Werte: 0 = nicht bezahlt 1 = bezahlt 2 = Zahlungsausfall Wird die Spalte nicht geliefert, geht TB.One von "0" aus.
TYPE	Ja	CHAR(20)	Meldungstyp ship = Auftrag versendet diff_stock = Storno (Lagerbestand) diff_customer = Storno (Kundenwunsch) Wird die Spalte nicht geliefert, geht TB.One von "ship" aus.
PARCEL_TYPE	Nein	CHAR(50)	Pakettyp des versendeten Artikels. Gib den in TB.One angelegten Import-Key des Pakettyps an. Historisch bedingt sind außerdem die unten aufgelisteten Werte möglich. TB.One wird versuchen, sie einem Import-Key zuzuordnen: DHL_STD = DHL-Standardpaket DHL_LAN = DHL-Langpaket SPED = Speditionsversand SONSTIGER = Sonstiger Verkehrsträger
SHIP_CODE	Nein	CHAR(30)	Versandnummer des Verkehrsträgers.
IDCODE_RETURN_PROPOSAL	Nein	CHAR(30)	Vorgeschlagener Retourencode aus dem Nummernkreis.
COMMENT_INTERN	Nein	CHAR	Interner Kommentar zum Auftrag. Falls bereits ein Auftragskommentar vorliegt, wird dieser überschrieben, wenn ein neuer Kommentar per CSV geliefert wird.
COMMENT	Nein	CHAR	Kommentar zur Meldung.

Weiterführende Informationen:

•Auftragsbearbeitung und Meldungen via CSV - Übersicht

•Dateien und Namenskonventionen zur Bereitstellung von Stammdaten via CSV

•Feldbeschreibungen Auftragsdaten (CSV)