Integração entre sistemas, sem ninguém redigitar nada

O custo de redigitar não é o tempo de digitação

Quando o pedido é digitado no e-commerce e redigitado no sistema de estoque, o que se perde não são os dois minutos. É que a partir dali existem duas versões do mesmo pedido, e nenhuma sabe da outra.

Uma delas vai ficar desatualizada — o cliente mudou o endereço num lado, a quantidade foi corrigida no outro — e a divergência aparece no pior momento possível: na entrega errada, na cobrança errada, na nota fiscal com o dado antigo.

Integração não é conveniência. É o que faz existir uma versão só de cada fato.

Os quatro caminhos, e quando cada um serve

API é conversa direta: um sistema pergunta e o outro responde na hora. É o caminho ideal para consulta — saldo, preço, situação do pedido — porque a resposta é sempre a atual. Exige que o outro lado ofereça a API e que ela esteja no ar.

Webhook é o contrário: em vez de perguntar de minuto em minuto, o outro sistema avisa quando algo acontece. É o que faz a demonstração acima parecer instantânea. É mais barato e mais rápido, e exige um endereço nosso preparado para receber e conferir a origem da chamada.

Fila é o que segura a peça quando o outro lado cai. A mensagem fica guardada e é reenviada até ser aceita, em vez de sumir. Qualquer integração séria tem uma, porque o outro lado vai cair — a pergunta é só quando.

Arquivo é o caminho de quando não há caminho: CSV, XML ou planilha trocados por pasta, e-mail ou FTP. É antigo e funciona. Perde em tempo real e ganha em compatibilidade com sistema que não oferece mais nada.

Quando o sistema do outro lado é fechado

Acontece muito: o ERP é antigo, o fornecedor cobra caro pelo módulo de integração, ou simplesmente não existe API. Nesse caso ainda há saídas, e elas têm ordem de preferência.

A primeira é o arquivo: quase todo sistema exporta e importa alguma coisa, nem que seja um relatório. A segunda é o banco de dados, quando o acesso é possível e autorizado — com leitura, e não escrita, porque escrever direto no banco de outro sistema é passar por cima das regras dele.

A última é automação de tela, que imita uma pessoa usando o programa. Funciona, e é frágil: qualquer atualização visual quebra. Só vale quando as outras não existem, e sempre com aviso de que ela vai quebrar um dia.

O que separa uma integração que dura de uma que dá plantão

Toda integração falha. A diferença entre uma boa e uma ruim é o que acontece depois da falha. Uma boa registra o que tentou enviar, tenta de novo sozinha com intervalo crescente, e avisa uma pessoa quando desiste.

Ela também é idempotente, que é uma palavra feia para uma ideia simples: se a mesma mensagem chegar duas vezes, o pedido não vira dois pedidos. Sem isso, um reenvio automático duplica venda — e duplicar venda é pior do que perder a integração.

E ela tem um painel, nem que seja uma tela feia, onde se vê o que passou e o que travou. Integração sem visibilidade só é descoberta pelo cliente ligando.

Segurança: o que não fazer

Um endereço que recebe webhook está aberto na internet, e qualquer um pode chamá-lo. Sem conferir a assinatura da mensagem, quem descobrir a URL consegue criar pedidos no seu sistema. A conferência é barata — um código calculado com um segredo combinado entre os dois lados — e é o primeiro item que falta nas integrações feitas com pressa.

Credencial de integração não vai dentro do código nem numa planilha compartilhada. Ela vira variável de ambiente do servidor, e quem precisa dela lê de lá. Chave que passou por conversa de mensagem precisa ser trocada, e não guardada com cuidado.

E a integração deve ter permissão só do que usa. Um acesso criado para consultar saldo não precisa poder apagar pedido — e no dia em que essa credencial vazar, a diferença entre as duas coisas é a diferença entre um susto e um prejuízo.