Integração de ERP: conectar o ERP com o resto do negócio
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.
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 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.
Os fluxos que precisam ser resolvidos
Cada um com a decisão de projeto que define se aguenta produção.
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.
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.
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.
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.
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.
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.
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.
Uma consulta pesada disparada contra o banco de produção às onze da manhã trava o faturamento. Acontece mais do que se conta.
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
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.
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 Diagnóstico · 3–5 dias
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 Desenho da integração · 1 semana
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 Implementação e testes · 2–6 semanas
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 Produção e observabilidade · contínuo
Painel de estado, alarmes quando algo passa tempo demais sem confirmação e manutenção das integrações quando as APIs de terceiros mudam.
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.
Ver →Sistemas legados
Se o ERP não expõe API e só há acesso ao banco de dados, o padrão muda.
Ver →APIs 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.
Ver →Arquitetura 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.
Ver →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.
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 ↗Outros casos