Indhold i denne artikel:
-
Information om forsendelsesstatus
- 1.1 Forsendelses- vs. pakkeliveau
- 1.2 Statuskoder
- 1.3 Ændringsfrekvens -
Anmodning og svar for statusfeedback
- 2.1 Anmodning om statusfeedback
- 2.2 Svar på statusfeedback
- 2.3 Svareksempel
1. Information om forsendelsesstatus
Mange transportører kan sende statusfeedback vedrørende dine forsendelser. Denne feedback behandles i Transsmart og er tilgængelig, så din applikation kan hente den. Informationen består ikke kun af den aktuelle status for forsendelsen, men kan også indeholde yderligere oplysninger som for eksempel hvem der modtog pakken, tidspunktet for afleveringen osv.
1.1 Forsendelses- vs. pakkeliveau
Statuser er tilgængelige både på forsendelses- og pakkeliveau. Når du har en forsendelse med flere pakker, vil hver pakke have sin egen unikke status. For eksempel vil en forsendelse med 2 pakker, hvoraf den ene allerede er leveret, indeholde denne statusinformation:
Forsendelse : TRNS
Pakke 1 : DONE
Pakke 2 : TRNS
1.2 Statuskoder
Transsmart bruger en foruddefineret liste over statuskoder. Feedbacken fra transportøren indeholder transportørspecifikke statuskoder. Disse bliver mappet til Transsmart-statuskoderne.
| Code | Description |
| NEW | Forsendelsen er oprettet, men endnu ikke registreret hos transportøren. |
| BOOK | Forsendelsen er booket og registreret hos transportøren. |
| LABL | Label/labels for forsendelsen er udskrevet. |
| MANI | Forsendelsen er registreret hos transportøren (kun med transportører, der bruger manifest). |
| ACCEP | Forsendelsen er accepteret af transportøren. |
| ERR/REFU | Forsendelsen er ikke blevet booket. Der er opstået en fejl. Du vil modtage en fejlmeddelelse. |
| TRNS | Forsendelsen er undervejs hos transportøren. |
| DONE | Forsendelsen er leveret og bekræftet af transportøren. |
| APOD | Automatic Proof of Delivery. Denne status gives efter en vis periode til forsendelser, hvorfra vi ikke modtager statusfeedback fra transportøren. |
| DEL | Forsendelsen er slettet. Om nødvendigt vil din afhentningsanmodning hos transportøren også blive annulleret. |
| UNKNOWN | Forsendelsen har modtaget en statuskode fra transportøren, som vi ikke kunne genkende. Denne kode er midlertidig. |
| ONHOLD | Denne status sættes enten automatisk af Transsmart efter udskrivning pr. konfiguration eller manuelt af kunden. |
1.3 Ændringsfrekvens
Hver transportør har en forskellig plan for at sende statusfeedback til Transsmart. Nogle transportører bruger et 15-minutters opdateringsinterval, andre sender kun en opdatering to gange om dagen. Vi anbefaler at hente den aktuelle status for en forsendelse via Transsmart hver eller hver anden time.
2 Anmodning og svar for statusfeedback
2.1 Anmodning om statusfeedback
Anmodningen om statusfeedback skal foretages på: v2/statuses/
Der er flere obligatoriske parametre i dette kald. De forklares i tabellen nedenfor.
| Parameter | Description |
| account | accountID’et på den account, som du ønsker at modtage status for. |
| reference | Referencen på den forsendelse, som du ønsker en statusopdatering for. |
| isDetailed | True (for en detaljeret statusoversigt inklusive transportørstatusser) eller false (kun for Transsmart-statussen). |
| currentStatusOnly | True (kun den aktuelle forsendelsesstatus) eller false (for komplet statushistorik). |
2.2 Svar på statusfeedback
I statusresponsen vil du først modtage en forsendelsesstatus baseret på forsendelsens AWB. For hver forsendelseslinje vil du også modtage en status. Dette er status for den tilsvarende pakke. Ud over pakkens AWB og Transsmart-status vil du også modtage information om fragtførerstatus, fragtførerstatus-description samt dato/tidspunktet, hvor statussen sidst blev opdateret. Fragtførerstatus vil naturligvis kun blive angivet, når den er tilgængelig, og efter informationen er overført til fragtføreren.
2.3 Svareksempel
Et eksempelsvar kan findes i den tekniske dokumentation. Dette svar består af en status pr. pakke/AWB i forsendelsen.