Conferir no destino

Numa operação de serviço recorrente do grupo, a gente ligou o sistema de gestão a uma camada que lê os pagamentos para perceber quando um cliente está perto de sair. A integração subiu, os logs ficaram limpos, nenhum alerta tocou, e por alguns dias tudo parecia funcionar. A receita que chegava do outro lado era zero.

O conector mandava o evento de fatura criada. O destino só aceitava o de fatura paga. Uma palavra de diferença entre os dois, e nenhum dos lados tinha motivo para reclamar: quem enviava recebia a confirmação de que a mensagem tinha sido aceita, e quem recebia simplesmente não tinha nada para contar.

Esse tipo de defeito não aparece em teste de integração comum, porque o teste costuma conferir o que saiu da origem. Um status 200 diz que alguém respondeu. Ele não diz que o dado foi guardado, nem que alguma regra leu o que foi guardado.

Desde então, a gente trata três coisas como parte da entrega, e não como detalhe de operação.

Conferir no destino, não na origem. Quando uma integração é dada por pronta, alguém abre o sistema que recebe e procura o registro que deveria ter chegado, com o valor certo, no campo certo. Se ninguém consegue apontar onde o dado foi parar, a integração ainda não está pronta.

Dar nome ao zero. Um indicador pode mostrar zero por três motivos bem diferentes: porque foi medido e deu zero, porque não foi medido, ou porque a medição quebrou no meio do caminho. Na tela, os três parecem iguais. Nos nossos painéis, cada número diz em qual dos três estados está, e "não medido" aparece escrito, em vez de virar um zero confiante.

Testar a trava quebrando de propósito. Uma verificação que nunca reprovou nada não prova que funciona. Antes de confiar numa trava, a gente quebra de propósito a coisa que ela deveria pegar e confere se ela pega.

Com IA e regras automáticas lendo esse dado, a falha silenciosa fica mais cara. Um painel com zero ainda pode chamar a atenção de alguém; uma camada de decisão que recebe zero age em cima dele. Por isso, no SYNQi³, cada número carrega a origem e a janela medida, e a ausência de medição tem regra própria.

Nada disso é sofisticado. Custa um pouco mais de tempo na entrega e evita a pior conversa que existe numa empresa, a de descobrir semanas depois que um número que todo mundo usava para decidir estava vazio.

Quatro perguntas para fazer a quem cuida das suas integrações:

1. 01Quando esta integração foi dada por pronta, alguém conferiu o registro no sistema de destino?
2. 02Este indicador mostra a diferença entre "deu zero" e "não foi medido"?
3. 03Qual foi a última vez que uma verificação automática reprovou algo de verdade?
4. 04Se um evento parar de chegar amanhã, quanto tempo leva até alguém perceber?