Integração ERP: APIs, middleware e o que costuma dar errado

O que é uma integração ERP e quando ela vale o custo?

A integração ERP liga o sistema de gestão da empresa à loja virtual, ao CRM, ao banco e ao emissor de nota. Segundo a pesquisa TIC Empresas 2025, do Cetic.br, 36% das empresas brasileiras com dez ou mais pessoas usaram pacotes de ERP nos 12 meses anteriores. Entre as de 50 a 249 pessoas, são 58%. Para quem já tem ERP, a pergunta passa a ser como ligá-lo ao resto sem quebrar nada. Este texto traz as formas de conectar, sete falhas que eu checaria primeiro e quando chamar ajuda de fora.

Uma integração ERP é uma rotina que move dados entre o ERP e outro sistema sem ninguém redigitar. O pedido entra na loja virtual e vira pedido no ERP. A nota emitida volta para o CRM.

Ela vale o custo em dois casos. No primeiro, a mesma informação é digitada duas vezes. No segundo, uma decisão espera por um número que alguém precisa conciliar na mão. Se nenhum dos dois acontece, não integre. Quem recebe dez pedidos por semana em um canal pode lançar na mão por muito tempo, e manter uma integração (monitorar e corrigir) é custo permanente.

Para estimar o ganho, multiplique as horas semanais de redigitação e conciliação pelo custo da hora. Esse é o teto do que a integração economiza, e a calculadora de economia faz a conta com as premissas escritas.

Com vários sistemas além do ERP, o texto sobre integração de sistemas cobre o quadro geral. O de sistema legado ajuda a decidir entre integrar e trocar.

Quais formas de integração ERP existem?

A forma mais comum é a API de integração: a porta que o fornecedor abre para outros sistemas lerem e gravarem dados no ERP. É o caminho preferido, mas a qualidade varia. Alguns ERPs expõem quase tudo, outros só cadastros e pedidos.

Os pares mais comuns são ERP com loja virtual ou marketplace (pedido e estoque), com banco (conciliação e boletos) e com emissor fiscal (NF-e). Bling, Omie, TOTVS e Sankhya publicam documentação de API; comece por ela.

ERP antigo e sem API ainda dá para integrar. Exportações agendadas, leitura do banco ou um serviço fino na frente do sistema costumam resolver sem trocar nada, como descrevemos na página de integração de dados e sistemas.

O que costuma dar errado na integração de API com o ERP?

A integração de API quebra por motivos que se repetem. Os sete abaixo são os que eu checaria primeiro, e os seis primeiros têm documento público por trás.

1. Limite de requisições

A API do Bling, por exemplo, permite 3 requisições por segundo e 120.000 por dia por conta. Passou disso, volta o erro 429 e as chamadas seguintes não são processadas. O limite vale para a conta inteira, não por endpoint, então um relatório pesado rodando no mesmo horário compete com a entrada de pedidos. A mesma página prevê bloqueio do IP de origem por 10 minutos depois de 300 erros em 10 segundos.

A documentação de webhooks do Bling chama a consulta periódica de menos eficiente que o webhook, porque gasta requisições sem dado novo. O limite é de cada ERP, então leia o do seu.

2. Gravar por cima do que já existe

Atualizar um cadastro pode apagar campos. A documentação de boas práticas do Bling é direta:

"O método PUT substitui o recurso por completo. Todos os campos que já possuem valor preenchido precisam ser informados no corpo da requisição, pois caso algum campo seja omitido será removido ou retornará ao valor padrão, sem possibilidade de recuperação."

Documentação do Bling para desenvolvedores, seção Boas práticas, consultada em 15/10/2026

Se a integração quer mudar só o preço e manda um PUT incompleto, a descrição curta e a marca somem. Use PATCH quando o endpoint tiver (nem todo tem).

3. Reenvio que duplica pedido e evento fora de ordem

A rede cai no meio da chamada, a integração não sabe se o pedido foi criado e manda de novo. Aparecem dois pedidos. A documentação da Stripe descreve o remédio, a chave de idempotência (tradução minha):

"A API oferece suporte à idempotência para repetir requisições com segurança, sem executar a mesma operação duas vezes por acidente."

Stripe, documentação da API, seção Idempotent requests, consultada em 15/10/2026

Quando o ERP não oferece essa chave, a integração guarda o identificador do pedido de origem e consulta antes de criar.

O lado que recebe também sofre. Pela documentação de webhooks do Bling, o mesmo evento pode chegar duas vezes, e não há garantia de ordem (uma atualização de produto pode chegar antes da criação). Depois de até 3 dias de retentativas sem sucesso, o webhook daquele recurso é desabilitado até alguém reativar na mão. Sem alerta, o ERP para de avisar e ninguém nota. Trate cada evento como repetível e ponha uma fila entre o recebimento e o processamento.

4. Nota rejeitada em laço de reenvio

A integração que emite NF-e pode bloquear a própria empresa. Quando uma nota é rejeitada e o sistema reenvia o mesmo documento sem corrigir, a SEFAZ responde com a rejeição 656, consumo indevido. A Omie explica que a SEFAZ entende que é a mesma informação enviada várias vezes.

