TradebyteAddOrders

Mit dem Step TradebyteAddOrders können Aufträge im Tradebyte angelegt werden.

Vorbereitung

Um Aufträge im Tradebyte anlegen zu können, müssen vorher 2 Datastores angelegt werden. Für die Kopfdaten muss ein Master-Datastore mit dem Schema TradebyteAddOrdersOrderHeadPayloadProvider und ein mit dem Master verknüpfterChild-Datastore mit dem Schema TradebyteAddOrdersOrderItemsPayloadProvider angelegt werden. Neue Aufträge müssen im updateProcessingStatus UNPROCESSED vorliegen. Nach erfolgreicher Bearbeitung wird der Status auf PROCESSED_SUCCESS geändert. Fehlerhafte Aufträge werden in den Status PROCESSED_ERROR gesetzt.

Die Kopf- und Positionsdaten werden in die entsprechenden Datastores geschrieben und mittels master_identifier miteinander verknüpft.

Kopfdaten

Diese Daten werden in den Master-Datastore im Status UNPROCESSED geschrieben.

Pflichtfelder des Kopf-Datastores

(zur internen Zuordnung, werden nicht an Tradebyte übertragen)

NameBeispielBeschreibungPflichtfeldDatentypWerteHinweise
identifier55Eindeutiger Bezeichner des Auftrags (in der Regel die eindeutige Auftragsnummer)jaText



master_identifier55Eindeutiger Bezeichner des Auftrags (in der Regel ebenfalls die eindeutige Auftragsnummer)jaText


Dient der Zuordnung von Kopf- und Positionsdaten

Kanal- und Auftragsspezifische Informationen

NameBeispielBeschreibungPflichtfeldDatentypWerteHinweise
ORDER_DATE2020-11-30Datum der Kundenbestellung, falls diese vom Kanal übermittelt wird. Andernfalls wird von TB.One das Datum Imports eingetragenjaText

YYYY-MM-DD


CHANNEL_ID303-6862327Eindeutige Auftragsnummer des VertriebskanalsjaText



CHANNEL_SIGNotdeKanalkennzeichenneinText

CHANNEL_NO303-6862327Auftragsnummer des Vertriebskanals (muss nicht eindeutig sein, z.B. Auftragsnummer eines Webshops). Je nach Vertriebskanal können CHANNEL_ID und CHANNEL_NO auch den gleichen Wert enthalten.neinText

APPROVED1Freigabekennzeichen des AuftragsjaGanzzahl1 (bestätigter Auftrag)
0 (schwebend)

CUSTOMER_COMMENTKundenbemerkungKundenbemerkung zum Auftrag. Falls in Ihrem Shop diese Option angeboten wird, können Sie hier den Kundenkommentar an den Händler weiterleiten.neinText

ITEM_COUNT1Anzahl der Bestellpositionen. Wird gegen die im Auftrag übergebenen Positionen geprüft. Bei Abweichungen wird der Auftrag zur Sicherheit abgelehnt.jaGanzzahl

TOTAL_ITEM_AMOUNT120.00Gesamtsumme der Auftragspositionen Brutto (ohne Versand- und andere Zusatzkosten). Wird gegen die einzelnen übergebenen Werte geprüft. Bei Abweichungen wird der Auftrag zur Sicherheit abgelehnt.jaDezimalzahl

Rechnungsadresse

Daten der Rechnungsanschrift

NameBeispielBeschreibungPflichtfeldDatentypWerteHinweise
SELL_TO_CHANNEL_NO5607865Nummer des Kunden beim jeweiligen VertriebskanalneinText

SELL_TO_TITLEHerr   Anrede oder Titel                                                           nein

Text

zB. Herr / Frau
SELL_TO_FIRSTNAMEMaxVorname des KundenjaText
Wenn SELL_TO_FIRSTNAME und SELL_TO_LASTNAME angegeben werden, sollte SELL_TO_NAME leer bleiben.

SELL_TO_LASTNAMEMustermannNachname des KundenjaText

SELL_TO_NAME

Max Mustermann

Wenn die Namensinformationen nicht getrennt nach Vor- und Nach name erfasst wird, können Sie auch den zusammengesetzten Namen des Kunden übergeben (getrennt durch ein Leerzeichen). TB.One versucht, den Namen aufzuschlüsseln.

