Serviço 03
Integrações e APIs
Fazer dois sistemas que não foram feitos para conversar trocarem dados de forma confiável.
Contexto
Marketplace, ERP, gateway de pagamento, CRM, planilha, sistema legado que ninguém quer tocar. Cada um com seu formato, seu limite de requisições e seu jeito particular de falhar.
Integração boa não é a que funciona no dia da entrega: é a que continua funcionando quando a API do outro lado fica fora do ar por vinte minutos, muda um campo sem avisar ou passa a limitar chamadas. O trabalho é prever isso — repetir com critério, guardar o que não passou e avisar quem precisa saber.
Sinais de que é o seu caso
- Pedido do marketplace entra no sistema por digitação manual
- A integração atual falha em silêncio e ninguém sabe quantos registros se perderam
- Cada relatório exige exportar de três lugares e cruzar na mão
- Você depende de um fornecedor para qualquer mudança no fluxo de dados
O que fica com você no fim
- Integração com tratamento de erro, repetição e fila de pendências
- Painel ou relatório que mostra o que passou e o que ficou parado
- Credenciais isoladas em cofre, nunca dentro do código
- Testes nos caminhos que costumam quebrar, não só no caminho feliz
O que não é
- Script único que roda na máquina de alguém
- Integração com sistema cujo acesso não pode ser fornecido
Um processo na prática
Uma venda no CRM vira pedido no ERP
Exemplo de funcionamento. Não é um case de cliente nem uma promessa de resultado.
Ver o contrato mensalIdentificar
A venda confirmada tem um identificador. Ele acompanha o envio para que uma repetição não crie outro pedido.
Trocar dados
Cliente, itens e valores são mapeados para o ERP. Dados rejeitados ficam visíveis, sem desaparecer no caminho.
Confirmar
O número do pedido volta ao CRM. Se houver indisponibilidade, o envio pode ser retomado com registro do que aconteceu.
Por onde começo
Confiro as APIs e permissões dos dois sistemas. Testo um registro de ponta a ponta antes de liberar o fluxo real.
O que continua todo mês
Monitoro a troca e ajusto autenticação, campos e versões quando as APIs mudam. Novas integrações disputam prioridade na mesma fila.
Perguntas desta frente
E quando a API do outro lado sai do ar?
É justamente para isso que a integração é construída. Ela repete com critério, guarda o que não passou numa fila e avisa quem precisa saber. Integração boa não é a que funciona no dia da entrega: é a que continua funcionando quando o outro lado falha por vinte minutos.
Dá para integrar com um sistema antigo, sem API?
Quase sempre, desde que exista algum caminho de acesso — banco, exportação de arquivo, e-mail automático. O que não dá é integrar com um sistema cujo acesso o fornecedor se recusa a liberar. Nesse caso eu digo antes de começar.