Innehåll i den här artikeln:
-
Information om försändelsestatus
- 1.1 Försändelse- vs paketnivå
- 1.2 Statuskoder
- 1.3 Förändringsfrekvens -
Statusfeedback-begäran och svar
- 2.1 Statusfeedback-begäran
- 2.2 Statusfeedback-svar
- 2.3 Svarsexempel
1. Information om försändelsestatus
Många transportörer kan skicka statusfeedback om dina försändelser. Den här feedbacken behandlas i Transsmart och finns tillgänglig för din applikation att hämta. Informationen består inte bara av den faktiska statusen för försändelsen utan kan även innehålla ytterligare information som vem som tog emot paketet, tidpunkten för leveransen osv.
1.1 Försändelse- vs paketnivå
Statusar är tillgängliga både på försändelse- och paketnivå. När du har en försändelse med flera paket kommer varje paket att ha sin egen unika status. Till exempel kommer en försändelse med 2 paket där ett redan har levererats att innehålla denna statusinformation:
Försändelse : TRNS
Paket 1 : DONE
Paket 2 : TRNS
1.2 Statuskoder
Transsmart använder en fördefinierad lista med statuskoder. Feedbacken från transportören innehåller transportörsspecifika statuskoder. Dessa mappas till Transsmart-statuskoderna.
| Code | Description |
| NEW | Försändelsen är skapad, men ännu inte registrerad hos transportören. |
| BOOK | Försändelsen är bokad och registrerad hos transportören. |
| LABL | Etiketten/etiketterna för försändelsen är utskrivna. |
| MANI | Försändelsen är registrerad hos transportören (endast med transportörer som använder manifest). |
| ACCEP | Försändelsen är accepterad av transportören. |
| ERR/REFU | Försändelsen har inte bokats. Ett fel har uppstått. Du kommer att få ett felmeddelande. |
| TRNS | Försändelsen är under transport hos transportören. |
| DONE | Försändelsen är levererad och bekräftad av transportören. |
| APOD | Automatic Proof of Delivery. Denna status ges efter en viss tid till försändelser för vilka vi inte får någon statusåterkoppling från transportören. |
| DEL | Försändelsen är borttagen. Vid behov kommer även din upphämtningsbegäran hos transportören att avbrytas. |
| UNKNOWN | Försändelsen har fått en statuskod från transportören som vi inte kände igen. Denna kod är tillfällig. |
| ONHOLD | Denna status ställs antingen in automatiskt av Transsmart efter utskrift enligt konfiguration o |
1.3 Ändringsfrekvens
Varje transportör har ett eget schema för att skicka statusåterkoppling till Transsmart. Vissa transportörer använder ett uppdateringsintervall på 15 minuter, andra skickar en uppdatering endast två gånger per dag. Vi rekommenderar att hämta den aktuella statusen för en försändelse via Transsmart varje eller varannan timme.
2 Begäran och svar för statusåterkoppling
2.1 Begäran om statusåterkoppling
Begäran om statusåterkoppling måste vara done på: v2/statuses/
Det finns flera obligatoriska parametrar i detta anrop. De förklaras i tabellen nedan.
| Parameter | Description |
| account | accountID för account som du vill ta emot status för |
| reference | Referensen för den försändelse som du vill ha en statusuppdatering för. |
| isDetailed | True (för en detaljerad statusöversikt inklusive transportörsstatusar) eller false (endast Transsmart-statusen) |
| currentStatusOnly | True (endast den aktuella försändelsestatusen) eller false (för komplett statushistorik) |
2.2 Svar på statusåterkoppling
I statusresponsen får du först en försändelsestatus baserad på försändelsens AWB. Per försändelserad får du också en status. Detta är statusen för det motsvarande paketet. Utöver paketets AWB och Transsmart-status får du även information om transportörsstatus, transportörsstatus description och datum/tid då statusen senast uppdaterades. Självklart lämnas transportörsstatus endast när den är tillgänglig och efter att informationen har överförts till transportören.
2.3 Exempel på respons
Ett exempel på respons finns i den tekniska dokumentationen. Denna respons består av en status per paket/ AWB i försändelsen.