Integração de sistemas: o que ninguém conta antes de contratar

"Integra com o nosso ERP?" é a pergunta mais frequente em qualquer projeto. E a resposta "sim" quase nunca é falsa — mas quase sempre é incompleta.

Integrar dois sistemas é fácil no dia da entrega. O difícil é mantê-los conversando por anos, enquanto os dois lados mudam.

Por que integrações quebram

Uma integração é uma promessa entre dois sistemas que evoluem de forma independente. Ela quebra por motivos previsíveis:

O outro lado mudou. Um campo virou obrigatório, um formato de data mudou, um endpoint foi descontinuado. Ninguém avisou.

O volume cresceu. O que funcionava com 100 registros por dia começa a estourar limite de requisições com 10 mil.

A rede falhou. Toda integração vai enfrentar timeout, instabilidade e indisponibilidade. A pergunta não é se, é o que acontece quando.

Os dados não batem. O cliente cadastrado como "Silva & Cia" de um lado e "Silva e Cia Ltda" do outro é a mesma empresa — mas nenhum sistema sabe disso.

O que separa uma integração confiável

Uma integração séria não é só um código que envia dados. Ela precisa de quatro coisas:

1. Nova tentativa com espera progressiva

Falhas temporárias são normais. O sistema precisa tentar de novo — esperando cada vez mais entre tentativas, para não piorar a sobrecarga do outro lado.

2. Idempotência

Se a mesma operação for enviada duas vezes, o resultado precisa ser o mesmo. Sem isso, uma retentativa vira pedido duplicado — e alguém do financeiro descobre isso depois do cliente.

3. Fila de erros visível

Registros que falharam repetidamente não podem sumir. Eles precisam ir para uma fila que alguém consiga ver, entender o motivo e reprocessar.

4. Monitoramento que avisa antes

O pior cenário não é a integração cair. É ela cair em silêncio e você descobrir três dias depois, pelo cliente. Um alerta simples — "nenhum pedido sincronizado nas últimas 2 horas" — evita a maior parte dos danos.

As perguntas que valem fazer

Antes de fechar contrato, pergunte ao fornecedor:

• O que acontece se o outro sistema ficar fora do ar por 6 horas?
• Como eu descubro que algo falhou? E em quanto tempo?
• Registros que falharam podem ser reprocessados? Por quem?
• Qual o limite de requisições da API do outro lado? E o volume esperado?
• Se o fornecedor do outro sistema mudar a API, quem ajusta?

Se as respostas forem vagas, o problema não é técnico. É de expectativa — e ela vai cobrar juros depois.

Quando não existe API

Nem todo sistema legado oferece integração. Nesses casos há alternativas, em ordem de preferência:

1. Banco de dados em leitura — funciona, mas cria acoplamento com a estrutura interna do outro sistema
2. Troca de arquivos — CSV ou XML em diretório monitorado; simples e surpreendentemente robusto
3. Automação de interface — último recurso, frágil a qualquer mudança de tela

A escolha depende de quanto o processo tolera atraso e de quem controla o sistema legado.

O custo de não integrar

Integração parece cara até você somar o custo de não tê-la: digitação em duplicidade, divergência entre relatórios, decisão tomada com número desatualizado e o tempo da equipe conciliando planilhas.

Esse custo não aparece em nenhuma fatura. Ele aparece no fim do mês, quando dois relatórios não fecham e ninguém sabe qual está certo.

---

Precisa conectar sistemas que hoje não conversam? Mapeamos o cenário e indicamos o caminho mais estável para o seu volume.