Guia de Implantação - Integração RPInfo
Este documento serve como ponto central para a configuração e implantação da integração entre o RuB e o ERP RPInfo.
Configurações Gerais de Conexão
Acesse o RuB em Configurações > Configurações Avançadas > Integração > RPInfo. Estas configurações são obrigatórias para o funcionamento de qualquer módulo da integração.
| Nome Amigável (Chave) | Descrição | Exemplo / Padrão |
|---|---|---|
URL (rpinfoUrl) | URL base da API do RPInfo | http://servidor:9975/ |
Usuário (rpinfoUser) | Usuário de autenticação | integracao_rub |
Senha (rpinfoPassword) | Senha de autenticação | ******* |
Quantidade de Threads (rpinfoQtdThreads) | Threads simultâneas para processamento paralelo | 5 |
Documentação por Integração
Para detalhes específicos de cada entidade sincronizada, consulte os documentos abaixo:
Carga de Dados (ERP -> RuB)
- Produto - Sincronização de itens, preços, custos, estoques (com suporte ao endpoint v3.2).
- Venda - Importação de cupons de venda online.
- Desconto - Processamento de descontos e preços promocionais.
- Movimentação de Estoque - Movimentações de estoque (Compras, Vendas e Transferências).
- Classe de Produto - Estrutura mercadológica (Departamento/Seção/Grupo).
- Fornecedor - Cadastro de fornecedores.
- Validade - Validades capturadas no recebimento de mercadorias.
- Cesta Básica - Importação de kits e composições de cestas.
Retorno de Dados (RuB -> ERP)
- Avaria (MIP) - Envio de perdas e avarias.
- Inventário - Envio de resultados de contagem físico-auditada.
- Etiqueta - Solicitação de impressão de etiquetas de gôndola.
Configuração de Jobs (Agendamentos)
Os jobs devem ser agendados no RuB em Agendamentos conforme a frequência desejada de atualização:
| Job | Classe Java | Descrição |
|---|---|---|
PRODUTO | JobProduto | Sincroniza produtos, preços e saldos por unidade/loja (v2.9 ou v3.2). |
PRODUTO_EMPRESA | JobProdutoEmpresa | Sincroniza o cadastro global de produtos da rede. |
VENDA | JobVenda | Importação de cupons de venda online em tempo real. |
DESCONTOS | JobDescontos | Processamento de preços promocionais e descontos. |
MOVIMENTO | JobMovimento | Importação de movimentações de estoque. |
CLASSE_PRODUTO | JobClasseProduto | Atualização da árvore de classes de produto. |
FORNECEDOR | JobFornecedor | Carga incremental do cadastro de fornecedores. |
VALIDADE | JobValidade | Importação de datas de validade do recebimento. |
CESTA_BASICA | JobCestaBasica | Carga de kits e composições de cestas básicas. |
MANUTENCAO_RPINFO | JobManutencaoRPInfo | Limpeza periódica dos registros de controle de processamento. |
Banco de Dados
A integração utiliza tabelas específicas para controle e mapeamento de-para. Os scripts SQL estão localizados em:
modules/rpinfo/src/main/resources/database/rpinfo/
Tabelas Principais
rpinfo_controle: Armazena olastIdoudataHorade corte de cada entidade por loja.rpinfo_processado: Log de registros processados (limpo periodicamente pelo job de manutenção).rpinfo_produto_depara: Mapeamento manual de de-para de códigos entre RuB e RPInfo.
Monitoramento e Troubleshooting
- Logs do Sistema: Verifique os logs do RuB buscando pelo identificador
[RPInfo]ou pela chavepayload.produto.enabled/rpinfo.payload. - Manutenção de Logs:
O job MANUTENCAO_RPINFO deve estar agendado para evitar o crescimento excessivo da tabela de controle rpinfo_processado.