Gå til hovedinnhold

[GCL] Logistics API – sporing

Juliana Maciel Maruri da Cunha avatar
Skrevet av Juliana Maciel Maruri da Cunha
Oppdatert denne uken

Få sporingsdetaljer for en pakke og gjeldende status.

Returner ordren shortUid og sjekkpunktene som indikerer den nåværende statusen og oppdateringene for pakken.

GET /v1/tracking/{trackingNumber}

Eksempel på forespørsel

/v1/tracking/EXMPL0001234TRCKNUM

Eksempel på suksessrespons

{  "shortUid": "EXMPL0001234",  "trackingNumber": "EXMPL0001234TRCKNUM",  "trackingUrl": "https://mydhl.express.dhl/no/en/tracking.html#/results?id=EXMPL0001234TRCKNUM",  "shipmentMethodUid": "dhl_express_worldwide",  "shipmentMethodName": "DHL Express Worldwide",  "carrierUid": "dhl_express",  "carrierName": "DHL Express",  "weightInGrams": "460",  "checkpoints": [    {      "status": 6,      "message": "Delivered",      "description": "Delivered",      "location": "LONDON-GBR, United Kingdom",      "createdAt": "2024-07-29T18:16:06Z",      "expectedDeliveryDate": "",      "statusUid": "delivered",      "signedBy": "aftership"    },    {      "status": 2,      "message": "Shipment is out with courier for delivery",      "description": "Out for Delivery",      "location": "LONDON-GBR, United Kingdom",      "createdAt": "2024-07-29T08:58:40Z",      "expectedDeliveryDate": "",      "statusUid": "out_for_delivery",      "signedBy": "aftership"    },    {      "status": 1,      "message": "Arrived at DHL Sort Facility LONDON-HEATHROW-GBR",      "description": "Arrival scan",      "location": "LONDON-HEATHROW-GBR, United Kingdom",      "createdAt": "2024-07-29T00:35:29Z",      "expectedDeliveryDate": "",      "statusUid": "in_transit",      "signedBy": "aftership"    },    {      "status": 1,      "message": "Scheduled to depart on the next planned movement",      "description": "Departure Scan",      "location": "EAST MIDLANDS-GBR, United Kingdom",      "createdAt": "2024-07-28T12:02:21Z",      "expectedDeliveryDate": "2024-07-30",      "statusUid": "in_transit",      "signedBy": "aftership"    },    {      "status": 1,      "message": "Customs clearance status updated. Note - The Customs clearance process may start while the shipment is in transit to the destination.",      "description": "Customs clearance started",      "location": "EAST MIDLANDS-GBR, United Kingdom",      "createdAt": "2024-07-26T13:00:23Z",      "expectedDeliveryDate": "2024-07-30",      "statusUid": "in_transit",      "signedBy": "aftership"    },    {      "status": 1,      "message": "Shipment has departed from a DHL facility ULM-DEU",      "description": "Departure Scan",      "location": "ULM-DEU, Germany",      "createdAt": "2024-07-25T16:41:58Z",      "expectedDeliveryDate": "2024-07-30",      "statusUid": "in_transit",      "signedBy": "aftership"    },    {      "status": 1,      "message": "Shipment picked up",      "description": "Acceptance scan",      "location": "ULM-DEU, Germany",      "createdAt": "2024-07-25T14:21:55Z",      "expectedDeliveryDate": "2024-07-30",      "statusUid": "in_transit",      "signedBy": "aftership"    }  ]}

Eksempel på feilmelding

{  "trackingNumber": "EXMPL0001234TRCKNUM",  "code": "TRACKING_DETAILS_NOT_FOUND",  "message": "Tracking details not found.",  "details": null}

Forespørsel

Parameter

Type

Beskrivelse

trackingNumber (obligatorisk)

streng

Pakkesporingsnummeret gitt av transportøren

Vellykket respons

Parameter

Type

Beskrivelse

shortUid (obligatorisk)

streng

En unik kort identifikator for svaret

trackingNumber (obligatorisk)

streng

Sporingsnummeret til pakken

trackingUrl (valgfritt)

streng

Fraktførerens sporings-URL for pakken

shipmentMethodUid (valgfritt)

streng

UID for fraktmetoden som brukes til å levere pakken

shipmentMethodName (valgfritt)

streng

Navnet på fraktmetoden som brukes til å levere pakken

carrierUid (valgfritt)

streng

Transportørens UID som brukes til å levere pakken

carrierName (valgfritt)

streng

Navnet på transportøren som brukes til å levere pakken

weightInGrams (valgfritt)

streng

Vekt på pakken i gram

checkpoints (valgfritt)

CheckPoint[]

En liste med CheckPoint-objekter (kan være tom)

CheckPoint

Parameter

Type

Beskrivelse

status (obligatorisk)

nummer

Status-ID-nummer

statusUid (obligatorisk)

streng

Status UID (se StatusEnum)

message (obligatorisk)

streng

Statusmelding

beskrivelse (valgfritt)

streng

Statusbeskrivelse

location (valgfritt)

streng

Nåværende pakkens plassering (adresse)

createdAt (obligatorisk)

streng

Status opprettet (RFC3339)

expectedDeliveryDate (valgfritt)

streng

Forventet leveringsdato (YYYY-MM-DD). Eksempel: 2024-01-21

signedBy (obligatorisk)

streng

Hvilken leverandør/tjeneste signerte den

StatusEnum

Statusverdi

Beskrivelse

registrert

Representerer registrert status

under transport

Representerer statusen «under transport»

Sendt ut for levering

Representerer statusen «sendt til levering»

mislykket_forsøk

Representerer status for mislykket forsøk

fraktunntak

Representerer status for fraktunntak

Kan hentes

Representerer statusen «tilgjengelig for henting»

levert

Representerer levert status

sendt

Representerer statusen sendt

returnert

Representerer returnert status

ikke hentet

Representerer statusen «ikke hentet»

Feilmelding

Parameter

Type

Beskrivelse

trackingNumber

streng

Sporingsnummeret til pakken

kode

streng

Feilkode

melding

streng

Feilmelding

detaljer (valgfritt)

ResponseErrorDetails

Ytterligere feildetaljer

ResponseErrorDetails

Parameter

Type

Beskrivelse

kode

streng

Feilkode.

melding

streng

Feilmelding

referanse (valgfritt)

streng

Referanse-ID.


📝 Ikke det du lette etter?

Hjelp oss å forbedre denne artikkelen, send oss en e-post til [email protected] — husk å ta med artikkeltittelen.

Svarte dette på spørsmålet?