Inventário / Auditoria de Estoque

Esta integração trabalha nas duas direções com o módulo de Inventário do RuB:

• ERP -> RuB (Job Auditoria de estoque): consulta no RPInfo as auditorias de estoque pendentes e cria automaticamente inventários no RuB para os produtos solicitados.
• RuB -> ERP (Writer inventario_rpinfo): exporta os resultados das contagens de inventário finalizadas no RuB para o RPInfo, visando a atualização de saldos e a auditoria de estoque.

Identificação no RuB

Endpoints da API RPInfo utilizados:

Identificador da Unidade

Tanto o Job quanto o Writer identificam a loja no RPInfo conforme a configuração rpinfoIdentificadorUnidadeInventario:

Atenção: se a loja não possuir o identificador configurado (ex.: CNPJ não preenchido), o Job e o Writer geram erro de loja inválida para essa loja.

1. Auditoria de Estoque (ERP -> RuB)

O job Auditoria de estoque é executado por loja e transforma as auditorias solicitadas no RPInfo em inventários no RuB, prontos para contagem.

Funcionamento Geral

1. Calcula a janela de consulta: data inicial = hoje - rpinfoInventarioDiasRetroativos e data final = hoje + rpinfoInventarioDiasFuturos.
2. Lê o último código processado da loja (lastId, entidade AUDITORIA_ESTOQUE em rpinfo_controle; inicia em 0).
3. Consulta no RPInfo as auditorias pendentes a partir do lastId, de forma paginada (repete a consulta enquanto o lastId avançar).
4. Ignora os itens cuja chave {idLoja}_{codigo} já exista em rpinfo_processado.
5. Localiza cada produto (codigoProduto) na loja. Produtos não encontrados no RuB geram um warning no log e são ignorados (não são marcados como processados).
6. Cria um inventário para a execução (os produtos das demais páginas são adicionados ao mesmo inventário), associando o tipo de inventário padrão configurado.
7. Marca cada auditoria como processada em rpinfo_processado e avança o lastId em rpinfo_controle.

Fluxo de Execução

graph TD
    A["Job Auditoria de estoque (por loja)"] --> B["Resolver identificador da unidade"]
    B --> C["Calcular janela (dias retroativos / futuros)"]
    C --> D["GET /v1.1/produtounidade/auditoriaestoque/{lastId}/datainicial/{ini}/datafinal/{fim}"]
    D --> E{"Há auditorias?"}
    E -- "Não" --> Z[("Fim")]
    E -- "Sim" --> F{"Já processada? (rpinfo_processado)"}
    F -- "Sim" --> D
    F -- "Não" --> G{"Produto existe no RuB?"}
    G -- "Não" --> H["Registrar warning e ignorar"]
    G -- "Sim" --> I["Criar inventário AUD-{sequence} ou adicionar produtos ao inventário da execução"]
    H --> D
    I --> J["Marcar como processada e salvar lastId"]
    J --> D

Inventário Criado no RuB

2. Envio da Contagem (RuB -> ERP)

Funcionamento Geral

1. O processo é iniciado após a conclusão de todas as etapas de contagem e finalização do inventário no RuB.
2. O sistema resolve o depósito (idEstoque) no ERP com base no tipo do inventário.
3. O envio ocorre conforme a versão do endpoint configurada em rpinfoVersaoEndPointInventario:

Fluxo de Execução

graph TD
    A["Finalização de Inventário no RuB"] --> B["Identificar Tipo de Inventário"]
    B --> C["Resolver Depósito ERP (idEstoqueParaOTipoInventario{ID} ou default; padrão 1)"]
    C --> D{"Versão do endpoint (rpinfoVersaoEndPointInventario)"}
    D -- "v1.3" --> E["Montar lote INV-{idInventario}-{unidade}"]
    E --> F["POST /v1.3/produtounidade/auditoriaestoque"]
    F --> G["Recibo retornado pelo RPInfo"]
    D -- "v1.1" --> H["Agrupar Produtos em Pacotes (rpinfoQtdProdutosInventario)"]
    H --> I["POST /v1.1/produtounidade/auditoriaestoque (por pacote)"]
    G --> J[("ERP RPInfo - Auditoria de Estoque / Saldos")]
    I --> J

Origem dos Dados no RuB

Os dados são extraídos do módulo de Inventário:

• Processo: Finalização de inventário.
• Entidade: Inventario e InventarioProduto.

Detalhamento dos Campos de cada Auditoria (JSON)

Cabeçalho do lote (somente v1.3):

Configurações Avançadas e Aplicação

Acesse no RuB em Configurações > Configurações Avançadas > Integração > RPInfo:

Banco de Dados

• rpinfo_controle: guarda o lastId da entidade AUDITORIA_ESTOQUE por loja.
• rpinfo_processado: guarda a chave {idLoja}_{codigo} das auditorias já transformadas em inventário (evita duplicidade).
• Sequence SEQ_RPINFO_INVENTARIO: gera o número do código AUD-{número} dos inventários criados pelo job. É criada pelo script de atualização update_005 (versão 5 do banco do módulo) - garanta que a atualização foi aplicada antes de ativar o job.

Ativação

1. Envio de contagem (RuB -> ERP): em Configurações > Inventário, selecione a interface RPInfo.
2. Auditoria de estoque (ERP -> RuB): em Configurações > Agenda de Execuções, crie/ative o gatilho do job Auditoria de estoque (grupo RPInfo) com a periodicidade desejada. O job não possui gatilho padrão.