Resposta direta
O identificador de execução precisa estar no contrato, não só no log da ferramenta. Cada registro que entra na integração carrega um código do lote a que pertence; cada rodada tem contagem de entrada, contagem de saída e registro do que foi rejeitado. Com isso, uma divergência deixa de ser discussão e vira conferência: dá para saber qual execução gravou o quê, isolar o lote afetado e reprocessar apenas ele. O identificador não corrige dado errado na origem. Ele garante que a operação consiga localizar onde o dado passou, quem responde por cada etapa e o que foi entregue.
- Objetivo
- Orientar avaliação e contratação
- Formato indicado
- Projeto de implementação
- Atualizado em
O que esta página acrescenta: Trata o rastro de cada execução como cláusula de contrato e critério de aceite, com a evidência correspondente, em vez de tratar identificador como detalhe técnico
A diferença entre saber que falhou e saber onde falhou
Sem identificador de execução, o sistema informa que a carga terminou, mas não diz o que cada rodada gravou. Quando a conta não fecha, a conferência recomeça do zero, item por item, muitas vezes por fora do sistema. O trabalho vira arqueologia, e a resposta chega tarde.
Com o identificador, cada registro guarda a marca da rodada que o produziu. A pergunta deixa de ser onde está o erro e passa a ser qual lote gerou o item. A mesma marca permite repetir a carga sem duplicar o que já entrou e comprovar o que foi entregue, com data e horário.
O que a proposta precisa deixar verificável
A proposta precisa separar o que é recurso da ferramenta do que é obrigação contratual. Identificador por registro, identificador por lote, contagem na entrada e na saída, registro de rejeição com motivo e retenção do histórico de execuções. Cada item tem que aparecer com o formato do dado e por quanto tempo fica disponível depois da implantação.
O critério de aceite também se combina antes. Uma carga pequena, com contagem conferida nas duas pontas e um registro rejeitado de propósito, mostra se o rastro funciona. Sem esse teste, o identificador só é descoberto na primeira divergência real, quando já existe pressa e prejuízo.
O que o identificador não resolve
O identificador mostra o caminho do dado, não a qualidade dele. Se a origem grava data em dois formatos, ou se duas bases apontam para o mesmo cliente com regras diferentes, o rastro está correto e o número continua errado. Esse tipo de divergência nasce antes da integração e não se resolve com rastreio.
Ele também não cobre o que passa fora do fluxo. Planilha enviada por mensagem, ajuste feito à mão no sistema de destino e carga disparada por pessoa sem registro ficam invisíveis ao rastro. Quando isso é frequente, o problema é de processo e de responsabilidade. E o identificador não substitui um dono: alguém precisa decidir o que fazer com a divergência depois de localizada.
Recurso prático
O que prever na proposta e a evidência que permite conferir
| Item contratual | Evidência que permite conferir |
|---|---|
| Identificador único por registro, gravado também no sistema de destino | Permite seguir o mesmo item da origem ao destino sem depender do relatório de quem integrou |
| Identificador por lote ou execução | Permite isolar a rodada que gerou a divergência e repetir apenas ela |
| Contagem de registros na entrada e na saída de cada rodada | Expõe perda ou duplicação sem conferência manual item a item |
| Registro de rejeição com motivo e campo de origem | Mostra o que não passou, em qual campo, e permite corrigir na origem |
| Retenção do histórico de execuções pelo prazo do contrato | Permite reconstruir a trilha depois que o incidente já passou |
O erro mais comum é aceitar o identificador apenas no log da ferramenta de integração, sem que ele volte gravado no registro do sistema de destino. Nesse arranjo, a conferência termina no ambiente de quem integrou e não fecha com a operação.
Sobre o que está escrito aqui
Conceitos relacionados: identificador de execução · log por lote · contagem de registros na entrada e na saída · registro de rejeição com motivo · critério de aceite da carga. 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
- Cadastro sem chave única: onde o cruzamento f… — cadastro sem chave única
- Cadastro sem chave única: como escolher o ide… — cadastro sem chave única
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
- Sem identificador de execução: como a integração deixa rastro — Orientar implementação
Outras leituras em Integrações, sistemas e qualidade de dados
- Cadastros duplicados: o que exigir na contratação — Critérios operacionais para avaliar ferramentas ou serviços de deduplicação, definindo escopo, regras de merge e limites da contratação.
- Dado sensível em planilha compartilhada: o que sai do arquivo — O que restringir, o que tirar da planilha e como registrar responsável, finalidade e prazo de acesso quando o dado sensível precisa circular.
- Migração: comparar corte único, etapas e paralelo — Compara corte único, migração por etapas e operação em paralelo por interrupção, conferência, responsabilidade e dado que não pode ser recriado.
- Alteração sem registro: o que precisa virar histórico — Descreve como implementar registro de alterações: quais campos entram no histórico, onde capturar a gravação e qual o limite desse registro.
- 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.