Inhoud van dit artikel:
-
Informatie over de zendingstatus
- 1.1 Zending- versus pakketniveau
- 1.2 Statuscodes
- 1.3 Wijzigingsfrequentie -
Verzoek en antwoord voor statusfeedback
- 2.1 Statusfeedbackverzoek
- 2.2 Statusfeedbackantwoord
- 2.3 Voorbeeld van antwoord
1. Informatie over de zendingstatus
Veel vervoerders kunnen statusfeedback over uw zendingen versturen. Deze feedback wordt verwerkt in Transsmart en is beschikbaar zodat uw applicatie deze kan ophalen. De informatie bestaat niet alleen uit de daadwerkelijke status van de zending, maar kan ook extra gegevens bevatten, zoals wie het pakket heeft aangenomen, het tijdstip van aflevering, enz.
1.1 Zending- versus pakketniveau
Statussen zijn beschikbaar op zowel zending- als pakketniveau. Wanneer u een zending met meerdere pakketten hebt, krijgt elk pakket zijn eigen unieke status. Een zending met bijvoorbeeld 2 pakketten waarvan er één al is afgeleverd, bevat de volgende statusinformatie:
Shipment : TRNS
Package 1 : DONE
Package 2 : TRNS
1.2 Statuscodes
Transsmart gebruikt een vooraf gedefinieerde lijst met statuscodes. De feedback van de vervoerder bevat vervoerderspecifieke statuscodes. Deze worden gekoppeld aan de statuscodes van Transsmart.
| Code | Description |
| NEW | De zending is aangemaakt, maar nog niet geregistreerd bij de vervoerder. |
| BOOK | De zending is geboekt en geregistreerd bij de vervoerder. |
| LABL | Het label/de labels van de zending zijn afgedrukt. |
| MANI | De zending is geregistreerd bij de vervoerder (alleen bij vervoerders die een manifest gebruiken). |
| ACCEP | De zending is geaccepteerd door de vervoerder. |
| ERR/REFU | De zending is niet geboekt. Er is een fout opgetreden. U ontvangt een foutmelding. |
| TRNS | De zending is in vervoer bij de vervoerder. |
| DONE | De zending is afgeleverd en bevestigd door de vervoerder. |
| APOD | Automatic Proof of Delivery. Deze status wordt na een bepaalde periode toegekend aan zendingen waarvoor wij geen statusfeedback van de vervoerder ontvangen. |
| DEL | De zending is verwijderd. Indien nodig wordt uw ophaalverzoek bij de vervoerder ook geannuleerd. |
| UNKNOWN | De zending heeft een statuscode van de vervoerder gekregen die wij niet hebben herkend. Deze code is tijdelijk. |
| ONHOLD | Deze status wordt automatisch ingesteld door Transsmart na het afdrukken volgens de configuratie of handmatig ingesteld door de klant. |
1.3 Wijzigingsfrequentie
Elke vervoerder hanteert een ander schema voor het versturen van statusfeedback naar Transsmart. Sommige vervoerders gebruiken een update-interval van 15 minuten, andere sturen slechts twee keer per dag een update. We raden aan om de huidige status van een zending elke één à twee uur via Transsmart op te vragen.
2 Verzoek en antwoord voor statusfeedback
2.1 Verzoek om statusfeedback
Het verzoek om statusfeedback moet worden gedaan op: v2/statuses/
In deze call zijn verschillende parameters verplicht. Deze worden in de onderstaande tabel toegelicht.
| Parameter | Description |
| account | De accountID van de account waarvan je de status wilt ontvangen |
| reference | De referentie van de zending waarvoor je een statusupdate wilt. |
| isDetailed | True (voor een gedetailleerd statusoverzicht inclusief carrierstatussen) of false (alleen voor de Transsmart-status) |
| currentStatusOnly | True (alleen de huidige zendingsstatus) of false (voor de volledige statusgeschiedenis) |
2.2 Antwoord met statusfeedback
In de statusrespons ontvang je eerst een zendingsstatus op basis van de zending-AWB. Per zendingregel ontvang je ook een status. Dit is de status van het bijbehorende pakket. Naast de AWB van het pakket en de Transsmart-status ontvang je ook informatie over de carrierstatus, de carrierstatus-description en de datum/tijd waarop de status voor het laatst is bijgewerkt. De carrierstatus wordt uiteraard alleen weergegeven wanneer deze beschikbaar is en nadat de informatie is doorgestuurd naar de carrier.
2.3 Voorbeeld van response
Een voorbeeldresponse is te vinden in de technische documentatie. Deze response bestaat uit een status per pakket/AWB in de zending.