PortuguêsSAP Business OneEnglish version

SAP Business One

IA para SAP Business One no Brasil: dados fiscais e operacionais sob controle

Resposta curta

No SAP Business One brasileiro, a IA precisa conhecer tanto o modelo padrão (OINV, ORDR, OITM, OWOR) quanto os campos e documentos da localização fiscal. Com leitura por SQL ou Service Layer, modelo local e aprovação humana para escrita, é possível consultar vendas, estoque e produção em português. Para relatórios fixos, o Crystal Reports e o Query Manager seguem sendo suficientes.

O SAP Business One é usado por pequenas e médias indústrias e distribuidoras no Brasil, geralmente com apoio de um parceiro SAP que cuida da localização fiscal, da NF-e e das obrigações acessórias. Isso torna o ambiente diferente do B1 de outros países: há documentos, campos de usuário e regras tributárias que o padrão da SAP não traz sozinho.

Quem opera o B1 sabe que muitas respostas vivem em consultas salvas no Query Manager ou em relatórios do Crystal. Cada pergunta nova depende de alguém que conheça as tabelas. Uma camada de IA bem feita aproxima o usuário do dado sem tirar o controle da TI.

A Netray constrói IA privada sobre ERP, com modelos de pesos abertos rodando no ambiente do cliente. Nas implantações de B1, trabalhamos junto com o parceiro SAP responsável pela localização.

O modelo de dados do B1 e o que a localização muda

O banco do Business One, em SQL Server ou SAP HANA, tem tabelas conhecidas: OITM (itens), OCRD (parceiros de negócio), ORDR e OINV (pedidos e notas de venda), OPOR e OPCH (compras), OWOR (ordens de produção), OWHS (depósitos), OITW (saldo por depósito). Linhas ficam em tabelas como RDR1, INV1 e WOR1.

No Brasil, a localização acrescenta campos próprios, como dados de NF-e, CFOP, NCM, usos principais e códigos de imposto, além de documentos específicos. A forma exata varia conforme a versão e o parceiro que fornece a localização. Por isso o mapeamento do esquema real do cliente é a primeira atividade do projeto, e não uma suposição.

Campos definidos pelo usuário, que começam com U_, são comuns e frequentemente carregam regras de negócio importantes. Entrar na camada semântica é parte do trabalho.

Casos de uso

No dia a dia comercial, a IA responde perguntas como: quais pedidos estão liberados mas não faturados, quais clientes têm notas vencidas e novos pedidos em aberto, qual a margem por linha de produto no trimestre. Em estoque e produção, aponta itens abaixo do mínimo, ordens de produção atrasadas e falta de componentes para o MRP planejado.

Para o fiscal, é útil na conferência: notas com divergência de CFOP, itens sem NCM, documentos pendentes de autorização. Mas a validação tributária continua nas regras da localização e no contador; a IA aponta, não decide.

  • Vendas: pedidos liberados e não faturados, carteira por cliente, margem por produto.
  • Estoque: saldo por depósito, itens críticos, divergências entre OITW e movimentos.
  • Produção: ordens atrasadas, consumo real contra previsto, falta de componentes.
  • Financeiro: contas a receber vencidas, aging, previsão de recebimento.
  • Fiscal: itens sem NCM, notas com CFOP inconsistente, pendências antes do fechamento.

Como conectar: SQL, Service Layer e permissões

Há dois caminhos de leitura. O primeiro é SQL somente leitura sobre o banco, ou sobre uma réplica, o que dá flexibilidade total para perguntas livres. O segundo é o Service Layer, a API REST do B1, que respeita a camada de negócio e é mais adequado quando se quer evitar acesso direto ao banco, com menor flexibilidade em consultas complexas.

Para escrita, recomendamos o Service Layer ou a DI API, nunca atualização direta de tabelas, porque apenas essas interfaces executam as validações e gravam os lançamentos contábeis corretamente. Toda escrita passa por aprovação humana antes de ser enviada.

As autorizações do B1 devem ser respeitadas. Como o SQL direto ignora o modelo de permissões do aplicativo, a camada de IA reimplementa as restrições por perfil (por exemplo, filtro por vendedor ou por filial) antes de executar a consulta.

Arquitetura privada e LGPD

O modelo de linguagem roda dentro da empresa, com vLLM ou Ollama, em servidores próprios ou em nuvem privada no Brasil. Os dados de clientes, notas e preços não precisam sair desse perímetro. Para documentos como contratos e procedimentos, usamos um índice vetorial local.

Com isso, a empresa evita enviar dados pessoais de clientes e fornecedores a um provedor no exterior, o que simplifica a análise do art. 33 da LGPD. Recomendamos ainda registrar perguntas e consultas geradas, mascarar CPF e contatos quando a resposta não os exige e limitar a retenção dos logs.

Não afirmamos certificações em nome do cliente. A arquitetura facilita demonstrar as medidas que a empresa adota para cumprir a lei.

Como começar

Propomos uma avaliação curta, em que mapeamos a versão do B1, o banco (SQL Server ou HANA), a origem da localização fiscal, os campos de usuário relevantes e as perguntas que mais geram demanda para a TI. Em seguida, um piloto de leitura sobre uma réplica, com um tema único, como vendas ou estoque.

A medida de sucesso é simples: respostas conferidas contra relatórios já aceitos, tempo de resposta menor que o do pedido manual e consultas auditáveis.

Quando não é necessário

Para um conjunto pequeno de indicadores fixos, Query Manager, Crystal Reports ou os painéis do próprio B1 resolvem melhor. Também vale avaliar primeiro as capacidades de IA que a SAP oferece em seu portfólio, caso atendam ao seu caso.

A solução da Netray tende a fazer sentido quando se deseja manter o modelo sob controle da empresa, cruzar o B1 com outras fontes (planilhas, MES, documentos) ou construir agentes sob medida para a operação.

Perguntas frequentes

Funciona com B1 em SQL Server e em HANA?

Sim. A abordagem é a mesma, com ajustes de dialeto SQL. O Service Layer também está disponível nos dois casos.

A IA entende os campos da localização brasileira?

Só depois de mapear o esquema real do cliente, incluindo campos de usuário e documentos da localização. Esse mapeamento é a primeira etapa do projeto e é feito junto com o parceiro SAP.

É seguro escrever no B1 por meio da IA?

Por padrão a solução é somente leitura. Se houver escrita, ela usa Service Layer ou DI API, com aprovação humana, e nunca atualização direta de tabelas.

Meus dados fiscais saem do Brasil?

Não precisam. O modelo roda nos seus servidores ou em nuvem privada no Brasil, e a consulta é feita dentro da sua rede.

Preciso trocar de parceiro SAP?

Não. Trabalhamos com o seu parceiro atual, que continua responsável pela localização e pelo suporte do B1.

Leve a IA para o seu ERP

Agende uma avaliação gratuita de IA para ERP. Mapeamos o fluxo de dados, o modelo e onde ele roda, e dizemos com franqueza se a IA não for a ferramenta certa.

Agendar avaliação gratuita