Integração de ERP: conectar o ERP com o resto do negócio
01 / Integração · ERP
O ERP costuma ser o sistema com mais verdade da empresa e com menos conexões. Todo mundo consulta, quase ninguém pode escrever nele, e por isso cresce à volta dele uma camada de planilhas que funciona como cola.
Como isso se reconhece de fora
O sinal é sempre o mesmo: alguém exporta um CSV do ERP toda manhã. Às vezes são duas pessoas e dois CSV diferentes. Esse arquivo é uma integração — só que quem executa é um humano, nunca falha de forma visível e ninguém sabe o que acontece no dia em que essa pessoa entra de licença.
Por quê
Por que trocar de ERP não resolve
A proposta habitual do mercado é migrar para um ERP moderno que “já vem integrado”. O problema é que um ERP com anos de uso não é um programa: é a lógica real do negócio, com suas exceções, seus descontos estranhos e seus fluxos que ninguém documentou. Migrar significa redescobrir tudo isso sob pressão e com a operação rodando. Quando o ERP funciona e o que falta é apenas que ele converse com os demais sistemas, construir essa camada de conexão custa uma fração e não coloca em risco o faturamento do mês que vem.
Fluxos
Os fluxos que precisam ser resolvidos
Cada um com a decisão de projeto que define se aguenta produção.
- 01
Pedido de entrada rumo ao ERP
O pedido nasce fora — loja online, PDV, marketplace, vendedor com o celular — e precisa chegar ao ERP uma única vez, com suas linhas, seus impostos e seu cliente corretamente resolvido.
Onde quebra
Sem uma chave de idempotência baseada na referência externa, uma retentativa cria o pedido duas vezes. É a falha mais comum e a mais cara de desfazer.
- 02
Estoque do ERP rumo aos canais de venda
O dado de existências vive no ERP e é necessário no site, no marketplace e na loja. A pergunta de desenho não é como copiá-lo, é com quanto atraso isso é aceitável e o que fazer com o estoque reservado e não confirmado.
Onde quebra
Publicar o estoque real sem reserva provoca sobrevenda em campanha. Publicar um estoque conservador deixa dinheiro em cima da mesa. É uma decisão de negócio disfarçada de decisão técnica.
- 03
Faturamento e conciliação de cobrança
Do pedido à nota fiscal e do recebimento à conciliação. É aqui que o ERP toca o gateway de pagamento, o extrato bancário e as baixas de título. O desenho tem de dizer qual sistema declara um pagamento como recebido e com que identificador — o do gateway, o da nota ou o do lançamento bancário.
Onde quebra
Sem um identificador estável por transação, o mesmo pagamento entra duas vezes e o cliente aparece com crédito que não existe. A variante silenciosa é pior: a conciliação vai desviando poucos reais por dia, ninguém percebe durante meses e o fechamento só bate depois de um ajuste manual que já virou rotina.
- 04
Relatórios sem tocar em produção
Os relatórios são construídos contra uma réplica de banco ou um armazém analítico, nunca contra a base de dados que atende a operação.
Onde quebra
Uma consulta pesada disparada contra o banco de produção às onze da manhã trava o faturamento. Acontece mais do que se conta.
Entrega
O que você recebe
- Mapa de fluxos de dados entre o ERP e cada sistema conectado
- Conectores com fila, retentativa e idempotência por operação
- Contrato de dados por fluxo: que campos, quem manda, o que acontece em conflito
- Painel de estado com alarme por antiguidade de pendentes
- Documentação da integração e passagem para a equipe interna
Princípios
Como construímos
Idempotência por padrão
Toda operação pode ser repetida sem duplicar nada. É o que permite reprocessar sem medo, e sem isso nenhuma integração sobrevive à primeira queda de rede.
Estado observável
Cada mensagem tem estado consultável: pendente, enviada, confirmada, falhada. Uma integração que só aparece quando falha já tinha falhado antes.
Um único dono por dado
Para cada campo há um sistema que manda e os outros obedecem. Sincronização bidirecional sem essa regra termina em loops e em dados que mudam sozinhos.
IA onde se decide, não onde se calcula
Classificar, extrair e redigir são tarefas de modelo. Somar, validar e encaminhar são tarefas de código. Trocar isso de lugar sai caro e fica impossível de auditar.
Método
Como abordamos o problema
Quem diagnostica é quem constrói, sem hand-offs pelo caminho. O método completo e o resto das capacidades estão na página de integração de sistemas.
- 01 · 3–5 dias
Diagnóstico
Mapeamos sistemas, fluxos de dados e dependências reais, inclusive as que ninguém documentou. Saída: escopo fechado e a lista do que hoje está quebrado.
- 02 · 1 semana
Desenho da integração
Contratos de dados, direção da sincronização, política de retentativas e quem é dono de cada campo. Decide-se antes de escrever código porque é o caro de mudar depois.
- 03 · 2–6 semanas
Implementação e testes
Construção com a casuística real, não com o caminho feliz. Testes contra os sistemas de verdade e implantação em fases.
- 04 · contínuo
Produção e observabilidade
Painel de estado, alarmes quando algo passa tempo demais sem confirmação e manutenção das integrações quando as APIs de terceiros mudam.
- Node / TypeScript
- Filas com retentativa
- Supabase / PostgreSQL
- n8n
- Webhooks assinados
- LangChain
- Docker
- Vercel
Relacionado
Relacionado a este caso
O que costuma vir antes ou depois, com o motivo do link.
Radiografia Digital
Quando não está claro quantos sistemas existem nem quais conversam entre si, o diagnóstico vem antes do conector.
02Sistemas legados
Se o ERP não expõe API e só há acesso ao banco de dados, o padrão muda.
03APIs e webhooks
A mecânica de como o ERP se conecta: fila, retentativa, idempotência e assinatura. É o que fica por baixo de qualquer conector.
04Arquitetura tecnológica
Se além do ERP há três sistemas mais discutindo os mesmos dados, a decisão é de arquitetura antes de ser de integração.
Perguntas
Perguntas deste caso
É preciso ter API no ERP para integrá-lo?
Ajuda muito, mas não é indispensável. Por ordem de preferência: API documentada, eventos ou webhooks, acesso somente leitura ao banco de dados e arquivos de intercâmbio. Cada degrau acrescenta trabalho e fragilidade, e o último exige combinar uma janela de processamento. Indispensável mesmo é existir alguma via de escrita controlada: se o ERP é uma caixa fechada sem ponto de entrada, a integração vira um projeto com o fornecedor, não conosco.
Vocês vão mexer no banco de dados do ERP?
Somente leitura, e de preferência sobre uma réplica. Escrever direto nas tabelas de um ERP pula suas validações internas e produz dados que a própria aplicação não sabe interpretar. Quando não há API de escrita, a conversa correta é com o fornecedor do ERP, e não um INSERT na mão.
Quanto tempo leva uma integração de ERP?
Entre três e oito semanas contando o diagnóstico, conforme quantos fluxos entram no escopo e o quanto o ERP é acessível. O que alonga os projetos quase nunca é o conector: são as exceções de negócio que aparecem ao olhar os dados reais — o cliente que fatura para outra razão social, o desconto aplicado na mão, o pedido que se divide em duas notas de entrega.
E se no ano que vem trocarmos de ERP?
Então convém desenhar a integração com essa hipótese em cima da mesa. Uma camada de conectores com contratos de dados explícitos sobrevive muito melhor a uma troca de ERP do que um monte de automações acopladas aos nomes das tabelas atuais. Não sai de graça, mas é a diferença entre refazer uma peça e refazer tudo.
Seu próximo projeto
Comece pelo diagnóstico
Três a cinco dias para saber o que se conecta primeiro, com escopo e preço fechados antes de escrever uma linha de código.
Falar com um especialista