Control RPC

Rastrea la entrega y devolución de contenedores RPC entre bodega, camión y tienda para auditar el inventario en circulación.

El módulo de Control RPC (Recipientes de Plástico Colapsable) permite registrar cuántos contenedores salen hacia CEDIS/Tienda y cuántos regresan físicamente, manteniendo un inventario preciso de los RPC en circulación por camión y departamento.

Bandeja Pendientes

RPC enviados al destino pero cuyo retorno físico aún no ha sido confirmado.

Bandeja Completados

RPC cuyo retorno ya fue registrado y el movimiento está cerrado.

Resumen KPI

Totales globales: registradas, pendientes, completadas, entregadas, retornadas y faltantes.

Registrar retorno

Confirma la cantidad de RPC recibidos físicamente de vuelta en bodega.

---

Modelo de datos

{
  "idRpc": 1,
  "numeroCamion": "CAM-0042",
  "departamento": "FRUTAS",
  "tipoRpc": "TIPO1",
  "cantidadEntregada": 50,
  "cantidadRetornada": 0,
  "fechaRegistro": "2026-04-07",
  "pendienteRetorno": true
}

Campos

Campo	Tipo	Descripción
idRpc	Long	Identificador único del registro.
numeroCamion	String	Identificador del camión que entregó los RPC.
departamento	Departamento	Departamento al que pertenecen los RPC (ej. FRUTAS).
tipoRpc	TipoRpc	Tipo de contenedor (ver tabla de valores más abajo).
cantidadEntregada	int	Número de RPC enviados. Debe ser mayor a 0.
cantidadRetornada	int	Número de RPC devueltos físicamente.
fechaRegistro	LocalDate	Fecha en que se registró el movimiento.
pendienteRetorno	boolean	true si aún no se retornaron todos; false cuando el retorno es completo.

---

Tipos de RPC (TipoRpc)

Valor	Descripción
TIPO1	Contenedor estándar tipo 1.
TIPO2	Contenedor estándar tipo 2.
TIPO3	Contenedor estándar tipo 3.
CAJA_CARTON	Caja de cartón (no colapsable).
ENTREGA	Movimiento de entrega genérica.
DISCREPANCIA	Contenedor asociado a una discrepancia.
OTRO	Cualquier otro tipo de contenedor.

---

Bandejas de trabajo

El dashboard de RPC organiza los registros en dos bandejas según su estado de retorno.

Bandeja 1 — Pendientes de retorno

Muestra los RPC que fueron enviados a la tienda o CEDIS pero cuyo retorno físico no ha sido confirmado todavía (pendienteRetorno = true).

GET /api/rpc/pendientes

Desde esta bandeja el operador puede registrar el retorno cuando los contenedores regresen al almacén.

En la implementación actual, los endpoints /pendientes y /completados filtran únicamente por el departamento FRUTAS. Los registros de otros departamentos son visibles a través del resumen KPI (/resumen) y en el historial completo.

Bandeja 2 — Completados

Muestra los RPC cuyo retorno ya fue registrado (pendienteRetorno = false). Estos registros son de solo lectura y sirven como historial de auditoría.

GET /api/rpc/completados

Un registro se mueve de Pendientes a Completados en el momento en que se registra el retorno y cantidadRetornada >= cantidadEntregada. Si el retorno es parcial, el registro permanece en Pendientes.

---

Resumen KPI

GET /api/rpc/resumen

Respuesta:

{
  "data": {
    "total_registradas": 120,
    "total_pendientes": 35,
    "total_completadas": 85,
    "total_entregado": 4800,
    "total_retornado": 4210,
    "total_faltante": 590
  }
}

Campo	Descripción
total_registradas	Total de movimientos RPC en el sistema.
total_pendientes	Movimientos con retorno sin confirmar.
total_completadas	Movimientos con retorno confirmado.
total_entregado	Suma de todas las unidades enviadas.
total_retornado	Suma de todas las unidades devueltas.
total_faltante	Diferencia entre entregado y retornado (faltante = entregado − retornado).

---

Registrar un retorno

Cuando los contenedores regresan físicamente al almacén, el operador confirma la cantidad recibida:

PUT /api/rpc/retorno/{idRpc}?cantidadRetornada={cantidad}

Ejemplo:

PUT /api/rpc/retorno/1?cantidadRetornada=50

Respuesta:

{
  "data": {
    "idRpc": 1,
    "numeroCamion": "CAM-0042",
    "departamento": "FRUTAS",
    "tipoRpc": "TIPO1",
    "cantidadEntregada": 50,
    "cantidadRetornada": 50,
    "fechaRegistro": "2026-04-07",
    "pendienteRetorno": false
  }
}

La cantidadRetornada debe estar entre 0 y cantidadEntregada. Un valor fuera de ese rango provoca un error 400.

Si la cantidad retornada es menor a la entregada, pendienteRetorno permanece en true y el registro sigue en la Bandeja 1 hasta que se complete el retorno restante.

---

Flujo de trabajo

1. Registrar la entrega

   Al salir el camión, registra un nuevo RPC indicando el número de camión, tipo de contenedor y cantidad entregada. El sistema marca pendienteRetorno = true y asigna la fecha actual.

2. Consultar pendientes

   Accede a GET /api/rpc/pendientes (Bandeja 1) para ver qué camiones tienen RPC sin devolver. Esta vista es el punto de control diario del almacén.

3. Confirmar el retorno físico

   Cuando el camión devuelve los contenedores, llama a PUT /api/rpc/retorno/{idRpc}?cantidadRetornada={n} con la cantidad física contada.

4. Verificar en completados

   El registro pasa automáticamente a la Bandeja 2 (GET /api/rpc/completados) y queda disponible para auditoría histórica.

5. Revisar el resumen KPI

   Consulta GET /api/rpc/resumen para obtener los totales globales y detectar faltantes acumulados entre entregas y retornos.