Innhold i denne artikkelen:
-
Informasjon om forsendelsesstatus
- 1.1 Forsendelsesnivå vs pakkenivå
- 1.2 Statuskoder
- 1.3 Endringsfrekvens -
Forespørsel og respons for statusfeedback
- 2.1 Forespørsel om statusfeedback
- 2.2 Respons på statusfeedback
- 2.3 Respons-eksempel
1. Informasjon om forsendelsesstatus
Mange transportører kan sende statusfeedback for forsendelsene dine. Denne feedbacken behandles i Transsmart og er tilgjengelig for at applikasjonen din kan hente den. Informasjonen består ikke bare av den faktiske statusen til forsendelsen, men kan også inneholde tilleggsinformasjon som hvem som tok imot pakken, tidspunktet for levering, osv.
1.1 Forsendelsesnivå vs pakkenivå
Statuser er tilgjengelige både på forsendelses- og pakkenivå. Når du har en forsendelse med flere pakker, vil hver pakke ha sin egen unike status. For eksempel vil en forsendelse med 2 pakker, der én allerede er levert, inneholde denne statusinformasjonen:
Shipment : TRNS
Package 1 : DONE
Package 2 : TRNS
1.2 Statuskoder
Transsmart bruker en forhåndsdefinert liste med statuskoder. Feedbacken fra transportøren inneholder transportørspesifikke statuskoder. Disse blir samsvart med Transsmart-statuskodene.
| Code | Description |
| NEW | Forsendelsen er opprettet, men ennå ikke registrert hos transportøren. |
| BOOK | Forsendelsen er booket og registrert hos transportøren. |
| LABL | Etiketten/etikettene for forsendelsen er skrevet ut |
| MANI | Forsendelsen er registrert hos transportøren (kun med transportører som bruker manifest). |
| ACCEP | Forsendelsen er akseptert av transportøren. |
| ERR/REFU | Forsendelsen er ikke booket. Det har oppstått en feil. Du vil motta en feilmelding. |
| TRNS | Forsendelsen er underveis hos transportøren. |
| DONE | Forsendelsen er levert og bekreftet av transportøren. |
| APOD | Automatic Proof of Delivery. Denne statusen gis etter en viss periode til forsendelser der vi ikke mottar statusoppdatering fra transportøren. |
| DEL | Forsendelsen er slettet. Ved behov vil også henteforespørselen din hos transportøren bli kansellert. |
| UNKNOWN | Forsendelsen har mottatt en statuskode fra transportøren som vi ikke gjenkjente. Denne koden er midlertidig. |
| ONHOLD | Denne statusen settes enten automatisk av Transsmart etter utskrift i henhold til konfigurasjon o |
1.3 Endre frekvens
Hver transportør har en forskjellig plan for å sende statusfeedback til Transsmart. Noen transportører bruker et 15-minutters oppdateringsintervall, andre sender bare en oppdatering to ganger per dag. Vi anbefaler å hente gjeldende status for en forsendelse via Transsmart hver time eller annenhver time.
2 Forespørsel og respons for statusfeedback
2.1 Forespørsel om statusfeedback
Forespørselen om statusfeedback må være done på: v2/statuses/
Det er flere obligatoriske parametere i dette kallet. De blir forklart i tabellen nedenfor.
| Parameter | Description |
| account | AccountID-en til account som du ønsker å motta statusen for |
| reference | Referansen til forsendelsen du ønsker en statusoppdatering for. |
| isDetailed | True (for en detaljert statusoversikt inkludert transportørstatuser) eller false (for kun Transsmart-statusen) |
| currentStatusOnly | True (kun gjeldende forsendelsesstatus) eller false (for komplett statushistorikk) |
2.2 Respons for statusfeedback
I statusresponsen vil du først motta en forsendelsesstatus basert på forsendelsens AWB. Per forsendelseslinje vil du også motta en status. Dette er statusen til den tilsvarende pakken. I tillegg til pakkens AWB og Transsmart-status vil du også motta informasjon om transportørstatus, transportørstatus description, og dato/klokkeslett da statusen sist ble oppdatert. Transportørstatus vil selvfølgelig bare bli oppgitt når den er tilgjengelig og etter at informasjonen er overført til transportøren.
2.3 Responseksempel
Et eksempel på en respons finnes i den tekniske dokumentasjonen. Denne responsen består av en status per pakke/ AWB i forsendelsen.