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
| Caminho | Atraso do dado | Depende do fornecedor | Robustez | Custo de manutenção |
|---|---|---|---|---|
| Exportação nativa | Intervalo da exportação | Pouco | Alta | Baixo |
| Leitura do banco | Minutos | Não | Média | Médio |
| Arquivo agendado | Intervalo do lote | Pouco | Alta | Baixo |
| API sobre o legado | Depende do caminho interno | Não | Alta | Médio |
| Automação de interface | Minutos | Não | Baixa | Alto |
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.