Resposta direta
A resposta é criar um identificador próprio no primeiro ponto controlado pela operação e propagá-lo ao registro, à mensagem e ao log. Quando nem isso é possível, o rastro se apoia em chave natural, janela de tempo e número de lote. Nenhum deles, isolado, prova o que aconteceu; juntos, permitem reconstruir o caminho e localizar onde a execução parou. O critério de sucesso é responder, para um registro específico, o que foi enviado, o que foi recebido e quem respondeu por cada etapa, com acordo prévio sobre quem gera o identificador e por quanto tempo ele é mantido.
- Objetivo
- Orientar implementação
- Formato indicado
- Projeto de implementação
- Atualizado em
O que esta página acrescenta: Desenha o identificador próprio e a reconciliação por chave natural para execuções que não chegam com identificador do sistema de origem.
O ponto em que o registro muda de mãos
O identificador de execução costuma existir dentro de um sistema e desaparece quando o dado atravessa a fronteira. O sistema de origem registra a operação internamente, mas o arquivo, a mensagem ou a chamada que sai não carrega esse número. Do outro lado, o destino cria seu próprio registro e não tem como ligá-lo ao anterior.
Sem esse elo, o suporte compara horários e nomes. Funciona enquanto o volume é baixo e o caminho é único. Quando há reprocessamento, fila ou mais de uma origem, a comparação por horário deixa de distinguir o que foi enviado uma vez do que foi enviado duas. A divergência aparece na conciliação, não no momento da falha.
Identificador próprio e chave natural
A implementação começa pela escolha do ponto em que a operação controla o registro. Ali se gera um identificador próprio, com regra de unicidade e sem reutilização em reprocessamento. Esse identificador precisa acompanhar o dado, não apenas o log: no registro, na mensagem e no retorno do destino. Se ficar só no log, a execução tem história, mas o dado não.
Onde o identificador não pode ser propagado, a correlação usa chave natural, janela de tempo e número de lote. A chave natural precisa ser estável; documento, código interno ou combinação de campos que não mudam no ciclo. A janela e o lote delimitam o universo da comparação. A responsabilidade também precisa estar escrita: quem gera, quem armazena, quem corrige e até quando o rastro é mantido.
O que a estrutura não cobre
O identificador próprio não corrige dado errado na origem, não substitui validação na entrada e não prova entrega quando o destino não devolve confirmação. Também não resolve integração cujo problema é regra de negócio divergente entre as áreas. Nesses casos, o rastro mostra onde a falha ocorre, mas não elimina a causa.
Em operações pequenas, com um único caminho e volume estável, a reconciliação manual pode ser suficiente; criar identificador e manter log tem custo de desenvolvimento e de operação. Se a exigência é de trilha de auditoria com valor probatório, o desenho precisa ser validado por quem responde por compliance e auditoria. A estrutura organiza a evidência; não cria responsabilidade por si.
Recurso prático
Montagem do rastro sem identificador de origem
- Escolher o primeiro ponto controlado pela operação, normalmente a saída do sistema de origem ou a entrada da fila, e verificar quais campos chegam preenchidos em todos os registros.
- Gerar um identificador próprio nesse ponto, com regra de unicidade e sem reutilização em reprocessamentos, e gravá-lo no registro, na mensagem e no log.
- Definir a chave natural que identifica o mesmo registro nos dois sistemas e confirmar que ela não muda durante o ciclo de vida do dado.
- Acordar a janela de reconciliação e o número de lote como contexto para os casos em que o identificador próprio não chegou ao destino.
- Comparar origem e destino por chave natural dentro da janela e registrar cada diferença com horário, etapa e responsável pela correção.
O erro mais comum é gravar o identificador próprio apenas no log. O log fica completo e o dado continua sem rastro. A correlação passa a depender de horário e tentativa, justamente no caso em que a execução precisa ser provada.
Conceitos usados nesta página
- Trilha de auditoria — Trilha de auditoria é o conjunto de registros que permite reconstruir quem fez o quê, quando e com qual dado — inclusive depois que o resultado já foi usado.
Sobre o que está escrito aqui
Conceitos relacionados: identificador de execução · chave natural · número de lote · janela de reconciliação · trilha de auditoria. 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
- APIs e integração: o que perguntar antes de c… — sistema sem integração
- Dados desatualizados: o que precisa estar em dia — dados desatualizados
Páginas relacionadas
O mesmo problema em outro objetivo
- Integração sem identificador: como reconstruir a execução — Diagnosticar
- Integração sem identificador de execução: o que carimbar — Organizar um processo
- Integração sem identificador de execução: o que comparar — Comparar alternativas
- Integração sem identificador de execução: como medir — Explicar medição
- Integração sem identificador de execução: o que exigir — Orientar avaliação e contratação
Outras leituras em Integrações, sistemas e qualidade de dados
- Registro excluído sem trilha: como medir o que já sumiu — Medição de exclusões sem trilha: quais vestígios permitem estimar o volume, como separar os sinais e o que a contagem não consegue provar.
- Registro excluído sem trilha: como implantar o rastro — O que definir para que exclusões deixem rastro: eventos a registrar, onde guardar o histórico, retenção e responsabilidade pelo acesso.
- Cadastro sem regra de deduplicação: o que exigir no contrato — O que negociar, testar e aceitar na regra de deduplicação de um sistema de cadastro, incluindo o que o fornecedor declara e o que fica fora do escopo.
- Registro excluído sem trilha: o que ainda dá para reconstruir — O que verificar em logs, backups e telas de histórico para saber se um registro apagado pode ser recuperado e onde a trilha se rompeu.
- Cadastro sem chave única: o que exigir na contratação — O que exigir de um fornecedor de cadastro sem chave única: critérios de avaliação, responsabilidade sobre duplicidade e o que medir antes de assinar.