Sisältö tässä artikkelissa:
-
Lähetyksen tilatiedot
- 1.1 Lähetys- vs pakettitaso
- 1.2 Tunnuskoodit
- 1.3 Muutosnopeus -
Tilapaluupyynnöt ja -vastaukset
- 2.1 Tilapaluu-pyyntö
- 2.2 Tilapaluu-vastaus
- 2.3 Vastausesimerkki
1. Lähetyksen tilatiedot
Monet kuljetusliikkeet voivat lähettää tilapalautetta lähetyksistäsi. Tämä palaute käsitellään Transsmart-palvelussa, ja sovelluksesi voi noutaa sen. Tieto ei sisällä ainoastaan lähetyksen varsinaista tilaa, vaan siinä voi olla myös lisätietoja, kuten kuka on vastaanottanut lähetyksen, jättöajankohta jne.
1.1 Lähetys- vs pakettitaso
Tilat ovat saatavilla sekä lähetys- että pakettitasolla. Kun lähetyksellä on useita paketteja, jokaisella paketilla on oma yksilöllinen tilansa. Esimerkiksi lähetys, jossa on 2 pakettia ja joista toinen on jo toimitettu, sisältää seuraavat tilatiedot:
Shipment : TRNS
Package 1 : DONE
Package 2 : TRNS
1.2 Tunnuskoodit
Transsmart käyttää ennalta määriteltyä tilakoodilistaa. Kuljetusliikkeen palautteessa on toimittajakohtaisia tilakoodeja. Nämä muunnetaan Transsmart-tilakoodeiksi.
| Code | Description |
| NEW | Lähetys on luotu, mutta sitä ei ole vielä rekisteröity kuljetusyhtiölle. |
| BOOK | Lähetys on varattu ja rekisteröity kuljetusyhtiölle. |
| LABL | Lähetyksen osoitekortti/osoitekortit on tulostettu. |
| MANI | Lähetys on rekisteröity kuljetusyhtiölle (vain manifestointia käyttävillä kuljetusyhtiöillä). |
| ACCEP | Kuljetusyhtiö on vastaanottanut lähetyksen. |
| ERR/REFU | Lähetystä ei ole varattu. Tapahtui virhe. Saat virheilmoituksen. |
| TRNS | Lähetys on kuljetuksessa kuljetusyhtiöllä. |
| DONE | Lähetys on toimitettu ja kuljetusyhtiö on vahvistanut sen. |
| APOD | Automatic Proof of Delivery. Tämä tila annetaan tietyn ajan kuluttua lähetyksille, joista emme saa tilapäivitystä kuljetusyhtiöltä. |
| DEL | Lähetys on poistettu. Tarvittaessa myös noutopyyntö kuljetusyhtiölle perutaan. |
| UNKNOWN | Lähetys on saanut kuljetusyhtiöltä tilakoodin, jota emme tunnistaneet. Tämä koodi on väliaikainen. |
| ONHOLD | Tämä tila asetetaan joko automaattisesti Transsmart:n toimesta tulostuksen jälkeen asetusten mukaisesti o |
1.3 Muuta taajuutta
Jokaisella kuljetusliikkeellä on oma aikataulunsa tilapalautteen lähettämiseen Transsmart:lle. Osa kuljetusliikkeistä käyttää 15 minuutin päivitysväliä, kun taas toiset lähettävät päivityksen vain kahdesti päivässä. Suosittelemme hakemaan lähetyksen ajantasaisen tilan Transsmart:n kautta tunnin tai kahden välein.
2 Tilapalautepyynnöt ja -vastaukset
2.1 Tilapalautepyyntö
Tilapalautepyyntö on done osoitteeseen: v2/statuses/
Tässä kutsussa on useita pakollisia parametreja. Ne on selitetty alla olevassa taulukossa.
| Parameter | Description |
| account | account-tilin accountID, jolta haluat vastaanottaa tilatiedon |
| reference | Sen lähetyksen viite, jolle haluat tilapäivityksen. |
| isDetailed | True (yksityiskohtaista tilayhteenvetoa varten, mukaan lukien kuljetusliikkeen tilat) tai false (vain Transsmart-tilaa varten) |
| currentStatusOnly | True (vain lähetyksen nykyinen tila) tai false (koko tilahistorian saamiseksi) |
2.2 Tilapalautteeseen vastaaminen
Tilavastausssa saat ensin lähetyksen tilan perustuen lähetyksen AWB:een. Lähetyskohtaisesti rivitasolla saat myös tilan. Tämä on vastaavan paketin tila. Paketin AWB- ja Transsmart-tilan lisäksi saat myös tiedot kuljettajan tilasta, kuljettajan tilan description:sta sekä päivämäärän/ajan, jolloin tila on viimeksi päivitetty. Luonnollisesti kuljettajan tila annetaan vain, kun se on saatavilla ja sen jälkeen, kun tiedot on siirretty kuljettajalle.
2.3 Vastausesimerkki
Esimerkkivastaus löytyy teknisestä dokumentaatiosta. Tämä vastaus koostuu tilasta lähetyksen jokaista pakettia/ AWB:a kohti.