Appearance
Ciclo de Vida de la Expedicion
El ciclo de vida de una expedicion en PROXIMITI sigue una maquina de estados con 7 estados y dos caminos ramificados: el camino feliz (3 pasos) para entrega normal, y el camino de caducidad (6 pasos) para paquetes que exceden su periodo de retencion.
Maquina de Estados
Referencia de Estados
| Estado | Significado | Camino |
|---|---|---|
| PENDIENTE | Creada, esperando entrega del transportista al PUDO | Ambos |
| RECEPCIONADO | Recibida en centro PUDO — punto de bifurcacion | Ambos |
| ENTREGADO | Entregada al destinatario con POD capturado | Feliz |
| CADUCADO | Periodo de retencion excedido — no recogida | Caducidad |
| LOCKED_FOR_RETRIEVAL | Bloqueada para recogida por transportista | Caducidad |
| RECOGIDO | Recogida por transportista desde PUDO | Caducidad |
| RETIRADO | Completamente retirada, ciclo cerrado | Caducidad |
Logica de Bifurcacion
La bifurcacion ocurre en RECEPCIONADO:
- Camino feliz (3 pasos):
PENDIENTE->RECEPCIONADO->ENTREGADO— el destinatario recoge el paquete y se captura el POD (firma + foto de documento de identidad + numero de documento). - Camino de caducidad (6 pasos):
PENDIENTE->RECEPCIONADO->CADUCADO->LOCKED_FOR_RETRIEVAL->RECOGIDO->RETIRADO— el periodo de retencion expira y el transportista recoge el paquete. Los paquetes caducados se exportan a ALINA mediante el patron de outbox transaccional.
INFO
El servicio ws-pprx-expired ejecuta un trabajo programado que transiciona los paquetes de RECEPCIONADO a CADUCADO cuando se alcanza su fecCaducidad (fecha de caducidad). Esta transicion es completamente automatizada — no se invoca ningun endpoint del BFF.
Flujo de Creacion de Expedicion
El ciclo de vida comienza cuando se crea una expedicion a traves del BFF. La cabecera X-Idempotency-Key garantiza semantica de exactamente-una-vez — enviar la misma clave dos veces devuelve 409 Conflict en lugar de crear un duplicado.
Detalles Clave
- Idempotencia: El
X-Idempotency-Keyes un UUID generado por el cliente. El servicio de expediciones comprueba si existe un registro con la misma clave antes de insertar. Esto protege contra reintentos de red que creen paquetes duplicados. - Estado inicial: Todas las expediciones comienzan en
PENDIENTE— esperando la entrega fisica en el centro PUDO asignado. - Validacion de centro: El servicio de expediciones verifica que el centro PUDO destino existe a traves del servicio de centros antes de persistir.