A resposta curta
Para integrar sistemas, use a API do ERP e dos outros sistemas sempre que ela existir, com webhook quando um lado precisa saber na hora que algo mudou. Arquivo e banco intermediário servem quando não há API, e o robô que imita cliques é o último recurso. Antes de escolher, defina qual sistema é a fonte da verdade de cada dado.
A forma de integrar é só metade do trabalho. A outra metade é o que acontece quando algo dá errado: o sistema de destino fora do ar, um registro rejeitado, a mesma venda enviada duas vezes. Uma integração bem feita trata falhas, reprocessa sem duplicar, protege as credenciais e avisa alguém quando para.
Quais são as formas de integrar sistemas
Há cinco formas principais de fazer dois sistemas trocarem dados. A escolha depende do que cada sistema oferece, do volume de registros e de quanto atraso a operação tolera.
| Forma | Como funciona | Vantagens | Cuidados |
|---|---|---|---|
| API | Um sistema chama o outro por uma interface documentada para consultar ou gravar dados | É o caminho padrão, seguro quando bem configurado, e permite validar cada registro na hora | Depende de o fornecedor oferecer a API, dos limites de chamadas e das mudanças de versão |
| Webhook | O sistema de origem avisa o destino automaticamente quando algo acontece | Dado quase em tempo real, sem perguntar o tempo todo se algo mudou | O aviso se perde se o destino estiver fora do ar, então exige conferência e reenvio |
| Arquivo | Exportação periódica em CSV, XML ou formato parecido, lida pelo outro sistema | Simples, funciona com sistemas antigos e é fácil de auditar | Atraso entre exportações, formato que muda sem aviso e risco de ler o mesmo arquivo duas vezes |
| Banco intermediário | Os sistemas gravam e leem numa base ou tabela combinada entre eles | Útil quando não há API e o volume é alto | Prende os sistemas à estrutura do banco, e mexer direto no banco de um sistema de mercado pode comprometer o suporte do fornecedor |
| RPA (robô de tela) | Um robô imita uma pessoa clicando e digitando na interface | Resolve quando não existe nenhum outro meio | Quebra a cada mudança de tela, é lento e difícil de monitorar |
Na prática, uma integração madura combina formas: API para gravar, webhook para avisar e uma conferência periódica para pegar o que escapou. Quando o sistema atual não oferece nenhum meio razoável, a pergunta muda para se vale mantê-lo, assunto do guia sobre como modernizar um sistema legado.
O que levantar antes de integrar o ERP com outros sistemas
Boa parte dos problemas de integração nasce antes da primeira linha de código, de uma pergunta que ninguém fez. Este é o levantamento que vale fazer antes de escolher a forma de integrar:
- Documentação. O sistema tem API documentada? Ambiente de testes? Quem fornece o acesso e quanto tempo isso leva? Integração sem ambiente de testes vira teste em produção.
- Volume. Quantos registros por dia e em que picos. Dez pedidos por dia e dez mil pedem desenhos diferentes.
- Frequência. O dado precisa chegar na hora, a cada hora ou uma vez por dia? Tempo real tem custo e só vale onde a operação precisa dele.
- Fonte da verdade. Para cada dado, qual sistema manda. Tratamos disso na próxima seção.
- Identificadores. Como saber que o cliente 123 no ERP é o mesmo cliente no CRM. Sem uma chave comum, a integração duplica cadastros.
- Limites e contratos. Limite de chamadas, cobrança de acesso à API pelo fornecedor e o que o contrato permite fazer com os dados.
- Responsáveis. Quem na empresa responde por cada sistema e quem será avisado quando algo falhar.
No estudo inicial dos nossos projetos, mapeamos o que cada sistema permite e, quando há limitação, explicamos as alternativas e o impacto de cada uma antes de começar.
Quem é a fonte da verdade de cada dado
Quando dois sistemas guardam o mesmo dado, é preciso decidir qual deles manda. O preço do produto vem do ERP, o contato do cliente pode vir do CRM, o status da entrega vem do sistema da transportadora. Sem essa definição, cada sistema corrige o outro, e a equipe passa a conferir qual versão está certa.
A regra prática é que cada dado tenha um único lugar onde é criado e alterado. Os outros sistemas recebem cópias e não as editam, ou, se editam, devolvem a alteração para a origem por um caminho combinado. É isso que permite cadastrar o dado uma vez e fazê-lo chegar aos outros sistemas sem redigitação e sem duas versões da mesma informação.
Essa decisão às vezes revela que o problema não é integrar, e sim que um sistema já não cabe no processo. O guia sobre software pronto ou sob medida ajuda nessa avaliação.
Como tratar falhas e reprocessar sem duplicar
Toda integração vai falhar em algum momento: o outro sistema sai do ar, a rede oscila, um registro chega com campo inválido. O que separa uma integração confiável de uma frágil é o que acontece nesse momento.
- Fila em vez de chamada direta. O registro entra numa fila e é enviado dali. Se o destino estiver fora do ar, ele espera, em vez de se perder.
- Novas tentativas com intervalo crescente. Tentar de novo logo em seguida e depois com espera maior, sem sobrecarregar o outro sistema com repetições.
- Envio idempotente. Cada registro leva um identificador único, e o destino reconhece quando recebe o mesmo envio duas vezes. Assim o reprocessamento não cria um pedido em dobro.
- Erro de dado separado de erro técnico. Sistema fora do ar se resolve com nova tentativa, CPF inválido não. Registros rejeitados vão para uma lista de pendências com o motivo, para alguém corrigir.
- Conciliação periódica. Uma conferência que compara origem e destino e aponta o que ficou para trás, porque nenhum mecanismo pega tudo.
Segurança na integração de sistemas
Uma integração é uma porta entre dois sistemas e deve ser tratada como tal. Os cuidados básicos:
- Credenciais fora do código. Chaves e senhas de API ficam em cofre ou em variáveis protegidas, com troca periódica.
- Permissão mínima. O usuário da integração acessa só o que ela usa. Se ela só lê pedidos, não pode apagar clientes.
- Canal protegido e chamadas assinadas. Tráfego criptografado e, nos webhooks, verificação de que o aviso veio mesmo do sistema de origem.
- Dados pessoais com finalidade. Só trafega o que o destino precisa, conforme a LGPD, e cada movimentação fica registrada.
No projeto de monitoramento com beacons, os números de presença saem por uma API assinada e são consumidos pelos painéis que a unidade de saúde já usava, em vez de obrigar a equipe a abrir mais um sistema.
Monitoramento: como saber que a integração parou
A pior falha de integração é a silenciosa: ela para numa sexta-feira e alguém percebe na segunda, quando o estoque não bate. Monitorar é saber disso antes do cliente.
- Alerta de ausência. Se nenhum registro passou num período em que sempre passa, alguém é avisado.
- Painel de pendências. Fila de erros visível, com o motivo e a idade de cada registro parado.
- Registro de cada envio. O que saiu, quando e com qual resposta. É o que permite investigar uma divergência sem adivinhar.
- Dono do alerta. Alerta que chega para todo mundo não chega para ninguém. Cada tipo de falha tem um responsável.
Integrar sistemas é uma das frentes do nosso trabalho em automação e inteligência artificial e em software sob medida. Dos primeiros projetos de varejo, integrados a ERPs e marketplaces, à recepção do sistema de gestão de pacientes, integrada ao CAD-SUS e ao CNS, a lição se repete: a integração só está pronta quando alguém sabe, sem precisar perguntar, que ela está funcionando.