Introducción
Cada envío gestionado a través de Moova atraviesa una serie de estados que reflejan su situación actual. Esta secuencia permite monitorear y gestionar el proceso de punta a punta, incluyendo envíos directos, con paso por warehouse, y devoluciones.
🧭 Estados posibles de un envío
DRAFT
El envío fue creado, pero aún no está listo para ser procesado. Esto puede deberse a datos incompletos, falta del paquete, o que no ha sido cobrado.READYATSTORE
El envío está preparado para ser retirado desde la tienda y trasladado al warehouse (WH) de Moova.READY
El envío está listo para ser recogido y entregado directamente a su destino.
⚠️ Si se utiliza el flow"warehouse"
, este estado indica que el envío ya está en nuestro WH, esperando ser despachado.CONFIRMED
El envío ha sido asignado a un moover (mensajero).AT PICKUP POINT
El moover ha llegado al punto de retiro. Este estado aplica principalmente para envíos del tipofood
.PICKEDUP
El moover ha recogido el paquete.INTRANSIT
El envío está en camino hacia su destino final.DELIVERED
El envío fue entregado exitosamente.CANCELED
El envío fue cancelado por el usuario.INCIDENCE
Ocurrió una situación inesperada que afecta el proceso del envío. Se incluye una descripción detallada de la incidencia.TO BE RETURNED
El envío será devuelto a su lugar de origen.RETURNED
El envío ya fue devuelto a su origen.RECEIVEDATWAREHOUSE
Estado exclusivo para envíos del tiporeverse
. Indica que el paquete ha llegado al warehouse de Moova.
🔄 Transición de estados - Envíos Regular
Este flujo aplica para operaciones donde el envío pasa desde el WH del seller directo al cliente final
🔄 Transición de estados - Envíos con paso por warehouse
Este flujo aplica para operaciones donde el envío pasa por el WH antes de ser entregado.
El envío pasara a
READYATSTORE
cuando está listo para ser retirado desde la tienda.Al ser recogido por el moover y alojado en nuestro WH, cambia a
READY
.Cuando sale del WH para ser entregado, pasa a
INTRANSIT
.
📌 Importante: Para que este flujo funcione correctamente:
El envío debe tener el
flow: "warehouse"
si ya está armado y listo para retiro.Si el envío aún no está listo, se puede crear con
settings: [10]
, lo que lo dejará enDRAFT
para ser actualizado manualmente.
🔁 Transición de estados - Envíos de reversa
Este flujo aplica para devoluciones desde el cliente hacia el comercio.
El envío se crea con
type: "reverse"
y comienza su recorrido desde el cliente final hacia nuestro warehouse.Al ingresar al WH, cambia al estado
RECEIVEDATWAREHOUSE
.Una vez despachado hacia el comercio o su sucursal correspondiente, pasa a estado
DELIVERED
.