Obtén los detalles de seguimiento de un paquete y su estado actual.

Devuelve el shortUid del pedido y los puntos de control que indican el estado actual y las actualizaciones del paquete.

GET /v1/tracking/{trackingNumber}

Ejemplo de solicitud

/v1/tracking/EXMPL0001234TRCKNUM

Ejemplo de respuesta de éxito

{
  "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"
    }
  ]
}

Ejemplo de respuesta de error

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

Solicitar

Parámetro	Tipo	Descripción
`trackingNumber` (obligatorio)	cadena	El número de seguimiento del paquete proporcionado por la empresa de transporte

Respuesta satisfactoria

Parámetro	Tipo	Descripción
`shortUid` (obligatorio)	cadena	Un identificador corto único para la respuesta
`trackingNumber` (obligatorio)	cadena	El número de seguimiento del paquete
`trackingUrl` (opcional)	cadena	URL de seguimiento del paquete del transportista
`shipmentMethodUid` (opcional)	cadena	UID del método de envío utilizado para entregar el paquete
`shipmentMethodName` (opcional)	cadena	Nombre del método de envío utilizado para entregar el paquete
`carrierUid` (opcional)	cadena	UID del transportista utilizado para entregar el paquete
`carrierName` (opcional)	cadena	Nombre de la empresa de transporte utilizada para entregar el paquete
`weightInGrams` (opcional)	cadena	Peso del paquete en gramos
`checkpoints` (opcional)	CheckPoint[]	Una matriz de objetos CheckPoint (puede estar vacía)

CheckPoint

Parámetro	Tipo	Descripción
`status` (obligatorio)	número	Número de identificación del estado
`statusUid` (obligatorio)	cadena	UID de estado (consulta StatusEnum)
`message` (obligatorio)	cadena	Mensaje de estado
`description` (opcional)	cadena	Descripción del estado
`location` (opcional)	cadena	Ubicación actual del paquete (dirección)
`createdAt` (obligatorio)	cadena	Estado creado en (RFC3339)
`expectedDeliveryDate` (opcional)	cadena	Fecha de entrega estimada (`AAAA-MM-DD`). Ejemplo: `2024-01-21`
`signedBy` (obligatorio)	cadena	Qué proveedor/servicio lo firmó

StatusEnum

Valor del estado	Descripción
`registrado`	Representa el estado registrado
`en tránsito`	Representa el estado "en tránsito"
`En reparto`	Representa el estado "en reparto"
`Intento fallido`	Representa el estado de intento fallido
`shipping_exception`	Representa el estado de excepción de envío
`Disponible para recogida`	Representa el estado "Disponible para recoger"
`entregado`	Representa el estado de entregado
`enviado`	Representa el estado de envío
`devuelto`	Representa el estado de devolución
`no recogido`	Representa el estado de "no recogido"

Respuesta de error

Parámetro	Tipo	Descripción
`Número de seguimiento`	cadena	El número de seguimiento del paquete
`código`	cadena	Código de error
`mensaje`	cadena	Mensaje de error
`details` (opcional)	Detalles del error de respuesta	Detalles adicionales del error

Detalles del error de respuesta

Parámetro	Tipo	Descripción
código	cadena	Código de error.
mensaje	cadena	Mensaje de error
Referencia (opcional)	cadena	ID de referencia.

Siguiente paso: 🔗 [GCL] API de logística - Colección Postman

📝 ¿No era esto lo que buscabas?

Ayúdanos a mejorar este artículo, envíanos un correo a [email protected] — por favor, incluye el título del artículo.

[GCL] API de logística: seguimiento