Início
26
Integração de Inventário e Auditoria de Estoque RPInfo

Integração de Inventário e Auditoria de Estoque RPInfo

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

Objetivo

Automatizar integralmente o processo de inventário físico e auditoria de estoque entre o RUB e o ERP RPInfo (Flex ONE) através de APIs REST oficiais, eliminando o preenchimento manual em planilhas, a digitação de saldos e a comunicação informal, garantindo celeridade operacional, exatidão nos estoques e consistência contábil imediata.

Contexto do Problema / Demanda

Anteriormente, o processo de inventário envolvia etapas manuais com alto atrito e propensão a discrepâncias:

As pendências de auditoria de estoque precisavam de acompanhamento e liberação manual;
As divergências eram apuradas de maneira tardia e com controle fragmentado em pranchetas e planilhas;
O fechamento da contagem exigia digitação manual dos saldos físicos no ERP ao final da rotina, consumindo tempo excessivo da equipe de prevenção e estoque e gerando risco de erros de digitação.

Para maximizar a produtividade das equipes em loja e a precisão do estoque, foi estabelecida uma esteira digital integrada, conectando o ERP RPInfo ao ecossistema de coletores móveis e retaguarda Web do RUB.

🎯 O que mudou e Principais Benefícios

Ingestão Automática de Pendências (ERP ➔ RUB): O novo Job agendado consulta periodicamente as auditorias pendentes no RPInfo e cria automaticamente lotes de inventário prontos para contagem no RUB.
Idempotência e Segurança Transacional: Controle de ponteiro via lastId e registro de chaves processadas na tabela rpinfo_processado, impedindo contagens duplicadas ou sobreposição de lotes.
Devolução Atômica e Consolidada (RUB ➔ ERP): Ao finalizar o inventário na Web, os saldos físicos apurados são devolvidos em lote único consolidado através do endpoint oficial POST /v1.3, com precisão decimal de três casas e sem particionamentos artificiais.
Comprovação e Rastreabilidade: Captura automática do recibo de confirmação gerado pelo RPInfo no campo content, garantindo auditoria ponta a ponta.
Parametrização Flexível: Controle de janelas de consulta retroativa/futura, tipo de inventário padrão e seleção de versões dos endpoints via Configurações Avançadas.

💻 Arquitetura da Solução e Fluxo Operacional

A integração opera de forma bidirecional e é dividida em dois eixos funcionais:

sequenceDiagram
    participant ERP as ERP RPInfo
(Flex ONE API)
    participant RUB as RUB Core
(Retaguarda / Mobile)

    ERP->>RUB: 1. Ingestão de Pendências (GET /v1.1)
    Note over RUB: Cria Inventário AUD-SEQ
    Note over RUB: Execução da Contagem
(Coletores Android)
    Note over RUB: Deliberação & Encerramento
(Interface Web)
    RUB->>ERP: 2. Devolução de Saldos Físicos (POST v1.3)
(Driver inventario_rpinfo)
    ERP-->>RUB: Recibo de confirmação (content)

1. Ingestão de Pendências de Auditoria (ERP ➔ RUB)

O novo Job agendado Auditoria de estoque (JobAuditoriaEstoqueRPInfo), registrado sob o grupo RPInfo com a chave rpinfoAuditoriaEstoque, realiza a varredura incremental de pendências de contagem:

Endpoint Consultado: GET /v1.1/produtounidade/auditoriaestoque/{lastID}/datainicial/{dataInicial}/datafinal/{dataFinal}?unidades={unidade}
Controle de Ponteiro: O último identificador processado (lastID) é armazenado na tabela rpinfo_controle para a chave AUDITORIA_ESTOQUE, por loja.
Filtro de Processamento: Cada item retornado é validado contra a tabela rpinfo_processado (ControleProcessado), assegurando que apenas novos itens sejam inseridos.
Padronização de Lotes: Criação de um inventário no RUB com status PENDENTE contendo a totalidade dos itens da rodada.
Código Padronizado: O código do inventário é gerado através da sequence SEQ_RPINFO_INVENTARIO no formato fixo AUD-{seq} (por exemplo: AUD-1001).
Descrição Configurável: Segue a regra definida pela configuração do sistema (ConfigInventario.UTILIZA_DESCRICAO_INVENTARIO_PADRAO), adotando {Tipo} - YYYY-MM-dd HH:mm:ss ou Auditoria de Estoque RPInfo - Filial {LOJA}.
Quantidade Esperada: O saldo teórico de referência é associado conforme as regras do módulo de inventário do RUB para permitir a apuração imediata de divergências na contagem.

