Spring videre til hovedindholdet

[GCL] Logistics API – Tracking

Juliana Maciel Maruri da Cunha avatar
Skrevet af Juliana Maciel Maruri da Cunha
Opdateret i denne uge

Få trackingoplysninger om en pakke og dens aktuelle status.

Returner ordren shortUid og de checkpoints, der angiver pakkens aktuelle status og opdateringer.

GET /v1/tracking/{trackingNumber}

Eksempel på anmodning

/v1/tracking/EXMPL0001234TRCKNUM

Eksempel på succesfuldt svar

{  "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å fejlmeddelelse

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

Anmodning

Parameter

Type

Beskrivelse

trackingNumber (påkrævet)

streng

Pakkens trackingnummer leveret af fragtfirmaet

Vellykket svar

Parameter

Type

Beskrivelse

shortUid (påkrævet)

streng

En unik kort identifikator for svaret

trackingNumber (påkrævet)

streng

Pakkens trackingnummer

trackingUrl (valgfrit)

streng

Leverandørens tracking-URL for pakken

shipmentMethodUid (valgfrit)

streng

UID for forsendelsesmetoden, der bruges til at levere pakken

shipmentMethodName (valgfrit)

streng

Navnet på forsendelsesmetoden, der bruges til at levere pakken

carrierUid (valgfrit)

streng

Transportørens UID, der bruges til at levere pakken

carrierName (valgfrit)

streng

Navnet på fragtfirmaet, der leverer pakken

weightInGrams (valgfrit)

streng

Pakkens vægt i gram

checkpoints (valgfrit)

CheckPoint[]

Et array af CheckPoint-objekter (kan være tomt)

CheckPoint

Parameter

Type

Beskrivelse

status (påkrævet)

nummer

Status-ID-nummer

statusUid (påkrævet)

streng

Status UID (se StatusEnum)

message (påkrævet)

streng

Statusmeddelelse

description (valgfrit)

streng

Statusbeskrivelse

location (valgfrit)

streng

Pakkens nuværende placering (adresse)

createdAt (påkrævet)

streng

Status oprettet den (RFC3339)

expectedDeliveryDate (valgfrit)

streng

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

signedBy (påkrævet)

streng

Hvilken udbyder/tjeneste underskrev den

StatusEnum

Statusværdi

Beskrivelse

registreret

Angiver registreret status

under transport

Angiver status for forsendelse

Under levering

Angiver status for levering

mislykket_forsøg

Angiver status for mislykket forsøg

shipping_exception

Angiver status for undtagelse ved forsendelse

Kan afhentes

Angiver status for afhentning

leveret

Angiver leveret status

afsendt

Angiver status for afsendt

returneret

Angiver returneret status

ikke afhentet

Angiver status for ikke afhentet

Fejlmeddelelse

Parameter

Type

Beskrivelse

trackingNumber

streng

Pakkens trackingnummer

kode

streng

Fejlkode

besked

streng

Fejlmeddelelse

details (valgfrit)

ResponseErrorDetails

Yderligere fejloplysninger

ResponseErrorDetails

Parameter

Type

Beskrivelse

kode

streng

Fejlkode.

besked

streng

Fejlmeddelelse

reference (valgfrit)

streng

Reference-ID.


📝 Var det ikke det, du ledte efter?

Hjælp os med at gøre denne artikel bedre, send os en e-mail på [email protected] — husk at skrive artiklens titel med.

Besvarede dette dit spørgsmål?