Pular para o conteúdo
Calango Lab — inícioCalango Lab
06 O dado atravessando

Dois sistemas. Uma conversa só.

Quando o dado precisa atravessar de um sistema para outro e hoje atravessa por alguém exportando, conferindo e redigitando. É trabalho invisível que custa hora, gera erro e some quando a pessoa tira férias.

O dado atravessando sozinho

Integração não é conectar dois logotipos. É acertar o que acontece quando o pedido chega fora de ordem, quando a outra ponta demora a responder e quando a mesma informação volta duas vezes — que é onde as integrações improvisadas quebram.

De onde vem
  • ERP e sistema de gestão
  • Loja virtual e marketplace
  • Planilha e formulário
  • Sistema interno legado
Para onde vai
  • Emissor de nota fiscal
  • Gateway de pagamento
  • CRM e atendimento
  • Painel e relatório
O que atravessa
Pedidodo carrinho ao ERP, com item, preço e freteEstoquebaixa e reposição, nos dois sentidosNota fiscalemitida no fechamento, com o número de voltaCadastrocliente e endereço sem redigitaçãoStatusseparação, envio e entrega chegando ao clientePagamentoconfirmação, estorno e conciliação
O que sustenta

O que garante que não quebra em silêncio

A diferença entre uma integração e um script agendado está aqui — e é aqui que aparece a conta, meses depois, quando ninguém olhava.

Registro de cada troca

Toda mensagem que entra e sai fica gravada. Quando alguém pergunta "esse pedido chegou?", a resposta é um log, não um palpite.

Retentativa com espera crescente

API de terceiro cai — é fato da vida, não exceção. A integração espera e tenta de novo, em intervalos maiores, em vez de perder o dado no primeiro erro.

Alerta quando insiste em falhar

Falha isolada se resolve sozinha. Falha repetida vira aviso para gente de verdade, antes de o cliente ligar reclamando.

Reprocessamento sem duplicar

Reenviar o que falhou não pode gerar dois pedidos nem duas notas. Cada evento carrega identificação própria, e o que já entrou é reconhecido e ignorado.

Integração que ninguém monitora não está funcionando — está funcionando até segunda ordem, e você descobre qual das duas pelo telefone do cliente.

Dúvidas

O que costumam perguntar

O sistema que eu uso não tem API. Ainda dá?

Quase sempre dá, por outro caminho: exportação agendada de arquivo, banco de dados acessível, importação por planilha ou robô que opera a interface quando não sobra alternativa. O levantamento diz qual caminho existe e o que cada um custa em confiabilidade — e essa parte vai escrita na proposta.

Já tenho um script que faz isso. Por que trocar?

Se ele funciona e alguém entende como, não troque. O que costuma faltar é o entorno: log do que passou, retentativa quando a outra ponta cai, alerta quando falha e alguém que saiba mexer. Script sem isso funciona até o dia em que não funciona — e ninguém percebe até o cliente ligar.

Quanto tempo leva uma integração?

Depende inteiramente da outra ponta: API documentada e estável é um cenário, sistema fechado sem documentação é outro. Por isso a primeira etapa é sempre um levantamento das duas pontas, e o prazo só vira compromisso depois dele.