Quando um erro de documento eletrônico indica problema de cadastro e não de configuração?

No rollout, ó comum o mesmo erro aparecer em muitos documentos por um cadastro em massa incompleto. Antes de tratar um por um, agrupe os erros por mensagem e por parceiro ou material envolvido. Se muitos documentos compartilham o mesmo cadastro, corrija a fonte uma vez e reprocesse.

E aí, de qualquer forma, o que me ajudou foi criar uma tabela de erros conhecidos do projeto, com a mensagem, a origem provável e o passo de correção. No começo ela tem poucas linhas, depois vira o guia do suporte. Cada erro novo entra com a evidência de como foi resolvido. Quem é de desenvolvimento, como eu, só deve entrar depois de descartar cadastro e configuração, para não escrever código em cima de problema de dado.

Como todo mundo sabe, pois é, o texto da mensagem de erro costuma dizer onde olhar. Separe assim: se cita campo vazio ou código inexistente de parceiro ou material, é cadastro; se cita regra, imposto ou determinação não encontrada, é configuração; se cita data, número ou valor do próprio documento, é dado do documento. Anote a mensagem exata antes de tentar qualquer correção.

Um teste de eliminação ajuda:

1. repita o mesmo documento com outro cadastro; se o erro some, era cadastro;
2. repita com outro tipo de operação; se some, era configuração;
3. corrija o dado do documento e emita de novo.

O risco é, pois é mexer em tudo ao mesmo tempo e não saber o que resolveu.