Segundo a Tecnospeed, com base na Nota Técnica 2018.002, 30 tentativas seguidas com o mesmo motivo de rejeição bloqueiam o emissor por 60 minutos. O mesmo vale para mais de 10 consultas da mesma NF-e em uma hora. Reenviar com o mesmo erro nesse período reinicia os 60 minutos. Nesse intervalo a empresa não emite nota. Os limites podem mudar, confira a nota técnica vigente. A regra de projeto: rejeição de negócio interrompe o reenvio automático e vai para a mesa de uma pessoa.

5. Regra fiscal que muda no meio do caminho

A reforma tributária mexeu no layout da nota. A Lei Complementar 214/2025 instituiu o IBS, a CBS e o Imposto Seletivo. Segundo o Portal da Reforma Tributária, a Receita, o Comitê Gestor do IBS e o Encat publicaram em 1º de outubro de 2026 mais um pacote de notas técnicas da NF-e e da NFC-e. Uma delas, a NT 2026.010, exige que sistemas e ERPs adequem a impressão do DANFE até dezembro de 2026.

As datas também mudam. Em 5 de outubro de 2026, o Portal da NF-e informou o adiamento das notas técnicas 2025.002 v1.52, 2026.007 v1.10 e 2026.008 v1.00. As novas datas são 26 de outubro em homologação e 16 de novembro em produção. Quem monta o XML por conta própria, como uma loja virtual ou um PDV, precisa acompanhar. Defina quem lê o Portal da NF-e e quem testa em homologação.

6. Atualização do ERP que muda o contrato

O ERP muda e a integração não fica sabendo. A TOTVS documenta, na página de configuração do REST do Protheus, que a partir da release 12.24.10, de outubro de 2024, a chave Security não pode mais ser alterada. Todos os serviços REST e SOAP precisam trabalhar com autenticação.

Antes de aprovar a atualização do ERP, rode a integração num ambiente de teste com a versão nova.

7. Dado sujo e erro sem dono

Clientes duplicados e identificadores inconsistentes são normais, e dão trabalho. Na isonew, esse custo é nomeado no Diagnóstico, antes de qualquer construção.

Pior é o erro sem dono (este ponto é experiência minha, sem documento de fornecedor por trás). Se a falha cai num log que ninguém lê, o número velho chega à reunião. Todo fluxo precisa de uma pessoa com nome para receber o alerta.

Como escolher a integração ERP: conector pronto, middleware ou código próprio?

A escolha da integração ERP depende do número de sistemas e da clareza das regras. A página de preços da isonew resume assim: um sistema é uma construção, e cinco sistemas com donos diferentes e sem documentação formam um projeto de integração.

1. Um sistema, fluxo padrão e conector oficial do fornecedor. Compre o conector e pare aqui. Projeto feito do zero seria desperdício.
2. Dois a quatro sistemas, com regras próprias. Um código pequeno e monitorado, ou uma plataforma de integração pronta, resolve. Escolha pela equipe que vai manter.
3. Muitos sistemas, donos diferentes, ERP antigo. Uma camada central de integração, com definições escritas de cliente, pedido e receita.

O que move o preço de qualquer desenvolvimento está em quanto custa um software. Se a empresa não tem time para manter a integração depois, o texto sobre fábrica de software mostra quando faz sentido contratar um time externo contínuo.

Como testar a integração ERP antes de ir para produção?

Provoque as falhas antes de rodar com dinheiro de verdade:

1. Rode em homologação. A NF-e tem ambiente próprio de testes.
2. Envie a mesma mensagem duas vezes. O resultado não pode duplicar.
3. Derrube a rede no meio de um lote e veja se o reprocesso termina o que faltou.
4. Force o erro 429 e confirme que a integração espera e retoma, em vez de insistir.
5. Compare todo dia a contagem de pedidos na origem e no ERP. A diferença vira alerta.
6. Dê nome ao dono do alerta.

Trate o outro lado como não confiável: a OWASP inclui o consumo inseguro de APIs entre os dez maiores riscos de API na edição de 2023.

Quando a integração ERP pede ajuda de fora?

Se o seu ERP tem conector oficial para a sua loja virtual e você usa o fluxo padrão, não precisa de projeto. Se a dor está no financeiro, veja o que automatizar primeiro nos processos administrativos.

Vale um desenho antes com três sistemas ou mais, com ERP antigo e sem API, ou com nota fiscal passando pela integração. A isonew trabalha assim: a porta de entrada é o Diagnóstico de Oportunidades de IA, pago e de escopo fechado. Você sai com um plano ordenado e com preço, que pode executar com qualquer pessoa. O valor é abatido da primeira fase se você seguir com a gente. A modernização acontece por fatias, com o sistema antigo rodando em paralelo, como descreve a página de modernização de aplicações.

A decisão que mais vale repetir veio da ChatSac, que eu fundei: orquestrar em vez de substituir. No caso da ChatSac, o CRM e o ERP continuaram como fonte oficial, e a plataforma compunha os dados na hora da conversa.

Os outros textos do tema estão no hub de sistemas legados e integração.