TB.One > Auftragsdaten und Auftragsabwicklung > Auftragsbearbeitung via XML > Senden und Abholen von Meldungen (Messages) via REST
Die REST-Schnittstelle wird über eine URI aufgerufen, die den Nutzer identifiziert und die gewünschte Aktion angibt:
https://rest.core.tradebyte.com/HNR/TARGET/[TARGET_ID][/ACTION]?[CHANNEL=CHID] |
|---|
MELDUNGEN ABSETZEN
Liefer-, Storno- und Retourenmeldungen werden von deinem System an TB.One übertragen.
Methode |
POST |
Erstellt ... |
|---|---|---|
Ziel/Ressource |
messages |
... Nachrichten ... |
Parameter |
File name |
... anhand einer XML-Datei (Inhalt der Nachrichten) |
Beispiel |
https://rest.core.tradebyte.com/HNR/messages/? |
|
Zu liefernde XML-Datei: <?xml version="1.0" encoding="utf-8"?> <MESSAGES_LIST> <MESSAGE> <MESSAGE_TYPE>SHIP</MESSAGE_TYPE> <TB_ORDER_ID>1</TB_ORDER_ID> <TB_ORDER_ITEM_ID>1</TB_ORDER_ITEM_ID> <SKU>4689bls</SKU> <CHANNEL_SIGN>ebde</CHANNEL_SIGN> <CHANNEL_ORDER_ID>303-6862327-6937118</CHANNEL_ORDER_ID> <CHANNEL_ORDER_ITEM_ID>1</CHANNEL_ORDER_ITEM_ID> <QUANTITY>1</QUANTITY> <CARRIER_PARCEL_TYPE>DHL_STD_NATIONAL</CARRIER_PARCEL_TYPE> <IDCODE>854051100989</IDCODE> <IDCODE_RETURN_PROPOSAL>854051100990</IDCODE_RETURN_PROPOSAL> </MESSAGE> </MESSAGES_LIST> |
||
Rückmeldung |
<?xml version="1.0" encoding="utf-8"?> <tradebyte> <state>message created successfully</state> </tradebyte> |
|
MELDUNGEN ABHOLEN
Du kannst Meldungen von TB.One abrufen, um sie zu überprüfen oder verifizieren.
Methode |
GET |
Holt ... |
|---|---|---|
Ziel/Ressource |
messages |
... Nachrichten ... |
Parameter |
ORDER_ID |
für den Auftrag mit der entsprechenden ID. |
MESSAGE_TYPE |
Holt nur Nachrichten des gewählten Typs (z.B. RETURN, SHIP). |
|
Beispiel |
https://rest.core.tradebyte.com/HNR/messages/? |
|
Rückmeldung |
<?xml version="1.0" encoding="UTF-8"?> <MESSAGES_LIST> <MESSAGE> <MESSAGE_ID>326</MESSAGE_ID> <MESSAGE_TYPE>SHIP</MESSAGE_TYPE> <TB_ORDER_ID>15</TB_ORDER_ID> <TB_ORDER_ITEM_ID>21</TB_ORDER_ITEM_ID> <SKU>4712-34r</SKU> <CHANNEL_SIGN>ZADE</CHANNEL_SIGN> <CHANNEL_ORDER_ID>303-6862327-6937155</CHANNEL_ORDER_ID> <CHANNEL_ORDER_ITEM_ID>4712-34r</CHANNEL_ORDER_ITEM_ID> <CHANNEL_SKU>568423</CHANNEL_SKU> <QUANTITY>1</QUANTITY> <CARRIER_PARCEL_TYPE>DHL_STD_NATIONAL</CARRIER_PARCEL_TYPE> <IDCODE>236548951236</IDCODE> <IDCODE_RETURN_PROPOSAL>236548951237</IDCODE_RETURN_PROPOSAL> <COMMENT>Testkommentar</COMMENT> <PROCESSED>0</PROCESSED> <EXPORTED>0</EXPORTED> <DATE_CREATED>2014-03-21T16:12:57</DATE_CREATED> </MESSAGE> <MESSAGE>...</MESSAGE> </MESSAGES_LIST> |
|
Weiterführende Informationen:
•Auftragsbearbeitung via REST - Übersicht und Statuscodes
•Auftragsbearbeitung via XML - Dateien und Namenskonventionen