Resposta direta
A exigência útil não é que a integração não falhe, e sim que a falha produza aviso, registro e responsável. Na avaliação e na contratação, isso se traduz em três pontos verificáveis: existe um sinal de erro que chega a alguém nomeado, existe registro do que foi processado e do que falhou, e existe procedimento combinado para reprocessar e corrigir dados já gravados. Sem esses três, a falha continua silenciosa mesmo com contrato assinado. O restante da negociação trata de prazo, custo e escopo, que não substituem o aviso.
- Objetivo
- Orientar avaliação e contratação
- Formato indicado
- Projeto de implementação
- Atualizado em
O que esta página acrescenta: Trata a falha silenciosa como item de contrato: quem avisa, com que registro e com qual responsabilidade, e não como problema de operação depois que ocorre.
O caminho entre a falha e o aviso
Em muitos sistemas, a integração falha e o erro vira uma linha de log. Ninguém é dono da leitura desse log. O processo segue, os números do dia seguem, e a diferença aparece semanas depois, já misturada a outros problemas.
Há também a falha parcial. O lote é enviado, metade é aceita, e o retorno é tratado como sucesso porque não veio mensagem de erro. O registro faltante some sem deixar rastro no painel. O ponto de partida é localizar onde o aviso se perde hoje.
O que verificar antes de assinar
O contrato precisa nomear quem recebe o aviso. Não a área, mas a função ou a pessoa. Precisa indicar por qual canal o aviso chega, se esse canal é acompanhado e se existe confirmação de recebimento. Também cabe registrar a janela de detecção considerada aceitável, ou seja, quanto tempo entre a falha e o aviso ainda é tolerável.
Do lado operacional, três itens são verificáveis na homologação: a falha provoca aviso de verdade quando é provocada de propósito; existe registro do que foi processado e do que não foi, com identificação do registro; e há procedimento combinado para reprocessar sem duplicar o que já foi gravado. Se nada disso aparece no contrato nem no teste, o aviso passa a depender de boa vontade.
O limite do aviso
Aviso não corrige significado. Se os dois lados entendem o mesmo campo de formas diferentes, a integração termina sem erro e grava o valor errado. Não houve falha técnica e não há alerta a disparar; o problema é de definição de dado e se resolve antes da integração.
O contrato cria obrigação, não certeza sobre o comportamento da outra parte. Em operações pequenas, com volume baixo e conferência frequente, montar toda a estrutura de alerta pode custar mais do que o erro que se quer conter. O critério é comparar o custo da falha silenciosa com o custo de mantê-la visível.
Recurso prático
Exposição até a detecção
Exposição = (D × V × C) + R
- D
- dias
- Intervalo entre a falha e o momento em que alguém percebe. Deve ser medido, não estimado.
- V
- registros por dia
- Volume médio de registros que passam pela integração por dia no período observado.
- C
- moeda por registro
- Custo unitário de corrigir um registro já gravado: retrabalho, crédito, estorno ou ajuste manual.
- R
- moeda
- Custo fixo de reprocessar o lote e reconciliar as duas pontas depois da descoberta.
O erro mais comum é usar como D o tempo de indisponibilidade técnica. O intervalo que importa é entre a falha e a detecção: uma integração que para por minutos e fica dias sem aviso custa mais do que horas de queda percebidas na mesma hora.
Conceitos usados nesta página
- Retrabalho — Retrabalho é o esforço repetido para corrigir ou refazer algo que já havia sido produzido — custo que não aparece no orçamento, mas consome capacidade e prazo.
- Responsável nomeado — Responsável nomeado é a pessoa identificada — não a área — que responde por um número, processo ou entrega.
Sobre o que está escrito aqui
Conceitos relacionados: sinal de erro · log de processamento · reprocessamento · responsável nomeado · cláusula de aviso. Exemplos são ilustrativos. Não há cliente, resultado, preço, prazo ou certificação nesta página. Quando o formato indicado é Projeto de implementação, ele descreve uma possibilidade de trabalho — a conversa inicial avalia contexto e aderência.
Para continuar
- Integrações, sistemas e qualidade de dados — Página central do tema
- Migração de dados: o que conferir antes e depois — migração sem conferência
- Dados desatualizados: o que precisa estar em dia — dados desatualizados
Páginas relacionadas
O mesmo problema em outro objetivo
- Integração parou sem avisar: como achar quando e onde — Diagnosticar
- Falha de integração sem aviso: o que comparar nas respostas — Comparar alternativas
- Falha de integração sem aviso: como montar o alerta — Orientar implementação
Outras leituras em Integrações, sistemas e qualidade de dados
- Sincronização sem janela definida: o que fixar no contrato — O contrato de sincronização precisa definir frequência, tolerância de atraso, reprocessamento e critério de aceite, com fórmula para medir a janela.
- Sincronização sem janela definida: até quando o dado serve — Identifica a janela real de cada fluxo, mede o atraso e separa falha de sincronização de expectativa não acordada.
- Fila sem prazo: o que exigir antes de contratar — O que definir em contrato e em operação quando itens podem ficar parados na fila sem prazo: envelhecimento, timeout, reprocessamento e responsabilidade.
- Erro de sincronização achado pelo cliente: o que reconstruir — Roteiro de investigação para um erro de sincronização relatado pelo cliente: linha do tempo do dado, decisão tomada, causa e responsável.
- Tabela de apoio sem dono: como atribuir responsabilidade — Descreve como identificar quem usa, quem altera e quem responde por uma tabela de apoio órfã, com critérios de posse, registro de mudanças e rotina de revisão.