Obtener orden por LPN

Consulta la información completa de una orden a partir de su identificador único (LPN / trackingId).

Este endpoint permite al operador logístico (carrier) obtener la información completa y detallada de una orden específica utilizando su identificador único (LPN), también conocido como `trackingId`.

Flujo de acceso mediante código QR

La URL completa para consumir este endpoint no es estática. Se obtiene de forma dinámica al escanear el código QR presente en la etiqueta del paquete en la bodega del seller.

Path params

lpn

string

Requerido

Identificador único del paquete (trackingId). Es el valor que se incorpora en la URL dinámica obtenida del QR.

Headers

x-country

string

Requerido

Código del país en el que opera el carrier (ej. CL).

x-environment

string

Requerido

Entorno de ejecución de la petición (ej. UAT).

Authorization

string

Requerido

Token de acceso temporal con prefijo Bearer.

URL del endpoint

●Ambiente QA: `https://logistic-api-qa.falabella.com/schn-trmg-3pl-directo/v1/orders/{lpn}`
●Ambiente Producción: `https://logistic-api.falabella.com/schn-trmg-3pl-directo/v1/orders/{lpn}`

Campos de respuesta

Campo	Tipo	Descripción
type	`string`	Tipo de envío (ej. `FORWARD` para última milla).
orderNumber	`string`	Número de la orden de compra asociada.
serviceType	`string`	Tipo de servicio (ej. `HOME_DELIVERY`).
statuses	`array`	Historial de estados a nivel de orden.
serviceLevel	`string`	Nivel de servicio contratado (ej. `REGULAR`).
parcel	`object`	Contiene toda la información específica del paquete.
↳ lpn	`string`	Identificador único del paquete.
↳ dimensions	`object`	Dimensiones y peso del paquete.
↳ statuses	`array`	Historial de estados a nivel de paquete.
deliveryPromiseDate	`object`	Ventana de tiempo prometida para la entrega.
↳ from	`string`	Inicio de la promesa de entrega (ISO 8601).
↳ to	`string`	Fin de la promesa de entrega (ISO 8601).
shipFrom	`object`	Dirección de origen (bodega del seller).
shipTo	`object`	Dirección de destino (cliente final).
recipient	`object`	Información del destinatario.
↳ fullName	`string`	Nombre completo de la persona que recibe.
↳ contacts	`array`	Lista de contactos del destinatario (ej. teléfono).

Respuesta 200

{
  "type": "FORWARD",
  "orderNumber": "TEST_OC",
  "serviceType": "HOME_DELIVERY",
  "statuses": [
    { "status": "CREATED", "eventTime": "2026-04-29T14:36:17.710Z" }
  ],
  "serviceLevel": "REGULAR",
  "parcel": {
    "lpn": "TEST_LPN",
    "dimensions": {
      "width": "62.3", "height": "4", "length": "2",
      "weight": "5", "sizeUOM": "cm", "weightUOM": "kg"
    },
    "statuses": [
      { "status": "CREATED", "eventTime": "2026-04-29T14:36:17.710Z" }
    ]
  },
  "deliveryPromiseDate": {
    "from": "2023-05-12T20:17:46.384Z",
    "to": "2023-05-15T12:16:41.384Z"
  },
  "shipFrom": {
    "sellerId": "SC478FA",
    "addressLine1": "Avda Lo Espejo From",
    "municipalName": "CERRILLOS",
    "cityName": "SANTIAGO",
    "countryCode": "CL"
  },
  "shipTo": {
    "addressLine1": "JUAN ESTEBAN MONTERO",
    "addressLine2": "4655",
    "municipalName": "LAS CONDES",
    "cityName": "SANTIAGO",
    "countryCode": "CL"
  },
  "recipient": {
    "type": "RECIPIENT",
    "fullName": "RICARDO GREZ LARRAECHEA",
    "contacts": [
      { "type": "PHONE_NUMBER", "value": "3124801067" }
    ]
  }
}

Autenticación Operador Logístico Actualizar estado