Recepcion y Entrega (POD)

Esta pagina documenta los dos flujos principales del operador PUDO: recibir un paquete entregado por un transportista, y entregarlo al destinatario con captura de Prueba de Entrega (POD).

Flujo de Recepcion

El operador escanea el codigo de barras del paquete en la pantalla Recibir Expedicion. El BFF inyecta las cabeceras X-Center-Id y X-Center-Code (obtenidas del JWT de Keycloak del operador a traves del servicio de usuarios). El servicio de expediciones actualiza el estado a RECEPCIONADO y verifica la capacidad del centro PUDO a traves del servicio de centros usando REST sincrono + ETag (Patron A).

Flujo de Entrega (con POD)

Importante

Los campos firmaReceptorUrl y evidenciaFotoUrl en el cuerpo de la solicitud de entrega deben usar la blobUrl (ruta permanente de MinIO) devuelta por el endpoint upload-token — NO la uploadUrl (prefirmada, temporal). La URL prefirmada es solo para la subida PUT.

Componentes del POD

La Prueba de Entrega consta de tres elementos capturados en el flujo de entrega de 6 pasos de la app Flutter:

1. Firma — el destinatario firma en la pantalla del dispositivo (assetType: "signature")
2. Foto de documento de identidad — foto del documento de identidad del destinatario (assetType: "evidence")
3. Numero de documento de identidad — campo de texto para el numero de documento (ej., 12345678A)