Pular para o conteúdo
Transformação digital

Integração com ERP: como integrar mesmo quando o sistema não tem API

Seu ERP não tem API e alguém redigita dado todo dia? Os caminhos que existem, quanto cada um aguenta em produção e o que perguntar ao fornecedor antes.

Nathan Almeida 7 min de leitura

Dá para integrar um ERP que não tem API, e na maioria dos casos sem mexer no ERP. Os caminhos são a exportação nativa, a leitura do banco, a troca de arquivo agendada, uma API nova por cima do sistema antigo e, em último caso, automação da tela. A escolha define quanto a integração aguenta quando algo falha.

Se você é gerente financeiro, de TI ou dono de uma empresa onde alguém copia dado do ERP para outro sistema todo dia, este texto é para decidir com informação antes de pedir orçamento.

Onde o ERP isolado mais custa

ERP e loja virtual. O pedido entra na loja e alguém lança no ERP para emitir nota e separar estoque. Enquanto isso não acontece, a loja continua vendendo um estoque que talvez não exista mais.

ERP e CRM. O comercial fecha a venda no CRM, o financeiro cadastra o cliente de novo no ERP. Dois cadastros, duas grafias do mesmo CNPJ, e ninguém sabe qual está certo.

ERP e gateway de pagamento. O pagamento cai no gateway e a baixa no contas a receber é manual. Cliente que já pagou recebe cobrança, e a conciliação do mês vira uma semana de planilha.

ERP antigo sem API. O sistema roda há quinze anos, o fornecedor mudou de dono ou não atende mais, e não existe documentação. É o cenário mais comum, e o resto deste texto trata dele.

Se a sua dor ainda é entender quanto essa rotina manual custa por mês, comece por o custo de dois sistemas que não conversam.

Os caminhos quando não existe API

API é a porta que um sistema oferece para outro conversar com ele de forma controlada. Quando ela não existe, há cinco alternativas, em ordem de preferência.

1. Exportação nativa do ERP

Muitos ERPs geram relatório, planilha ou arquivo de exportação que ninguém na empresa usa. A integração lê esse arquivo e leva os dados para o outro lado.

A favor: usa um recurso oficial do ERP, então sobrevive bem a atualização de versão. Contra: o dado chega no intervalo da exportação, não na hora, e o formato pode ser limitado.

2. Leitura direta do banco de dados

A integração consulta as tabelas do ERP com um usuário que só tem permissão de leitura. Alguns bancos ajudam: o SQL Server, por exemplo, tem um recurso chamado Change Tracking que informa quais registros mudaram desde a última consulta, sem reler tudo.

A favor: dado quase em tempo real e sem depender do fornecedor. Contra: a estrutura do banco não é contrato. Uma atualização do ERP pode renomear uma coluna e a integração precisa perceber isso na hora, não um mês depois. E ler é uma coisa; gravar direto nas tabelas do ERP quase nunca é boa ideia, porque pula as regras que o próprio sistema aplica.

3. Troca de arquivo agendada

O ERP importa e exporta arquivo (CSV, TXT posicional, XML) numa pasta, e a integração deposita e recolhe esses arquivos em horário marcado. É o caminho clássico para gravar no ERP sem tocar no banco dele.

A favor: respeita as validações do ERP, porque é ele quem importa. Contra: funciona em lote, e arquivo rejeitado pela metade é um problema que precisa ser tratado de propósito.

4. API que encapsula o legado

Construímos uma API nova, fora do ERP, que por dentro usa os caminhos acima. Os outros sistemas passam a conversar com essa API como se o ERP fosse moderno.

A favor: os sistemas novos ficam isolados do legado. Se um dia o ERP for trocado, só essa camada muda. Contra: é mais um sistema para manter, e só se paga quando há mais de um sistema consumindo o ERP.

5. Automação de interface (último recurso)

Um robô abre a tela do ERP e digita como uma pessoa faria. Às vezes é o único caminho.

A favor: funciona com sistema totalmente fechado. Contra: é o mais frágil de todos. Muda um botão de lugar, aparece um pop-up novo, e a integração para. Usamos quando não há alternativa e com monitoramento redobrado.

Comparando os caminhos

CaminhoAtraso do dadoDepende do fornecedorRobustezCusto de manutenção
Exportação nativaIntervalo da exportaçãoPoucoAltaBaixo
Leitura do bancoMinutosNãoMédiaMédio
Arquivo agendadoIntervalo do lotePoucoAltaBaixo
API sobre o legadoDepende do caminho internoNãoAltaMédio
Automação de interfaceMinutosNãoBaixaAlto

Na prática, as integrações costumam combinar caminhos: leitura do banco para saber o que mudou e arquivo agendado para gravar.

