Naar hoofdinhoud gaan
GET
Haal een enkele zending op aan de hand van de referentie-ID. Het antwoord komt uit onze database en roept nooit de vervoerder aan. Een achtergrondsynchronisatie vernieuwt elke zending (elke 10 minuten voor GO!, elk uur voor DHL) en synced_at geeft aan wanneer de vervoerder voor het laatst is bevraagd. Vereist de scope shipments_view of shipments_manage.

Verzoek

Padparameters

string
vereist
Referentie-ID van de zending (bijv. P2611194821).

Respons

Bij succes retourneert de API 200 OK met het zendingsobject.
string
vereist
Referentie-identifier van de zending.
string
vereist
Levenscyclusstatus van de zending. Een van pending, in_transit, delivered, fault of cancelled.
string
vereist
Vervoerder. Een van go, dhl_parcel, dhl_warenpost, rotrunner, rapido, ups of dhl_express. Een pakket met een thuistestkit is dhl_parcel, of dhl_warenpost wanneer het naar het buitenland gaat als Warenpost International.
string
Extern trackingnummer van de vervoerder. Kan null zijn.
string
Vrije tekstbeschrijving van de inhoud van het pakket, zoals opgegeven bij het aanmaken (bijv. "Medizinisch freigestellte Probe", "Home test kit"). Alleen ter informatie — of een pakket naar een laboratorium gaat lees je af uit destination, en de tegenhanger ervan uit paired_with. Kan null zijn.
string
vereist
Wie het verzendlabel heeft afgedrukt: aniva of external. Alleen zendingen van aniva ondersteunen Bijwerken en Annuleren; een external-pakket wordt gevolgd, maar geeft bij beide 501 terug.
string
Referentie van het andere pakket in een zending van twee pakketten — het pakket met een retourlabel en het pakket dat met dat label terugkomt. Ingesteld op beide. null bij een enkel pakket.
object
Ophaaladres. Kan null zijn.
object
Bezorgadres. Zelfde structuur als origin. Kan null zijn.
object
Gepland ophaalvenster. Kan null zijn.
string
Optionele notities. Kan null zijn.
object[]
vereist
Chronologische gebeurtenissen in de levenscyclus van de logistieke partner (oudste eerst). Lege array als de aanbieder nog geen gebeurtenissen heeft gemeld. Gebruik dit voor weergave per gebeurtenis, audit en gedetailleerdere signalen van de vervoerder; vertrouw op status voor de definitieve actuele status.
ShipmentAppointmentLink[]
vereist
Afspraken gekoppeld aan deze zending, oudste koppeling eerst. Elk item heeft de vorm { id, added_at }; haal elke id op via Afspraak ophalen voor de volledige gegevens van de afspraak. Lege array als er geen afspraken zijn gekoppeld. Alleen de afspraken binnen je toegangscontext worden weergegeven.
ShipmentHomeKitOrderLink[]
vereist
Thuistestkitbestellingen gekoppeld aan deze zending, oudste koppeling eerst, in dezelfde vorm { id, added_at }. Haal elke id op via Thuistestkitbestelling ophalen. Lege array voor praktijkpakketten. Alleen de bestellingen binnen je toegangscontext worden weergegeven. Zie Toegang.
string
Wanneer de zending voor het laatst met de vervoerder is gesynchroniseerd, als UTC-tijdstip. Leesverzoeken roepen de vervoerder nooit aan — een achtergrondsynchronisatie houdt zendingen actueel — dus dit geeft aan hoe oud het antwoord is. null tot de eerste synchronisatie.
string
vereist
Tijdstempel van aanmaken (ISO 8601).
string
Tijdstempel van laatste update (ISO 8601). Kan null zijn.

Herhaalde aanroepen

Aniva slaat het antwoord van dit endpoint 60 minuten op per API-sleutel. Een herhaald verzoek binnen deze periode krijgt het opgeslagen antwoord zolang de zending ongewijzigd is. Na een wijziging krijg je een nieuw antwoord. De headers Cache-Status en Age laten zien dat het antwoord is opgeslagen en hoe oud het is. In een opgeslagen antwoord kunnen synced_at en updated_at ouder zijn dan in een nieuw antwoord. Abonneer je op de webhook-gebeurtenissen shipment.created en shipment.updated om direct op de hoogte te zijn van wijzigingen. Zie Herhaalde leesverzoeken.

Foutresponsen