ReferenciaAPI LogísticaIntroducción a la API Directo Falabella (Carriers)
Introducción a la API Directo Falabella (Carriers)
API para que los operadores logísticos se integren directamente con Falabella en el flujo de última milla.
La API Directo Falabella para Operadores Logísticos permite a los carriers integrarse de manera directa con los sistemas de Falabella. Esta integración optimiza el flujo de última milla (Home Delivery), habilitando a los operadores logísticos para realizar dos acciones principales:
- ●Consultar órdenes: obtener la información detallada del envío que debe transportarse (por LPN).
- ●Reportar el seguimiento (Tracking): notificar a Falabella en tiempo real sobre los cambios de estado físico del paquete (ej. en tránsito, entregado, intentos fallidos, etc.).
Todas las interacciones con los endpoints expuestos requieren autenticación previa mediante la generación de un token Bearer.
Glosario de Términos
Para facilitar la comprensión de esta documentación, a continuación se definen los conceptos técnicos clave utilizados a lo largo de los endpoints:
| Campo | Descripción |
|---|---|
| Carrier | Operador logístico responsable de transportar el paquete. |
| Shipment | Envío en su totalidad, el cual puede contener uno o más paquetes. |
| Parcel | Paquete individual asociado a un shipment. |
| LPN / trackingId | Identificador único del paquete. Para efectos de esta API, LPN y trackingId representan el mismo identificador. "LPN" corresponde al nombre utilizado internamente por Falabella. |
Flujo de acceso: obtención de la URL mediante código QR
Antes de consumir el endpoint de Consulta de Órdenes (GET), el integrador debe considerar que la URL de consulta no es estática; debe construirse dinámicamente.
Para acceder a dicha URL, el operador logístico debe escanear el código QR presente físicamente en la etiqueta del paquete. La lectura de este QR retorna un objeto JSON que contiene los datos exactos requeridos para construir la petición hacia la API.
Estructura del JSON contenido en el QR
{
"origin": "Falabella",
"url": "<URL dinámica del endpoint GET>",
"sellerId": "<SellerIDSD0123>"
}Detalle de los campos
| Campo | Descripción |
|---|---|
| origin | Valor constante "Falabella". Identifica el origen de la etiqueta. |
| url | URL completa del endpoint GET a consumir. Esta URL ya incluye el LPN del paquete específico y es dinámica por cada orden generada. |
| sellerId | Identificador del seller. Es un dato de uso interno para el integrador logístico y no debe enviarse en las cabeceras (headers) de las peticiones a la API. |