Sie können Sendungen in Transsmart vorbereiten. Der Hauptunterschied zum Buchen besteht darin, dass für eine vorbereitete Sendung weniger Validierungen durchgeführt werden. Wenn Sie zum Beispiel bei einem Carrier buchen, sind der Carrier-Code und das Service-Level Pflichtfelder, für eine vorbereitete Sendung sind diese Felder jedoch noch nicht erforderlich. Das bedeutet, dass Sie eine Sendung zunächst vorbereiten und sie später mit allen benötigten Informationen vervollständigen können, bevor Sie sie buchen – oder Sie buchen und drucken die Sendung direkt.
The call to create a prepared shipment in Transsmart:
POST request to /v2/shipments/{{account}}/CREATE to prepare a shipment (status NONE)
Weitere Informationen: https://devdocs.transsmart.com/#_2_1_shipment_booking
Der Request-Body sollte mindestens eine Sendungsreferenz enthalten. Damit eine Buchung korrekt abgeschlossen werden kann, müssen Sie außerdem zusätzliche Details angeben, zum Beispiel die Absenderadresse, die Empfängeradresse, Paketinformationen sowie Versanddetails wie Carrier-Code, Service-Level und Abholdatum.
[{
"reference": "{{reference}}"
}]
Sie können diesen CREATE-Call für dieselbe Shipment-Referenz so oft senden, wie Sie ihn benötigen. Beachten Sie dabei jedoch ein wichtiges Detail: Wenn wir die Shipment-Erstellung verarbeiten und eine bestehende Shipment mit derselben Referenz finden, löschen wir zuerst die alte Shipment und erstellen anschließend eine neue anhand der von Ihnen gesendeten Daten. Wenn Sie also nicht alle Felder angeben, die bereits Teil der Shipment in unserem System waren, werden diese fehlenden Felder geleert.
Wenn Ihnen nicht alle Felder zur Verfügung stehen, die zuvor im Ablauf von einer Anwendung gesendet wurden, ist es wichtig, dass Sie zuerst einen GET-Shipment-Call ausführen, um alle Felder der vorbereiteten Shipment abzurufen, diese (temporär/im Speicher) zu speichern und anschließend den vollständigen Shipment-Body mit dem CREATE-Call zu senden.
Der Call, um alle Felder einer vorbereiteten Shipment abzurufen:
GET request to /v2/shipments/{{account}}/{{reference}}
Weitere Informationen: https://devdocs.transsmart.com/#_single_shipment_retrieval
Sie können diesen Call weiterhin jedes Mal ausführen, bevor Sie einen neuen CREATE-Call senden. Sobald die vorbereitete Shipment fertig ist, können Sie sie buchen oder buchen und drucken, indem Sie einen der folgenden Calls verwenden:
POST request to /v2/shipments/{{account}}/BOOK to book a shipment (status NEW or BOOK)
or
POST request to /v2/shipments/{{account}}/PRINT to book a shipment and directly print a label (status LABL)
Dieselben Informationen wie beim CREATE-Aufruf, jedoch mit der Aktion BOOK oder PRINT:
https://devdocs.transsmart.com/#_action_parameter
Important reminder! In unserem Prozess zur Erstellung und Buchung von Sendungen löschen wir eine bestehende Sendung, wenn wir eine vorhandene Sendungsreferenz erkennen, und legen anschließend eine neue Sendung mit den von Ihnen bereitgestellten aktualisierten Informationen an. Das bedeutet: Wenn Sie nicht alle Felder mitsenden, die zuvor Teil der Sendung in unserem System waren, werden diese Felder geleert.