Appearance
Estados del pedido
status es el código en inglés (estable); status_label la etiqueta en español para mostrar. Usa el código en tu lógica.
status | Qué significa | Quién lo pone |
|---|---|---|
registered | La tienda lo creó; el paquete aún no llegó al delivery | API / panel de tienda |
received | El delivery tiene el paquete en mano | Despachador |
assigned | Tiene motorizado asignado | Despachador |
in_transit | El motorizado salió con él | App del motorizado |
delivered | Entregado, con foto | App del motorizado |
not_found | No encontró al destinatario; se va a reintentar | App del motorizado |
rescheduled | Reprogramado para otro día | Despachador |
rejected | El destinatario lo rechazó | App del motorizado |
returned | Volvió a la tienda | Despachador |
cancelled | Anulado (a mano, o solo a las 24 h sin recibir) | Tienda / delivery / sistema |
Flujo normal
registered → received → assigned → in_transit → deliveredTerminales
delivered, rejected, returned y cancelled cierran el ciclo. cancelled tiene una excepción: un pedido auto-cancelado que la tienda lleva tarde puede volver a received con el mismo id.
not_found y rescheduled no son terminales
Todavía hay que coordinar con el destinatario. El pedido vuelve a assigned o in_transit cuando se reintenta.
Qué evento corresponde a qué estado
| Cambio | Evento |
|---|---|
→ registered | order.created |
→ assigned | order.assigned |
→ delivered | order.delivered |
→ cancelled | order.cancelled |
Los demás estados no emiten evento hoy. Si necesitas seguirlos, GET /v1/orders/:id.