Deliver (sD)

Definicion SCOR

En SCOR v12.0, Deliver cubre los procesos asociados con la entrega de productos terminados y servicios para satisfacer demanda planificada o real. Esto incluye gestion de pedidos, gestion de transporte y gestion de distribucion.

Como PROXIMITI Implementa Deliver

El negocio principal de PROXIMITI es la entrega de paquetes de ultima milla a traves de centros PUDO (Pick-Up & Drop-Off). Todo el ciclo de vida del paquete — desde la creacion de la expedicion pasando por la entrega del transportista, la recepcion en el centro PUDO, la recogida por el destinatario y la prueba de entrega — se mapea al proceso L1 Deliver.

La plataforma implementa un unico proceso L2 bajo Deliver: sD1 (Deliver Stocked Product). Esto cubre todos los flujos estandar de paquetes incluyendo creacion de expediciones con claves de idempotencia, seguimiento por codigo de barras, recepcion con gestion de capacidad en centros PUDO, captura de POD (firma + foto de documento de identidad + numero de documento), y el intercambio dual-QR transportista-a-PUDO.

Todas las operaciones de Deliver se exponen a traves del BFF (puerto 8090) y son gestionadas principalmente por ws-pprx-shipments (puerto 8092), con coordinacion de capacidad via ws-pprx-centers (puerto 8091).

Mapeo de Procesos

sD1: Deliver Stocked Product

Nombre PROXIMITI: Entrega de Paquetes de Ultima Milla

Servicios: ws-pprx-shipments, ws-pprx-bff

Endpoint	Metodo	Descripcion
/api/v1/shipments	POST	Crear expedicion (con X-Idempotency-Key)
/api/v1/shipments	GET	Listar expediciones (filtradas por centro)
/api/v1/shipments/{barcode}	GET	Obtener detalle de expedicion
/api/v1/shipments/{barcode}/receive	POST	Recibir paquete en centro PUDO
/api/v1/shipments/{barcode}/deliver	POST	Entregar paquete con POD
/api/v1/shipments/{barcode}/pod	GET	Obtener metadatos de POD
/api/v1/shipments/{barcode}/pod/upload-token	POST	Obtener URL prefirmada para subir activos POD
/api/v1/shipments/{barcode}/pod/image/{type}	GET	Transmitir imagen POD (firma/evidencia)
/api/v1/shipments/{barcode}/label	GET	Generar etiqueta de expedicion
/api/v1/shipments/{barcode}/carrier-handshake	POST	Iniciar sesion de intercambio dual-QR
/api/v1/shipments/qr-session/{token}/validate	POST	Validar sesion QR (lado PUDO)
/api/v1/shipments/qr-session/{token}/status	GET	Consultar estado de sesion QR (lado transportista)
/api/v1/shipments/batch-drop	POST	Entrega multiple de paquetes

Pantallas del portal: Lista de expediciones, Detalle de expedicion, Seguimiento de expedicion (publico)

Pantallas Flutter: Dashboard, Recepcion, Entrega (POD en 6 pasos), Intercambio Dual-QR, Lista de Expediciones, Detalle de Expedicion