nein 

Text

Vorname Nachname

Wenn SELL_TO_NAME angegeben wird, sollten SELL_TO_FIRSTNAME und SELL_TO_LASTNAME leer bleiben.
SELL_TO_NAME_EXTENSIONProf.NamenszusatzneinTextzB. akademischer Titel
SELL_TO_STREET_NOTeststraße 5Straße und HausnummerjaText

SELL_TO_STREET_EXTENSIONc/o Martin MustermannAdresszusatzneinTextzB. c/o (care of - wohnhaft bei) 
SELL_TO_ZIP12345PostleitzahljaText

SELL_TO_CITYTeststadtStadtjaText

SELL_TO_COUNTRYDELändercode ALPHA 2jaText

SELL_TO_PHONE_PRIVATE123456Private TelefonnummerneinText

SELL_TO_PHONE_OFFICE123456Geschäftliche TelefonnummerneinText

SELL_TO_PHONE_MOBILE123456MobilnummerneinText

SELL_TO_EMAILx@y.deE-Mail-AdresseneinText

SELL_TO_BIRTHDAY1980-01-01Geburtsdatum des KundenneinTextYYYY-MM-DD
SELL_TO_VAT_IDDE999999999UmsatzsteueridentifikationsnummerneinText

Versandadresse

Daten der Versandadresse (nur anzugeben wenn Rechnungs- und Lieferanschrift abweichen)

NameBeispielBeschreibungPflichtfeldDatentypWerteHinweise
SHIP_TO_CHANNEL_NO5607865Nummer des Kunden beim jeweiligen VertriebskanalneinText

SHIP_TO_TITLEHerr   Anrede oder Titel                                                           nein

Text

zB. Herr / Frau
SHIP_TO_FIRSTNAMEMaxVorname des KundenjaText
Wenn SHIP_TO_FIRSTNAME und SHIP_TO_LASTNAME angegeben werden, sollte SHIP_TO_NAME leer bleiben.

SHIP_TO_LASTNAMEMustermannNachname des KundenjaText
SHIP_TO_NAME

Max Mustermann

Wenn die Namensinformationen nicht getrennt nach Vor- und Nach name erfasst wird, können Sie auch den zusammengesetzten Namen des Kunden übergeben (getrennt durch ein Leerzeichen). TB.One versucht, den Namen aufzuschlüsseln.

nein 

Text

Vorname Nachname

Wenn SHIP_TO_NAME angegeben wird, sollten SHIP_TO_FIRSTNAME und SHIP_TO_LASTNAME leer bleiben.
SHIP_TO_NAME_EXTENSIONProf.NamenszusatzneinTextzB. akademischer Titel
SHIP_TO_STREET_NOTeststraße 5Straße und HausnummerjaText

SHIP_TO_STREET_EXTENSIONc/o Martin MustermannAdresszusatzneinTextzB. c/o (care of - wohnhaft bei) 
SHIP_TO_ZIP12345PostleitzahljaText

SHIP_TO_CITYTeststadtStadtjaText

SHIP_TO_COUNTRYDELändercode ALPHA 2jaText

SHIP_TO_PHONE_PRIVATE123456Private TelefonnummerneinText

SHIP_TO_PHONE_OFFICE123456Geschäftliche TelefonnummerneinText

SHIP_TO_PHONE_MOBILE123456MobilnummerneinText

SHIP_TO_EMAILx@y.deE-Mail-AdresseneinText

SHIP_TO_BIRTHDAY1980-01-01Geburtsdatum des KundenneinTextYYYY-MM-DD
SHIP_TO_VAT_IDDE999999999UmsatzsteueridentifikationsnummerneinText

Versandinformationen

Die Versandinformationen sind optional.

NameBeispielBeschreibungPflichtfeldDatentypWerteHinweise
SHIPMENT_CARRIER_PARCEL_TYPEDHL_STANDARTAngabe des Pakettyps.neinText
Die Pakettypen müssen vorher mit Tradebyte abgesprochen werden.
SHIPMENT_IDCODE_SHIP1234567890 DHL-SendungsnummernneinText

SHIPMENT_IDCODE_RETURN1234567899DHL-Sendungsnummern der RetoureneinText

