Inhalt in diesem Artikel:
-
Versandstatusinformationen
- 1.1 Versand- vs. Paketeebene
- 1.2 Statuscodes
- 1.3 Änderungsrate -
Status-Feedback-Anfrage und -Antwort
- 2.1 Status-Feedback-Anfrage
- 2.2 Status-Feedback-Antwort
- 2.3 Antwortbeispiel
1. Versandstatusinformationen
Viele Frachtführer können Status-Feedback zu Ihren Sendungen übermitteln. Dieses Feedback wird in Transsmart verarbeitet und steht Ihrer Anwendung zur Abholung zur Verfügung. Die Informationen bestehen nicht nur aus dem aktuellen Status der Sendung, sondern können auch zusätzliche Angaben enthalten, zum Beispiel wer das Paket angenommen hat, den Zeitpunkt der Zustellung usw.
1.1 Versand- vs. Paketeebene
Statusinformationen sind sowohl auf Versand- als auch auf Paketeebene verfügbar. Wenn Sie eine Sendung mit mehreren Paketen haben, hat jedes Paket seinen eigenen eindeutigen Status. Eine Sendung mit 2 Paketen, von denen eines bereits zugestellt wurde, enthält beispielsweise diese Statusinformationen:
Sendung : TRNS
Paket 1 : DONE
Paket 2 : TRNS
1.2 Statuscodes
Transsmart verwendet eine vordefinierte Liste von Statuscodes. Das Feedback des Frachtführers enthält frachtführerspezifische Statuscodes. Diese werden den Transsmart-Statuscodes zugeordnet.
| Code | Description |
| NEW | Die Sendung wurde erstellt, aber noch nicht beim Frachtführer registriert. |
| BOOK | Die Sendung ist gebucht und beim Frachtführer registriert. |
| LABL | Das/die Etikett(e) der Sendung wurde(n) gedruckt. |
| MANI | Die Sendung ist beim Frachtführer registriert (nur bei Frachtführern mit Manifestierung). |
| ACCEP | Die Sendung wurde vom Frachtführer angenommen. |
| ERR/REFU | Die Sendung wurde nicht gebucht. Es ist ein Fehler aufgetreten. Sie erhalten eine Fehlermeldung. |
| TRNS | Die Sendung befindet sich beim Frachtführer im Transit. |
| DONE | Die Sendung ist zugestellt und vom Frachtführer bestätigt. |
| APOD | Automatischer Nachweis von Delivery. Dieser Status wird nach einem bestimmten Zeitraum an Sendungen vergeben, von denen wir keine Statusrückmeldung vom Frachtführer erhalten. |
| DEL | Die Sendung wird gelöscht. Falls erforderlich, wird Ihre Abholanforderung beim Frachtführer ebenfalls storniert. |
| UNKNOWN | Die Sendung hat einen Statuscode vom Frachtführer erhalten, den wir nicht erkannt haben. Dieser Code ist vorübergehend. |
| ONHOLD | Dieser Status wird entweder automatisch von Transsmart nach dem Drucken gemäß Konfiguration gesetzt o |
1.3 Änderungsrate
Jeder Carrier hat einen anderen Zeitplan für das Senden von Status-Feedback an Transsmart. Einige Carrier verwenden ein 15-minütiges Aktualisierungsintervall, andere senden nur zweimal täglich ein Update. Wir empfehlen, den aktuellen Status einer Sendung über Transsmart alle ein bis zwei Stunden abzurufen.
2 Status-Feedback-Anfrage und -Antwort
2.1 Status-Feedback-Anfrage
Die Status-Feedback-Anfrage muss done an: v2/statuses/
In diesem Aufruf gibt es mehrere Pflichtparameter. Diese werden in der Tabelle unten erläutert.
| Parameter | Description |
| account | Die accountID des account, für den Sie den Status erhalten möchten |
| reference | Die Referenz der Sendung, für die Sie ein Status-Update wünschen. |
| isDetailed | True (für eine detaillierte Statusübersicht einschließlich Carrier-Status) oder false (nur für den Transsmart-Status) |
| currentStatusOnly | True (nur der aktuelle Sendungsstatus) oder false (für die vollständige Statushistorie) |
2.2 Status-Feedback-Antwort
In der Statusantwort erhalten Sie zunächst einen Sendungsstatus basierend auf der Sendung AWB. Pro Sendungsposition erhalten Sie außerdem einen Status. Dies ist der Status des entsprechenden Pakets. Zusätzlich zum AWB- und Transsmart-Status des Pakets erhalten Sie auch Informationen über den Carrier-Status, den Carrier-Status description sowie das Datum/Uhrzeit der letzten Statusaktualisierung. Selbstverständlich wird der Carrier-Status nur angegeben, wenn er verfügbar ist und nachdem die Informationen an den Carrier übermittelt wurden.
2.3 Antwortbeispiel
Ein Beispiel für eine Antwort finden Sie in der technischen Dokumentation. Diese Antwort besteht aus einem Status pro Paket/ AWB in der Sendung.