Siirry pääsisältöön
GET
Hae yksittäinen lähetys sen viitetunnuksella. Vastaus tulee tietokannastamme, eikä se koskaan kutsu kuljetusyhtiötä. Taustasynkronointi päivittää jokaisen lähetyksen (10 minuutin välein GO!-lähetyksille, tunnin välein DHL-lähetyksille), ja synced_at kertoo, milloin kuljetusyhtiöltä kysyttiin viimeksi. Vaatii shipments_view- tai shipments_manage-käyttöoikeuden.

Pyyntö

Polkuparametrit

string
vaadittu
Lähetyksen viitetunnus (esim. P2611194821).

Vastaus

Onnistuessaan API palauttaa tilakoodin 200 OK ja lähetysobjektin.
string
vaadittu
Lähetyksen viitetunniste.
string
vaadittu
Lähetyksen elinkaaritila. Yksi arvoista pending, in_transit, delivered, fault tai cancelled.
string
vaadittu
Logistiikkapalveluntarjoaja. Yksi arvoista go, dhl_parcel, dhl_warenpost, rotrunner, rapido, ups tai dhl_express. Kotitestipaketin lähetys on dhl_parcel, tai dhl_warenpost, kun se lähetetään ulkomaille Warenpost International -lähetyksenä.
string
Logistiikkapalveluntarjoajan ulkoinen seurantanumero. Voi olla null.
string
Vapaamuotoinen kuvaus paketin sisällöstä sellaisena kuin se annettiin luonnin yhteydessä (esim. "Medizinisch freigestellte Probe", "Home test kit"). Vain tiedoksi – se, onko paketti menossa laboratorioon, luetaan kentästä destination, ja sen vastinpari kentästä paired_with. Voi olla null.
string
vaadittu
Kuka tulosti osoitekortin: aniva tai external. Vain aniva-lähetykset tukevat toimintoja Päivitä ja Peruuta; external-pakettia seurataan, mutta kumpikin palauttaa koodin 501.
string
Kaksipakettisen lähetyksen toisen paketin viite — paketti, jonka mukana palautusosoitekortti lähti, ja paketti, jonka kyseinen osoitekortti tuo takaisin. Asetettu molemmille. null yksisuuntaiselle paketille.
object
Nouto-osoite. Voi olla null.
object
Toimitusosoite. Sama rakenne kuin kentässä origin. Voi olla null.
object
Ajoitettu noutoaikaikkuna. Voi olla null.
string
Valinnaiset muistiinpanot. Voi olla null.
object[]
vaadittu
Logistiikkakumppanin elinkaaritapahtumat aikajärjestyksessä (vanhin ensin). Tyhjä taulukko, jos kumppani ei ole vielä ilmoittanut tapahtumia. Käytä tätä tapahtumakohtaiseen käyttöliittymään, auditointiin ja kuljetusyhtiön tarkempiin signaaleihin; luota varsinaisen nykytilan osalta kenttään status.
ShipmentAppointmentLink[]
vaadittu
Tähän lähetykseen linkitetyt ajanvaraukset, vanhin linkitys ensin. Jokainen merkintä on { id, added_at }; hae täydet ajanvaraustiedot kullekin id-arvolle kutsulla Hae ajanvaraus. Tyhjä taulukko, kun ajanvarauksia ei ole linkitetty. Vain pääsykontekstiisi kuuluvat ajanvaraukset listataan.
ShipmentHomeKitOrderLink[]
vaadittu
Tähän lähetykseen linkitetyt kotitestipakkausten tilaukset, vanhin linkitys ensin, samassa { id, added_at } -muodossa. Hae tiedot kullekin id-arvolle kutsulla Hae kotitestipakkauksen tilaus. Tyhjä taulukko vastaanottojen paketeille. Vain pääsykontekstiisi kuuluvat tilaukset listataan. Katso Pääsyoikeudet.
string
Ajankohta, jolloin lähetyksen tiedot viimeksi täsmäytettiin kuljetusyhtiön kanssa (UTC-aika). Lukukutsut eivät koskaan kutsu kuljetusyhtiötä — taustasynkronointi pitää lähetykset ajan tasalla — joten tämä kertoo, kuinka vanha vastaus on. null ensimmäiseen synkronointiin asti.
string
vaadittu
Luontiaikaleima (ISO 8601).
string
Viimeisimmän päivityksen aikaleima (ISO 8601). Voi olla null.

Toistuvat kutsut

Aniva tallentaa tämän päätepisteen vastauksen 60 minuutiksi kullekin API-avaimelle. Tämän ajan sisällä tehty toistuva kutsu saa tallennetun vastauksen, jos lähetys ei ole muuttunut. Muutoksen jälkeen saat tuoreen vastauksen. Otsikot Cache-Status ja Age kertovat, että vastaus on tallennettu ja kuinka vanha se on. Tallennetussa vastauksessa synced_at ja updated_at voivat olla vanhempia kuin tuoreessa vastauksessa. Jos haluat tiedon muutoksesta heti, tilaa webhook-tapahtumat shipment.created ja shipment.updated. Katso Toistuvat haut.

Virhevastaukset