O que perguntar ao fornecedor do ERP

Antes de contratar qualquer integração, vale uma conversa de meia hora com quem fornece o ERP:

  • Existe API, mesmo que não divulgada? Ela tem documentação e ambiente de teste?
  • Quais exportações e importações de arquivo o sistema já faz, e em que formato?
  • Podemos ter um usuário de banco somente leitura? Há réplica disponível?
  • Com que frequência sai atualização de versão, e ela costuma mudar o banco?
  • A licença ou o contrato permite acesso de terceiros aos dados?

A última pergunta é a mais esquecida. Alguns contratos restringem acesso direto ao banco, e descobrir isso depois da integração pronta é caro.

Os dois riscos que mais aparecem

Falha silenciosa. A integração para numa sexta à noite e ninguém percebe até o fechamento do mês. Integração sem alerta é pior que planilha, porque a planilha pelo menos alguém olha.

Duplicidade. A conexão cai no meio do envio, a integração tenta de novo, e o pedido entra duas vezes no ERP. Ou a cobrança sai em dobro.

O tratamento é sempre o mesmo conjunto:

  • Idempotência: cada registro leva uma identificação única, e o sistema verifica se ela já foi processada antes de agir. É o que impede a nova tentativa de virar pedido duplicado. A documentação da Stripe explica bem o mecanismo para quem quiser ver como um gateway trata isso.
  • Fila: o dado é recebido, guardado e processado em seguida. Se o ERP estiver fora do ar, nada se perde; a fila espera.
  • Log: cada troca fica registrada, para o financeiro responder “o que aconteceu com o pedido 48291?” sem abrir chamado.
  • Alerta: quando a integração para ou a taxa de erro sobe, alguém é avisado no mesmo dia.

Quanto tempo leva

Integração com API bem documentada e ambiente de teste disponível costuma levar de 2 a 5 semanas. Sem API, o prazo depende do que o diagnóstico encontra: banco organizado e exportação nativa aproximam desse número; sistema sem documentação nenhuma acrescenta uma etapa de entender como o legado guarda os dados.

Um aviso honesto: se o seu ERP já tem um conector pronto e mantido para a loja ou o gateway que você usa, contrate o conector. Integração sob medida só se justifica quando o pronto não existe ou não cobre o seu processo.

Já vimos esse filme

Antes de fundar a Allmeida Tech, Nathan Almeida trabalhou no rastreamento de peças para a indústria automotiva, integrando um backend novo a um ambiente corporativo com ERP e SQL Server legado que ninguém podia alterar. A lição que fica é a mesma de qualquer ERP antigo: o sistema novo se adapta ao que já existe, nunca o contrário.

Detalhes de como trabalhamos estão em APIs e integrações. Se o seu ERP não conversa com o resto da empresa, o diagnóstico técnico gratuito de 30 a 45 min começa por descobrir qual desses caminhos existe no seu caso, e às vezes a resposta é uma exportação que o ERP já faz.

Perguntas frequentes

  • Meu ERP não tem API. Dá para integrar mesmo assim?

    Quase sempre. Os caminhos mais comuns são a exportação que o próprio ERP já oferece, a leitura direta do banco de dados, a troca de arquivo agendada ou uma API nova construída por cima do sistema antigo, sem alterá-lo. Cada caminho tem custo e robustez diferentes, e a escolha sai do diagnóstico, não de preferência.

  • Ler direto do banco do ERP pode estragar alguma coisa?

    Leitura bem feita não altera nada: usa um usuário só de leitura, consultas leves e, quando possível, uma réplica do banco. O risco real está em gravar direto nas tabelas do ERP, porque isso pula as regras de negócio dele. Gravação passa pelos caminhos que o próprio ERP oferece, como importação de arquivo.

  • Quanto tempo leva uma integração com ERP?

    Integração com API bem documentada e ambiente de teste disponível costuma levar de 2 a 5 semanas. Sem API e sem documentação, o prazo depende do que o diagnóstico encontra, porque parte do trabalho vira entender como o sistema antigo guarda os dados antes de escrever código.

  • E se o fornecedor do ERP não colaborar?

    Acontece, e muitas vezes é falta de equipe, não má vontade. Exportação nativa, leitura de banco e automação de interface não dependem dele. O que muda é o custo de manutenção: quanto menos o fornecedor participa, mais a integração precisa se proteger sozinha contra mudanças de versão.

Tem um projeto ou um sistema que precisa de atenção?

A primeira conversa é um diagnóstico técnico, não uma reunião de vendas. Você sai dela com uma leitura honesta do problema e uma faixa de investimento — mesmo que não feche com a gente.

  • Resposta em até 1 dia útil
  • Sem compromisso
  • NDA se você precisar
WhatsApp