Guia de Implantação

Este documento serve como ponto central de referência 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 definem os parâmetros essenciais de conectividade e autenticação com o ERP RPInfo para todos os serviços integrados:

Nome Amigável (Chave)	Descrição	Exemplo / Padrão
URL (`rpinfoUrl`)	URL base da API REST do RPInfo	`http://servidor:9975/`
Usuário (`rpinfoUser`)	Usuário para autenticação HTTP Basic	`integracao_rub`
Senha (`rpinfoPassword`)	Senha de autenticação	`*******`
Quantidade de Threads (`rpinfoQtdThreads`)	Quantidade de threads para processamento paralelo	`5`

Nota: As configurações e regras de negócio específicas de cada operação (produtos, vendas, movimentos, etiquetas, avarias, etc.) encontram-se detalhadas nas respectivas seções nos links abaixo.

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).
Produto Empresa - Sincronização do cadastro global de produtos da rede.
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.

Agenda de Execuções (Jobs Agendados)

Acesse no RuB em Configurações > Agenda de Execuções para configurar o agendamento dos jobs conforme a periodicidade necessária:

Nome na Agenda de Execuções	Grupo	Chave do Job	Descrição
`Produto`	`RPInfo`	`rpinfoPRODUTO`	Sincroniza produtos, preços e saldos por unidade/loja (v2.9 ou v3.2).
`Produto Empresa`	`RPInfo`	`rpinfoPRODUTO_EMPRESA`	Sincroniza o cadastro global corporativo de produtos da rede.
`Venda`	`RPInfo`	`rpinfoVENDA`	Importação de cupons de venda online em tempo real.
`Descontos`	`RPInfo`	`rpinfoDESCONTOS`	Processamento de preços promocionais e descontos.
`Movimento`	`RPInfo`	`rpinfoMOVIMENTO`	Importação de movimentações de estoque (compras/vendas/outras).
`Classe de Produto`	`RPInfo`	`rpinfoCLASSE_PRODUTO`	Atualização da árvore mercadológica de classes de produto.
`Fornecedor`	`RPInfo`	`rpinfoFORNECEDOR`	Carga incremental do cadastro de fornecedores.
`Validade`	`RPInfo`	`rpinfoVALIDADE`	Importação de datas de validade capturadas no recebimento de mercadorias.
`Cesta Básica`	`RPInfo`	`rpinfoCESTA_BASICA`	Carga de kits e composições de cestas básicas.
`Manutenção`	`RPInfo`	`rpinfoMANUTENCAO_RPINFO`	Limpeza periódica dos registros de controle de processamento (tabela `rpinfo_processado`).

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 o lastId ou dataHora de 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.
rpinfo_classe_ignorada: Mapeamento de classes de produtos a serem ignoradas na sincronização.

Monitoramento e Troubleshooting

Logs do Sistema: Verifique os logs do RuB buscando pelo identificador [RPInfo] ou pela chave payload.produto.enabled / rpinfo.payload.
API: O arquivo modules/rpinfo/src/main/http/rpinfo.http contém exemplos de autenticação, produtos, fornecedores, movimentos, vendas, validade, inventário e etiquetas. Use uma URL e credenciais de ambiente de teste; nunca copie tokens ou senhas para a documentação.
Manutenção de Logs:

::: destaque O job MANUTENCAO_RPINFO deve estar agendado para evitar o crescimento excessivo da tabela de controle rpinfo_processado.