2. Devolução e Ajuste de Saldos Físicos (RUB ➔ ERP)

Após as contagens no coletor móvel e a aprovação deliberada do fechamento pelo operador na interface Web do RUB, o driver de exportação inventario_rpinfo (RPInfoInventarioWriter) efetua a devolução dos dados:

Endpoint Oficial: POST /v1.3/produtounidade/auditoriaestoque
Envio Consolidado em Lote Único: A totalidade dos itens auditados é transmitida em uma única requisição estruturada, eliminando a fragmentação anterior em blocos de 30 SKUs.
Precisão e Integridade: Quantidades físicas transmitidas com 3 casas decimais, acompanhadas do carimbo de data/hora da leitura, indicador RUB e parâmetro acumular: false para substituição atômica e segura das posições contábeis.
Rastreabilidade e Recibo: O número de recibo retornado no atributo content da resposta do ERP é registrado nos logs do sistema em nível debug, comprovando a entrega do lote.

⚙️ Parâmetros e Configurações Avançadas

As parametrizações estão disponíveis no RUB em Configurações > Configurações Avançadas > Integração > RPInfo:

Parâmetro	Tipo	Padrão	Descrição
`rpinfoInventarioDiasRetroativos`	Inteiro	`1`	Quantidade de dias a subtrair da data atual para compor a data inicial do filtro de busca no ERP.
`rpinfoInventarioDiasFuturos`	Inteiro	`0`	Quantidade de dias a somar à data atual para compor a data final da janela de consulta no ERP.
`rpinfoInventarioTipoPadrao`	Inteiro	`1`	Identificador do Tipo de Inventário atribuído aos novos inventários instanciados pelo Job.
`rpinfoVersaoEndPointInventario`	Lista	`ENDPOINT_V1_3`	Versão do endpoint utilizada para exportação de saldos (`ENDPOINT_V1_3` como padrão oficial ou `ENDPOINT_V1_1` como contingência).
`rpinfoIdentificadorUnidadeInventario`	Lista	`CODIGO_LOJA`	Campo da loja no RUB enviado como identificador da unidade no RPInfo (ex.: Código da Loja, CNPJ sem formatação).
`rpinfoTamanhoMinimoIdentificadorUnidadeInventario`	Inteiro	`0`	Tamanho mínimo para preenchimento automático com zeros à esquerda no identificador da unidade.
`idEstoqueParaOTipoInventariodefault`	Inteiro	`1`	Código do depósito/local de estoque padrão no ERP RPInfo para movimentação de ajuste.

📋 Agendamento do Job

No menu Configurações > Agenda de Execuções, ative o Job de auditoria para sincronização contínua:

Nome do Job: Auditoria de estoque
Grupo: RPInfo
Chave de Execução: rpinfoAuditoriaEstoque

🛡️ Banco de Dados e Manutenção

Para assegurar a máxima eficiência do banco de dados ao longo do tempo:

Tabela rpinfo_controle: Armazena o ponteiro incremental (lastID) por loja com a chave AUDITORIA_ESTOQUE.
Tabela rpinfo_processado: Registra o histórico de itens integrados.
Manutenção Automatizada: Recomenda-se manter agendado o job Manutenção (rpinfoMANUTENCAO_RPINFO) para realizar a limpeza periódica de registros antigos de controle, preservando a performance do banco.

Destaques

Automação de Ponta a Ponta: Sincronização direta e contínua entre o ERP RPInfo (Flex ONE) e os coletores móveis RUB, dispensando digitação manual ou controles paralelos.
Processamento Atômico e Seguro: Lote consolidado em payload único via POST /v1.3 com captura de recibo no atributo content para auditoria.
Garantia de Idempotência: Bloqueio de duplicidades de inventários e itens via rpinfo_controle e rpinfo_processado.

Consulte a Documentação Técnica Completa da Integração RPInfo