Resposta direta
A resposta começa pelo relato do cliente, não pelo log da integração. O relato informa quando o dado errado virou decisão, e isso costuma vir antes de qualquer alarme técnico. A investigação reconstrói três pontos: qual era o valor correto, qual sistema o detinha e em que momento a troca falhou. Depois separa a causa (regra, dado de origem ou transporte) da consequência, que é o que o cliente já sofreu. Corrigir a causa sem tratar a consequência deixa o erro visível para o cliente por mais tempo. Se a origem do valor correto não for identificável, o problema é de responsabilidade sobre o dado, não de integração.
- Objetivo
- Diagnosticar
- Formato indicado
- Projeto de implementação
- Atualizado em
O que esta página acrescenta: Trata o relato do cliente como instrumento de diagnóstico e separa o reparo da causa do reparo da decisão tomada com o dado errado.
O relato do cliente como ponto de partida
Um erro de sincronização relatado pelo cliente chega com uma vantagem: já houve impacto real, então existe um caso concreto para examinar. A primeira providência é registrar a data em que o dado errado foi usado, não a data em que o cliente reclamou. Entre essas duas datas está o intervalo em que o erro circulou sem ser notado.
O relato também aponta a área que confiou no dado. Ouvir essa área antes de abrir o log evita que a investigação comece pelo transporte e ignore a origem. Em muitos casos o valor já estava errado no sistema de origem e a sincronização apenas o transportou.
Causa e consequência exigem reparos diferentes
Corrigir a integração devolve o fluxo ao normal. Não desfaz a decisão tomada com o dado errado, como um pedido enviado ou um cadastro alterado. São dois trabalhos distintos, com responsáveis diferentes e prazos próprios.
Vale separar por escrito o que é causa e o que é consequência. A causa pertence a quem opera a integração. A consequência costuma pertencer a quem atende o cliente. Sem essa divisão, a correção técnica avança e a pendência comercial fica parada.
O que a investigação não resolve
A investigação não devolve confiança perdida nem responde pelo que o cliente decidiu com base no dado errado. Também não elimina erros futuros: descreve o que aconteceu nesta troca, com as regras vigentes naquele momento.
Ela não se aplica quando não há registro de quando o dado mudou. Sem histórico, é possível descrever o erro atual, mas não reconstruir sua origem. Nesse caso, o trabalho vira definir o que passará a ser registrado daqui em diante.
Recurso prático
O que verificar no relato e o que a resposta define
| O que verificar | O que a resposta define |
|---|---|
| Quando o valor errado apareceu pela primeira vez | se o erro nasceu na sincronização ou antes dela |
| Qual sistema guardava o valor correto | onde aplicar a correção e quem responde pelo dado |
| Que decisão foi tomada com o valor errado | o que precisa ser refeito do lado do cliente |
O erro mais comum é tratar o chamado do cliente como falha técnica e abrir o log primeiro. O log mostra a troca, não a decisão tomada com o dado errado, e é essa decisão que o cliente cobra.
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.
Sobre o que está escrito aqui
Conceitos relacionados: log de integração · linha do tempo do erro · dado de origem · regra de sincronização · reprocessamento. 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
- Data em formato livre: como medir o que dá pa… — data registrada em formato livre
- Campo de data em texto livre: o que exigir ao… — data registrada em formato livre
Páginas relacionadas
O mesmo problema em outro objetivo
- Erro de sincronização visto pelo cliente: por onde começar — Organizar um processo
- Erro de sincronização visto pelo cliente: o que comparar — Comparar alternativas
- Erro que o cliente encontra: como medir a sincronização — Explicar medição
- Cliente achou erro de sincronização: como tratar na operação — Orientar implementação
- Erro descoberto pelo cliente: o que avaliar antes de contratar — Orientar avaliação e contratação
Outras leituras em Integrações, sistemas e qualidade de dados
- Relatório manual mensal: onde procurar a causa raiz — Mapeamento das causas que sustentam a montagem manual de relatórios e critérios para identificar se o gargalo está na regra, no dado ou na ferramenta.
- 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.
- Log de integração sem nível de erro: o que cada saída prova — Compara saídas para log de integração sem nível de erro: conciliação por totais, varredura por atributo, reprocessamento e classificação posterior.
- Log de integração sem nível de erro: o que exigir no contrato — Contrato de log de integração: níveis de severidade, campos obrigatórios, retenção, responsabilidade e teste de aceite com falha provocada.
- Integração que roda sozinha: quem responde quando falha — Define dono, registro e cadência de conferência para integrações que rodam sem supervisão, incluindo o que só o monitoramento não resolve.