Recursos
Estados del envío
Cada envío tiene un código de estado numérico. Esta es la lista completa: si ves un código que no está acá, escríbenos.
Tabla de estados
| code | Qué significa | Webhook |
|---|---|---|
| 0 | Pendiente El pedido se creó y espera que el operador lo retire. | created |
| 100 | Etiqueta descargada Alguien descargó la etiqueta del envío desde el portal de Beartrack. Se marca al pedir la descarga, así que no confirma que la etiqueta se haya impreso. Es opcional: un envío puede pasar de | No dispara |
| 1 | Recolectado El operador retiró el paquete en el comercio. | collected |
| 2 | En bodega El paquete se escaneó en la bodega del operador. | at_warehouse |
| 3 | En ruta El paquete salió a reparto con un repartidor. | in_transit |
| 30 | En camino a la dirección El repartidor va hacia la dirección de entrega. | in_transit |
| 4 | Entregado El paquete se entregó. | delivered |
| 5 | Cancelado El envío se anuló y no se va a entregar. | cancelled |
| 6 | Entrega fallida Hubo un intento de entrega y no se pudo entregar. El código no distingue el motivo de forma confiable: trata | delivery_failed |
| 7 | Entrega fallida Igual que | delivery_failed |
| 21 | Recibido para devolución El paquete entró al circuito de devolución al comercio. | return_received |
| 22 | En bodega para devolución El paquete está en la bodega del operador, esperando volver al comercio. | return_at_warehouse |
| 31 | En ruta de devolución El paquete va de vuelta al comercio. | return_in_transit |
| 41 | Devolución completada El paquete se devolvió al comercio. | returned |
El estado 100
Significa que la etiqueta se descargó desde el portal. Lo verás en el historial del envío (en la API, con el nombrelabel_downloaded), pero no dispara webhook y no es una etapa obligatoria: muchos envíos pasan directo de 0 a 1.Dónde aparecen
- En Consultar pedido:
statuses el estado actual (codeyname) ystatus_historytrae cada cambio con su fecha. - En el seguimiento público:
statusypackageStatusHistory, solo con el código. - En los webhooks:
status.codeystatus.name, solo para los estados con nombre en la columna Webhook.