Integração com ERP: o BI lê o que o fiscal gravou

Integração com ERP leva pedido, nota e estoque como o fiscal e a operação gravaram. O BI não inventa uma receita para o gráfico fechar. Quando o número diverge, a divergência tem nome, dono e um lugar para se resolver.
Atalho de “ajustar no ETL” para bater com a apresentação cria uma terceira contabilidade. Ela não fecha com o fiscal, não fecha com o comercial e ninguém sabe qual regra valeu no mês passado. O desenho certo lê o documento e deixa o ajuste explícito.

Qual documento é a fonte, por assunto?
Receita faturada nasce da nota, não do pedido em aberto. Pedido em carteira nasce do pedido, com o status que o ERP considera válido. Estoque nasce da posição que a expedição usa para separar. Cada assunto tem um documento. Usar o mais conveniente do dia é como não ter fonte.
Escreva o status que entra e o que fica fora. Pedido cancelado, nota denegada e item de bonificação ou entram com nome próprio, ou ficam de fora por regra assinada. O silêncio vira discussão na primeira reunião de meta.
O que a integração pode transformar, e o que não pode?
Pode padronizar fuso, chave e nome de campo. Pode excluir o que a regra assinada manda excluir, deixando a regra visível. Não pode recalcular imposto, redistribuir desconto ou mudar o centro de custo para o número “fazer sentido” no dashboard.
Se a apresentação precisa de uma visão diferente, essa visão é uma métrica com nome, não uma alteração do documento. A nota original continua consultável. Quem compara BI e ERP acha o mesmo valor na fonte e entende a ponte, se houver, pelo nome da métrica.
| Assunto | Documento fonte | Não usar como fonte |
|---|---|---|
| Receita faturada | Nota autorizada | Pedido ainda não faturado |
| Carteira | Pedido com status válido | Nota, que já saiu da carteira |
| Estoque disponível | Posição que a expedição separa | Planilha de contagem paralela |
| Devolução | Documento de devolução | Ajuste manual no BI |
Como a carga acompanha o fechamento?
O ERP tem horário de corte: nota da manhã, estoque do fim do turno, fechamento do mês. A carga respeita esse corte e publica o instante a que se refere. Carga “contínua” sem dizer o corte faz a reunião somar um dia pela metade.
Reprocessar um dia é normal, porque o ERP corrige documento. O reprocessamento substitui aquele dia pela leitura nova e registra que houve releitura. Não soma por cima. A chave do documento impede a nota de aparecer duas vezes quando a carga repete.
Onde a divergência se resolve?
Uma checagem simples, todo dia, compara contagem e soma do BI com um relatório de controle do ERP, o mesmo que o fiscal já acredita. A diferença acima do tolerado abre um item com o documento, não com uma sensação de que “o número está estranho”.
O dono da diferença é de negócio quando a regra está ambígua, e de integração quando o documento não chegou. Os dois olham o mesmo item. Ajustar a soma no BI para zerar a diferença apaga o sintoma e deixa o documento errado no lugar.
Como mudança de versão do ERP não vira surpresa?
Campo novo, status novo e nota de um tipo novo quebram a carga ou, pior, passam zerados. A integração tem checagem de formato antes de publicar, e o calendário de atualização do ERP avisa quem mantém a carga. Atualizar o ERP na sexta e descobrir o dashboard na segunda é falha de combinado, não de ferramenta.
Ambiente de teste do ERP, quando existe, recebe uma carga de amostra antes da virada. Quando não existe, o primeiro dia útil depois da virada tem alguém olhando a reconciliação antes da reunião. A virada entra na agenda da integração.
Como começar sem integrar o ERP inteiro?
Comece pelo documento da métrica que a reunião já disputa, em geral nota de saída ou pedido. Deixe folha de pagamento, ativo e o resto do módulo para quando a primeira reconciliação estiver chata de tão estável. Integração larga demais não termina a checagem de nenhum documento.
Um exemplo: o comercial olha pedido e o financeiro olha nota, e os dois chamam de venda. A integração publica os dois, com nomes diferentes, e a receita oficial aponta para a nota autorizada, sem frete, como a controladoria assinou. O pedido continua visível como carteira. No dia em que uma nota é cancelada, a releitura daquele documento tira o valor da receita, e a checagem com o relatório fiscal fecha sem edição manual.
Checklist prático
A integração está saudável quando BI e relatório fiscal batem, e a diferença vira item com documento.
- Documento fonte por assunto, escrito, com status que entra e que fica fora
- Transformação limitada a chave, fuso e regra assinada
- Métrica de apresentação separada do documento, com nome
- Corte horário publicado junto com o número
- Reprocessamento que substitui o dia, sem somar a nota duas vezes
- Reconciliação diária contra um relatório de controle do ERP
- Checagem de formato antes de publicar, ligada ao calendário de versão
- Começo por um documento, não pelo módulo inteiro
Erros comuns
A terceira contabilidade nasce destes ajustes “só no BI”.
- Alterar imposto, desconto ou centro de custo no ETL para o gráfico fechar
- Usar pedido como receita faturada porque atualiza mais cedo
- Somar a carga de novo em vez de substituir o documento reprocessado
- Não publicar a que instante o número se refere
- Zerar divergência editando a soma, sem achar o documento
- Ignorar a janela de atualização do ERP
- Integrar todos os módulos antes de reconciliar o primeiro
- Chamar de venda, no mesmo nome, a carteira e a nota
Onde o documento entra na engenharia?
Em engenharia de dados, a integração com ERP preserva o documento. A métrica pode recortar. Ela não reescreve a nota.