Return (sR)

Definicion SCOR

En SCOR v12.0, Return cubre los procesos asociados con la devolucion o recepcion de productos devueltos. Esto incluye autorizacion de devolucion, programacion, recepcion y disposicion de bienes devueltos.

Como PROXIMITI Implementa Return

Los procesos Return de PROXIMITI cubren dos escenarios en el ecosistema PUDO:

1. Gestion de reclamaciones e incidencias (sR1) — Cuando un paquete tiene problemas (dano, contenido erroneo, articulos faltantes), los operadores y transportistas pueden abrir incidencias a traves del sistema de seguimiento de incidencias de la plataforma.

2. Recogida de paquetes caducados (sR2) — Cuando un paquete excede su periodo de retencion en un centro PUDO, entra en el camino de caducidad. El servicio ws-pprx-expired automatiza la deteccion y desencadena el flujo de recogida por transportista, con datos exportados al sistema ERP ALINA mediante el patron de outbox transaccional.

Mapeo de Procesos

sR1: Return Defective Product

Nombre PROXIMITI: Gestion de Reclamaciones e Incidencias

Servicio: ws-pprx-issues (puerto 8096)

Endpoint	Metodo	Descripcion
/api/v1/issues	GET	Listar incidencias (filtradas por centro/rol)
/api/v1/issues	POST	Crear nueva incidencia/reclamacion
/api/v1/issues/{id}	GET	Obtener detalle de incidencia
/api/v1/issues/{id}	PUT	Actualizar estado de incidencia
/api/v1/issues/{id}/comments	POST	Agregar comentario a incidencia

Pantallas del portal: Lista de incidencias/reclamaciones, Detalle de incidencia

---

sR2: Return Excess Product

Nombre PROXIMITI: Recogida de Paquetes Caducados

Servicio: ws-pprx-expired (puerto 8095)

Endpoint	Metodo	Descripcion
/api/v1/shipments/{barcode}/retrieve	POST	Transportista inicia recogida de paquete caducado

Comportamiento clave:

• El servicio ws-pprx-expired ejecuta un trabajo programado que busca expediciones RECEPCIONADO cuya fecCaducidad haya pasado
• La transicion a CADUCADO es completamente automatizada (sin endpoint del BFF)
• La exportacion a ALINA usa el patron de outbox transaccional — la fila del outbox se escribe en la misma transaccion de BD que el cambio de estado
• Las entregas fallidas van a una Cola de Mensajes Muertos (DLQ) para reintento

Pantallas Flutter: Recogida de Caducados (pestana "Caducados" en la app del transportista)

Ver tambien: Ciclo de Caducidad para el diagrama de secuencia completo.