Como o GUEPARDO Tax recebe os documentos fiscais do SAP?

Acho arriscado começar pela interface. Já vi estrutura bonita que nunca recebeu o retorno real da outra ponta. Eu seguraria a tela até existir um ensaio de ponta a ponta, e só então ordenaria as etapas. No fim, o ponto é registrar o motivo de cada exceção que a gente abre.

Na minha empresa a conversa começou pela tela, não pelo código. Como bem lembrou, quem recebe o retorno é a área de tributos, então primeiro vem o que ela precisa enxergar e reprocessar, e só depois o código que alimenta isso.

Complemento do lado de desenvolvimento, em lista:

1. Primeiro, olhando o XML, ó, confira o que foi montado antes do envio.
2. Guarde o identificador que volta do ambiente tributário e amarre ao documento de origem.
3. Trate retorno de erro como caso de teste, não como exceção.

Não descreveria o trajeto sem olhar como cada cliente foi montado, porque muda de projeto para projeto. Começaria mapeando, para cada gatilho, três coisas:

1. Qual documento dispara o gatilho.
2. Em que momento ele sai: na gravação, na liberação ou em lote.
3. Onde a resposta volta e como o erro aparece ao usuário.

Com o mapa pronto, agora, e olha que isso evita muito achismo, a conversa com a equipe de tributos fica curta.