Guia de Implantação - Integração BlueSoft
Este documento serve como ponto central para a configuração e implantação da integração entre o RuB e o ERP BlueSoft.
1. Configurações Gerais de Conexão
Acesse o RuB em Configurações > Configurações Avançadas > Integração > BlueSoft. 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 |
|---|---|---|
| Identificador do Tenant (bluesoftTenant) | Código da Loja/Tenant na BlueSoft | nome_da_empresa |
| Client ID (bluesoftClientId) | Identificador para autenticação OAuth2 | ******** |
| Client Secret (bluesoftClientSecret) | Chave secreta para autenticação OAuth2 | ******** |
| Quantidade de Threads (bluesoftQtdThreads) | Threads simultâneas para processamento | 5 |
| Tamanho da Página (bluesoftTamanhoPagina) | Registros por página nas requisições | 50 |
Opções de comportamento
| Chave | Tipo | Padrão | Efeito |
|---|---|---|---|
bluesoftIgnorarDepartamento | booleano | false | Ignora o nível Departamento ao processar a classe de produto. |
bluesoftProdutoComoCadeia | booleano | true | Trata o produto como cadeia quando não há preço de referência. |
bluesoftCaixaApenasPDV | booleano | true | Habilita o parâmetro exportaPdv ao consultar caixas. |
bluesoftIgnorarErroValidade | booleano | false | Permite que o job VALIDADE ignore erros de processamento. |
bluesoftTamanhoPagina aceita valores de 1 a 100, e bluesoftQtdThreads aceita de 1 a 20. Os campos bluesoftTenant, bluesoftClientId e bluesoftClientSecret não possuem valor padrão e devem ser preenchidos pelo ambiente.
Autenticação, paginação e horários
A autenticação usa OAuth2 com bluesoftClientId e bluesoftClientSecret no tenant configurado. As consultas são paginadas por bluesoftTamanhoPagina, usando até bluesoftQtdThreads threads. Em caso de erro de autenticação, valide as credenciais e o tenant antes de reprocessar. Confira também a conversão entre UTC e horário de Brasília nos logs, identificados pelo prefixo [BlueSoft].
2. Documentação por Integração
Para detalhes específicos de cada entidade sincronizada, consulte os documentos abaixo:
Carga de Dados (ERP -> RuB)
- Produto e Caixa - Cadastro de itens, embalagens e caixas.
- Preço - Sincronização de preços de venda e ofertas.
- Estoque - Saldos de estoque e custos.
- Venda - Importação de cupons de venda online.
- Movimento - Movimentações analíticas de estoque.
- Classe de Produto - Árvore mercadológica.
- Fornecedor - Cadastro de fornecedores e fabricantes.
- Validade - Validade de produtos por lote.
- Inventário (Carga) - Importação de inventários para contagem.
- Recebimento (Carga) - Cargas de recebimento pendentes.
- Informações de Medida - Propriedades extras de pesos e medidas.
Retorno de Dados (RuB -> ERP)
- Inventário (Retorno) - Envio dos resultados de contagem.
- Recebimento (Retorno) - Confirmação de conferência de carga.
3. Configuração de Jobs (Agendamentos)
Os jobs devem ser agendados no RuB conforme a necessidade de atualização.
| Job | Descrição |
|---|---|
PRODUTO | Cadastro de Produtos |
CAIXA | Cadastro de Embalagens de Caixa |
PRECO | Preços e Ofertas |
ESTOQUE | Saldos de Estoque |
VENDA | Vendas Online |
MOVIMENTO | Movimentações de Estoque |
CLASSE_PRODUTO | Estrutura Mercadológica |
FORNECEDOR | Fornecedores e Fabricantes |
VALIDADE | Validade de Produtos |
INVENTARIO | Carga de Inventários |
RECEBIMENTO | Carga de Recebimentos |
INFOS_MEDIDA | Propriedades de Medida |
4. Banco de Dados
A integração utiliza tabelas específicas para controle e de-para. Os scripts SQL estão em:
modules/bluesoft/src/main/resources/database/bluesoft/
Tabelas Principais:
bluesoft_controle: Armazena a data da última sincronização por entidade.bluesoft_produto_depara: Mapeamento entre códigos de produtos e embalagens.bluesoft_promocao: Controle de promoções processadas.
5. Monitoramento e Troubleshooting
- Autenticação: ::: destaque A integração utiliza OAuth2. Certifique-se de que as chaves
ClientIdeClientSecretsão válidas. ::: - Logs: Verifique os logs do RuB buscando pelo prefixo
[BlueSoft]. - Fuso Horário: ::: destaque As APIs da BlueSoft geralmente utilizam horários em UTC ou Brasília. O RuB trata a conversão automaticamente. :::