Integración de Inventario y Auditoría de Stock RPInfo

• Data de publicação: 28 de octubre de 2026
• Versão necessária: Plugin RPInfo 11.261.497

Objetivo

Automatizar integralmente el proceso de inventario físico y auditoría de stock entre RUB y el ERP RPInfo (Flex ONE) a través de APIs REST oficiales, eliminando el llenado manual de planillas, la digitación de saldos y la comunicación informal, garantizando celeridad operativa, exactitud en los stocks y consistencia contable inmediata.

Contexto del Problema / Demanda

Anteriormente, el proceso de inventario involucraba etapas manuales con alta fricción y propensión a discrepancias:

• Los pendientes de auditoría de stock requerían seguimiento y liberación manual;
• Las divergencias se calculaban tardíamente y con control fragmentado en planillas físicas;
• El cierre del conteo exigía la digitación manual de los saldos físicos en el ERP al final de la jornada, consumiendo tiempo excesivo del equipo de prevención y stock con alto riesgo de errores de digitación.

Para maximizar la productividad de los equipos en tienda y la precisión del stock, se implementó un flujo digital integrado que conecta el ERP RPInfo con el ecosistema de colectores móviles y la interfaz Web de RUB.

🎯 Lo que cambió y Principales Beneficios

• Ingesta Automática de Pendientes (ERP ➔ RUB): El nuevo Job programado consulta periódicamente las auditorías pendientes en RPInfo y crea automáticamente lotes de inventario listos para conteo en RUB.
• Idempotencia y Seguridad Transaccional: Control de puntero mediante lastId y registro de claves procesadas en la tabla rpinfo_processado, evitando conteos duplicados o superposición de lotes.
• Devolución Atómica y Consolidada (RUB ➔ ERP): Al finalizar el inventario en la Web, los saldos físicos auditados se envían en un único lote consolidado a través del endpoint oficial POST /v1.3, con precisión decimal de tres dígitos y sin particionamientos artificiales.
• Comprobación y Trazabilidad: Captura automática del recibo de confirmación generado por RPInfo en el campo content, garantizando auditoría de punta a punta.
• Parametrización Flexible: Control de ventanas de consulta retroactiva/futura, tipo de inventario predeterminado y selección de versiones de endpoints mediante Configuraciones Avanzadas.

💻 Arquitectura de la Solución y Flujo Operativo

La integración opera de manera bidireccional y se divide en dos ejes funcionales:

sequenceDiagram
    participant ERP as ERP RPInfo
(Flex ONE API)
    participant RUB as RUB Core
(Retaguardia / Móvil)

    ERP->>RUB: 1. Ingesta de Pendientes (GET /v1.1)
    Note over RUB: Crea Inventario AUD-SEQ
    Note over RUB: Ejecución del Conteo
(Colectores Android)
    Note over RUB: Deliberación y Cierre
(Interfaz Web)
    RUB->>ERP: 2. Devolución de Saldos Físicos (POST v1.3)
(Driver inventario_rpinfo)
    ERP-->>RUB: Recibo de confirmación (content)

1. Ingesta de Pendientes de Auditoría (ERP ➔ RUB)

El nuevo Job programado Auditoria de estoque (JobAuditoriaEstoqueRPInfo), registrado bajo el grupo RPInfo con la clave rpinfoAuditoriaEstoque, realiza el escaneo incremental de pendientes de conteo:

• Endpoint Consultado: GET /v1.1/produtounidade/auditoriaestoque/{lastID}/datainicial/{dataInicial}/datafinal/{dataFinal}?unidades={unidade}
• Control de Puntero: El último identificador procesado (lastID) se almacena en la tabla rpinfo_controle para la clave AUDITORIA_ESTOQUE, por tienda.
• Filtro de Procesamiento: Cada ítem recibido se valida contra la tabla rpinfo_processado (ControleProcessado), asegurando que solo se ingresen ítems nuevos.
• Estandarización de Lotes: Creación de un inventario en RUB con estado PENDENTE con la totalidad de ítems de la ejecución.
• Código Estandarizado: El código de inventario se genera mediante la sequence SEQ_RPINFO_INVENTARIO en el formato fijo AUD-{seq} (por ejemplo: AUD-1001).
• Descripción Configurable: Respeta la configuración del sistema (ConfigInventario.UTILIZA_DESCRICAO_INVENTARIO_PADRAO), adoptando {Tipo} - YYYY-MM-dd HH:mm:ss o Auditoria de Estoque RPInfo - Filial {LOJA}.
• Cantidad Esperada: El saldo teórico de referencia se vincula según las reglas del módulo de inventario de RUB para permitir el cálculo inmediato de divergencias durante el conteo.

2. Devolución y Ajuste de Saldos Físicos (RUB ➔ ERP)

Tras los conteos en el colector móvil y la confirmación deliberada del cierre por parte del operador en la interfaz Web de RUB, el driver de exportación inventario_rpinfo (RPInfoInventarioWriter) realiza la devolución de los datos:

• Endpoint Oficial: POST /v1.3/produtounidade/auditoriaestoque
• Envío Consolidado en Lote Único: La totalidad de los ítems auditados se transmite en una sola solicitud estructurada, eliminando la fragmentación anterior en bloques de 30 SKUs.
• Precisión e Integridad: Cantidades físicas transmitidas con 3 decimales, acompañadas de la marca de tiempo de la lectura, identificador RUB y parámetro acumular: false para el reemplazo atómico y seguro de los saldos contables.
• Trazabilidad y Recibo: El número de recibo devuelto en el atributo content de la respuesta del ERP se registra en los logs del sistema en nivel debug, certificando la entrega del lote.

⚙️ Parámetros y Configuraciones Avanzadas

Las parametrizaciones se encuentran disponibles en RUB en Configuraciones > Configuraciones Avanzadas > Integración > RPInfo:

📋 Programación del Job

En el menú Configuraciones > Agenda de Ejecuciones, active el Job de auditoría para sincronización continua:

• Nombre del Job: Auditoria de estoque
• Grupo: RPInfo
• Clave de Ejecución: rpinfoAuditoriaEstoque

🛡️ Base de Datos y Mantenimiento

Para asegurar la máxima eficiencia de la base de datos a largo plazo:

• Tabla rpinfo_controle: Almacena el puntero incremental (lastID) por tienda bajo la clave AUDITORIA_ESTOQUE.
• Tabla rpinfo_processado: Registra el histórico de ítems integrados.
• Mantenimiento Automatizado: Se recomienda mantener programado el job Manutenção (rpinfoMANUTENCAO_RPINFO) para realizar la limpieza periódica de registros antiguos de control, preservando el rendimiento de la base de datos.

Destacados

• Automatización de Punta a Punta: Sincronización directa y continua entre el ERP RPInfo (Flex ONE) y los colectores móviles RUB, prescindiendo de digitación manual o planillas paralelas.
• Procesamiento Atómico y Seguro: Lote consolidado en payload único vía POST /v1.3 con captura de recibo en el atributo content para auditoría.
• Garantía de Idempotencia: Bloqueo de duplicidades de inventarios e ítems mediante rpinfo_controle y rpinfo_processado.