Como documentar ABAP fiscal e customização fiscal para uma auditoria?

Bruno, nossa equipe adotou um caminho diferente: o comentário no próprio código aponta para o chamado, e a página sai gerada a partir dele. Pelo que testei, viu, funciona bem quando a customização é nova e o time ABAP mantém disciplina. Para legado sem autor, a página manual da Alexandre segue melhor, porque alguém precisa ler o código e reconstruir a intenção. Na auditoria, o log de transporte mostra 'objeto liberado, chamado vinculado', e isso responde a maioria das perguntas. Para documentar o legado, vale o esforço manual.

Uma página por customização não pesa demais? Então, pra ser justo, em mineração temos centenas de enhancements pequenos, e a auditoria não quer ler tudo. Discordo de documentar com o mesmo peso o que é leve e o que mexe na apuração. Aqui a customização crítica ganha página completa, e o resto entra numa tabela de inventário com dono, objetivo e data da última revisão. No log de teste fica uma linha simples, tipo 'exit executada, sem erro'.

Concordo em parte com o inventário da Roberta, mas discordo de deixar o resto sem texto algum. Voltando ao ponto, né, no nosso ECC 6.0 de comércio eletrônico as customizações antigas não têm autor nem chamado. Roberta, como vocês revisam esse inventário quando a alteração é herdada e ninguém lembra do requisito? Alexandre, a sua página parte do código ou do requisito? A auditoria daqui cobra explicação formal de cada mudança, e eu teria de documentar de trás para frente.

No meu dia a dia na química, a regra é uma página por customização, ligada ao chamado que a originou. Foi o que resolveu a última auditoria: o auditor abriu o objeto, viu a ordem de transporte e achou a página em um clique. Ela diz o que o código faz, qual dado fiscal ele lê e qual teste provou o resultado. Com a mão na massa, ó, o log do teste vai anexado, algo como 'ordem liberada, cenário de nota de saída aprovado'. Para documentar assim, o requisito entra antes do código.