Rastreo

Fletea ofrece rastreo en tiempo real de todos tus envios. Cada vez que hay un cambio de estado, se genera un evento de tracking con ubicacion, fecha y descripcion.

Obtener tracking de una orden

El rastreo se incluye en el detalle de la orden:

GET /api/v1/orders/:id

Scope requerido: tracking:read

curl

curl "https://app.fletea.mx/api/v1/orders/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer flt_tu_api_key"

Respuesta (tracking_events)

{
  "id": "a1b2c3d4-...",
  "status": "out_for_delivery",
  "provider_tracking_number": "HEX-123456789",
  "tracking_events": [
    {
      "status": "created",
      "description": "Documentado",
      "occurred_at": "2026-03-01T10:00:00Z",
      "location": "CDMX",
      "raw_code": "DOC"
    },
    {
      "status": "picked_up",
      "description": "Paquete recolectado",
      "occurred_at": "2026-03-01T16:30:00Z",
      "location": "CDMX",
      "raw_code": "WDLVP"
    },
    {
      "status": "in_transit",
      "description": "Recepcion en almacen",
      "occurred_at": "2026-03-02T08:00:00Z",
      "location": "Queretaro",
      "raw_code": "ONWHDP"
    },
    {
      "status": "in_transit",
      "description": "En ruta foranea",
      "occurred_at": "2026-03-02T14:00:00Z",
      "location": "San Luis Potosi",
      "raw_code": "OFROU"
    },
    {
      "status": "out_for_delivery",
      "description": "Alertado para entrega",
      "occurred_at": "2026-03-03T07:00:00Z",
      "location": "Monterrey",
      "raw_code": "DLVALERT"
    }
  ]
}

Cada evento contiene:

Campo	Tipo	Descripcion
status	string	Estado interno de Fletea
description	string	Descripcion legible del evento
occurred_at	string	Fecha y hora ISO 8601
location	string	Ubicacion donde ocurrio el evento
raw_code	string	Codigo original del proveedor logistico

Pagina publica de rastreo

Cada orden tiene una pagina publica que puedes compartir con tus clientes. No requiere autenticacion:

https://app.fletea.mx/track/{slug}/{orderId}

Donde slug es el identificador de tu organizacion y orderId es el ID de la orden.

🚀

Personalizacion whitelabel

Puedes personalizar la pagina de rastreo con el logotipo y colores de tu marca activando el modo whitelabel desde Configuracion > Organizacion.

Flujo de rastreo

📋Guia generada

→

🚚Recolectado

→

📦En transito

→

🏍️En reparto

→

✅Entregado

→

Si la entrega falla, el paquete puede pasar a failed y reintentarse. Si se entrega exitosamente y el cliente solicita devolucion, pasa a la rama de retorno.

Mapeo de codigos del proveedor

Fletea normaliza los codigos del proveedor logistico a estados internos consistentes.

Creacion y pendientes

Codigo Proveedor	Estado Fletea	Descripcion
DOC	created	Documentado (guia generada)
DRFSP	created	Info recibida del sender
RECORDED	created	Registrado
PREFAC	pending	Prefacturado
COLALERT	pending	Alertado para recoleccion

Recoleccion

Codigo Proveedor	Estado Fletea	Descripcion
WDLVP	picked_up	Recolectado
PICKUP	picked_up	Recolectado

En transito

Codigo Proveedor	Estado Fletea	Descripcion
ONWHDP	in_transit	Recepcion en almacen
AFIBR	in_transit	Arribado entre oficinas
OFROU	in_transit	En ruta foranea
TRANS	in_transit	En transito
DISSND	in_transit	Envio con faltante

En reparto

Codigo Proveedor	Estado Fletea	Descripcion
DLVALERT	out_for_delivery	Alertado para entrega
ODLVR	out_for_delivery	En ruta de entrega
OFD	out_for_delivery	Salio a reparto

Entregado

Codigo Proveedor	Estado Fletea	Descripcion
DLV	delivered	Entregado con comprobante
RASDEL	delivered	Registro de entrega
DLVD	delivered	Entregado

Entrega fallida

Codigo Proveedor	Estado Fletea	Descripcion
NBROA	failed	No hay quien reciba
NOREQ	failed	Rechazado o no solicitado
IDVLA	failed	Direccion incorrecta
OUTCV	failed	Fuera de cobertura
NODLV	failed	No entregado

Retorno

Codigo Proveedor	Estado Fletea	Descripcion
RETAODP	returned	Retorno a origen DP
RETAO	returned	Retorno a origen
RTS	returned	Return to sender

💡

Codigos desconocidos

Si el proveedor envia un codigo que Fletea no reconoce, el estado se asigna como in_transit por defecto. Los codigos originales siempre se preservan en el campo raw_code del evento.

Recibir actualizaciones en tiempo real

Para recibir notificaciones automaticas cuando cambia el estado de un envio, configura webhooks en tu cuenta. Fletea enviara un POST a tu URL cada vez que haya un cambio.