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