SHIPMENT_ROUTING_CODE2134807501640Leitcode (DHL) der KundenadresseneinText

SHIPMENT_PRICE3.95VersandkostenneinText

SHIPMENT_IS_EXPRESS1Expressversand-KennzeichenneinText1 (Expressversand)
0 (Normalversand)

Zahlinformationen

Die Zahlinformationen sind optional.

NameBeispielBeschreibungPflichtfeldDatentypWerteHinweise
PAYMENT_TYPE
ZahlartneinText
Abhängig vom Vertriebskanal
PAYMENT_COSTS10.99ZahlkostenneinDezimalzahl

PAYMENT_PAYMENT_TRANSACTION_ID1AB23456C7890123DTransaktionsnummer der ZahlungneinTextz.B. Freigabecode zum Anstoß der Zahlung
PAYMENT_PAYMENT_TRANSACTION_NR1AB23456C7890123DZusätzliches Kennzeichen zur Identifizierung der ZahlungneinTextz.B: PayPal Kundennummer
PAYMENT_PAYMENT_TRANSACTION_NAMEMartin MustermannEvtl. abweichender Kundenname für ZahlungneinText

PAYMENT_PAYMENT_DATA
Zusätzliche Informationen zur ZahlungneinText

PAYMENT_DIRECTDEBIT_ACCOUNTNAMEMax MustermannName des KontoinhabersneinText

PAYMENT_DIRECTDEBIT_ACCOUNTNR0648489890KontonummerneinText

PAYMENT_BANKNAMEMusterbankName der BankneinText

PAYMENT_BANKCODE50010517BankleitzahlneinText

PAYMENT_IBANDE12500105170648489890IBANneinText

PAYMENT_BICBELADEBEBICneinText

Fehlerauswertung

Falls ein Auftrag nicht angelegt werden kann wird in die entsprechende Zeile im Feld ORDER_RESPONSE_ERROR_MESSAGE die von Tradebyte ausgegebene Fehlermeldung gespeichert.

Bei erfolgreicher Auftragsanlage wird die vergebene interne ID des Auftrages in der Spalte ORDER_RESPONSE_TB_ID abgelegt.

NameBeispielBeschreibungPflichtfeldDatentypWerteHinweise
ORDER_RESPONSE_TB_ID
Interne Tradebyte OrderID des neu angelegten Auftrags

Diese Felder müssen leer bleiben.Werden bei der Auftragsanlage befüllt.
ORDER_RESPONSE_ERROR_MESSAGE
Fehlermeldung im Fall eines abgelehnten Auftrags

Positionsdaten

Diese Daten werden in den Child-Datastore geschrieben. Der Status ist in diesem Fall irrelevant.

Pflichtfelder des Positions-Datastores

(zur internen Zuordnung, werden nicht an Tradebyte übertragen)

NameBeispielBeschreibungPflichtfeldDatentypWerteHinweise
identifier55_123123Eindeutiger Bezeichner des Auftragsposition (in der Regel die Kombination von Auftragsnummer und Artikelnummer)jaTextAuftragsnummer_Artikelnummer
master_identifier55Eindeutiger Bezeichner des Auftrags (in der Regel die eindeutige Auftragsnummer)jaText

Dient der Zuordnung von Kopf- und Positionsdaten

Positions-Informationen

NameBeispielBeschreibungPflichtfeldDatentypWerteHinweise
ITEM_CHANNEL_ID1Positionsnummer des VertriebskanalsjaText

ITEM_SKU4060029565719Artikelnummer aus TB.One.jaText


ITEM_CHANNEL_SKU00257241717043externe Artikelnummer des Custom-KanalsneinText

ITEM_EAN4060989565719EANneinText

ITEM_QUANTITY2BestellmengejaGanzzahl

ITEM_BILLING_TEXTLongshirt (40, Blau)Rechnungstext der AuftragspositionneinText

ITEM_TRANSFER_PRICE
Artikelpreis netto (optional)neinDezimalzahl

ITEM_ITEM_PRICE60.00Verkaufspreis BruttojaDezimalzahl

ITEM_DELIVERY_TIME5Lieferzeit in WerktagenneinGanzzahl

ITEM_SERVICES
Positionsbezogene ServicesneinTextz.B. GeschenkverpackungIn Abspreche mit Tradebyte