Integrações na prática

Quanto custa manter uma integração: o orçamento que termina no dia da entrega

O que muda do outro lado sem aviso, os sete itens de custo depois do projeto e por que integração sem dono nomeado quebra sem ninguém saber.

Leonardo Peron5 min de leitura

O orçamento de uma integração termina no dia da entrega. Dali em diante ela some da planilha e reaparece só como incidente — o que é curioso, porque integração não é obra que fica pronta: é um acordo com uma contraparte que pode mudar os termos sozinha, quando quiser.

Esse é o assunto inteiro. O prazo do projeto tem variáveis conhecidas; o custo depois dele quase nunca é orçado, e a pergunta útil não é se ele existe — é de que é feito e o que faz cada parte subir.

O que muda do outro lado sem você pedir

Versão de API depreciada. Vem com data, e a data não é negociável. É trabalho que você não escolheu, não pode adiar e que, no melhor caso, deixa o sistema fazendo exatamente o que já fazia.

Campo que vira obrigatório. Ontem opcional, hoje recusado. O sintoma é uma enxurrada súbita na fila com um erro de validação que nunca tinha aparecido.

Regra fiscal ou regulatória. Layout de documento, alíquota, formato de arquivo. Muda pelo calendário do órgão, que não é o seu — a fronteira de ERP e contabilidade.

Credencial e certificado. Rotação, vencimento, revogação. É o único item com data conhecida de antemão e ainda assim o que mais derruba integração de madrugada.

Política de limite. O teto é revisto e o que cabia deixa de caber, o que transforma limite de requisições de detalhe técnico em conta mensal.

Atualização do sistema do outro lado. Onde a leitura é direta no banco, cada versão é risco a reavaliar — a razão de integrar um sistema sem API sair caro no longo prazo.

E há a metade que ninguém atribui à integração porque nasce em casa: filial nova, forma de pagamento nova, tipo de produto que não existia, um campo renomeado no ERP por outro departamento.

Os itens que compõem a conta

Nenhum deles tem preço universal, e quem oferecer um está chutando. O que dá para fazer é listá-los, porque item esquecido é o que estoura orçamento.

Infraestrutura e licenças que a integração consome todo mês. Costuma ser a menor linha e a mais fácil de perder de vista — sobretudo quando está na conta pessoal de alguém.

Vigilância. A instrumentação de monitorar integração em produção custa para existir e custa para ser olhada. Sem ela o custo não some: vira prejuízo descoberto pelo cliente.

Operação diária. Alguém abre a fila de erro, entende a causa, corrige o dado e reprocessa. É trabalho humano, não software, e é a linha que mais cresce sem ninguém notar — o tipo de horas que a calculadora de trabalho manual torna visível.

Manutenção reativa. A quebra às 22h. O custo não é a correção, é a disponibilidade: alguém que responde fora do horário é um compromisso com preço, e por isso ele aparece em prazo por gravidade antes de aparecer numa fatura.

Manutenção obrigatória. Tudo da seção anterior: não gera valor novo e não dá para não fazer.

Evolução. As mudanças pequenas que o negócio pede — mais um campo, mais um status, mais um canal. Cada uma é barata; a soma delas é o que consome o ano.

Conhecimento. Documentação atual, mais de uma pessoa que entende, ambiente que sobe do zero. É o item que ninguém contrata e que decide o preço de todos os outros no dia em que quem escreveu sair.

O que faz cada um subir

Quantidade de entidades que atravessam, e quantas andam nos dois sentidos. Bidirecional custa mais que o dobro: arrasta a decisão de quem é o dono do cadastro para dentro de cada manutenção.

Quantidade de contrapartes. É o multiplicador que mais surpreende: cada sistema do outro lado tem um relógio próprio de mudança, e cinco integrações para cinco fornecedores não têm um custo, têm cinco calendários independentes de coisas quebrando.

Domínio regulado, onde a mudança chega por lei e não por escolha. Volume, que decide se uma falha rara é ruído ou é gente esperando o dia inteiro. E se existe homologação para provar a mudança antes: sem ela, toda alteração imposta é testada em produção, com o custo descrito em testar antes de subir.

Num hub parte disso sai da folha e entra na fatura — o que é uma troca legítima, desde que se saiba que ela também transfere o calendário: você passa a depender de quando o fornecedor do conector resolve atualizar.

Integração sem dono nomeado é integração que vai quebrar em silêncio

Não um time, não uma área: uma pessoa, com nome, que recebe o alarme, sabe o que a integração faz, e tem substituto declarado.

O sintoma é fácil de checar e desconfortável: ninguém sabe dizer qual credencial ela usa, em qual conta, nem quem seria avisado se parasse. É onde mora o sistema que ninguém sabe manter, e a falta de dono é sempre descoberta na hora do incidente.

O inventário que responde quanto custa a sua

Uma linha por integração, e o custo deixa de ser abstrato:

  • Quais entidades atravessam, em que direção, e com que volume por dia.
  • Qual credencial usa, em nome de quem, e quando vence.
  • Onde estão o registro de mudanças e a política de versão da API do outro lado.
  • Se existe ambiente para testar a próxima mudança imposta.
  • Quantos itens entraram na fila de erro no último mês, e quem os tratou.
  • Quem é o dono nomeado, e quem é o substituto.
  • O que a empresa deixa de fazer no dia em que ela parar.

O último item ordena a lista. Integração cuja parada ninguém sente vive com o mínimo; a que trava o faturamento merece sustentação com plantão — e a conversa honesta é escolher isso agora, não no dia em que ela parar.

Isso é o que fazemos em integração de sistemas

ERP, e-commerce, CRM, banco e planilha falando entre si por API, webhook ou arquivo. Sem duplicar pedido e sem uma pessoa no meio copiando dado.

Resposta em até 1 dia útil