Na retenção de ISS em João Pessoa, a alíquota precisa constar no documento fiscal, e como o SAP valida isso?

Concordo em parte, André, mas discordo de pular a leitura dos requisitos. Resumindo, pois é, são dois caminhos a avaliar: o ciclo curto serve quando o teste é inofensivo; a leitura prévia serve quando o dado enviado deixa protocolo e registros eletrônicos que podem ser consultados depois. Na retenção de ISS de João Pessoa, eu leria primeiro e testaria depois.

Será que a lista basta? Patrícia, discordo de montar tudo antes: então, de perto, o retorno do serviço é que mostra o que falta, e mandar a nota de teste diretamente já indica o campo que reprovou. Se a opção de envio direto estiver disponível, o ciclo curto de testar e ler a resposta ensina mais do que uma planilha longa sobre a retenção de ISS de João Pessoa. O documento reprovado vira o guia.

Se a nota for salva localmente, Felipe, vale completar: com a mão na massa, pois é, o que importa é anotar o que deveria constar em cada campo conforme o requisito antes de testar. Eu montaria uma lista de campos da retenção de ISS de João Pessoa com a regra ao lado, a mensagem de retorno esperada e o resultado obtido. Assim, quando o serviço rejeitar algo, a comparação sai pronta e o erro vira ponto de ajuste, não suposição.

A API valida no envio. Se não me engano, viu, a documentação da NFS-e Via descreve que a nota fica aberta para edição antes de seguir, e é nessa etapa que dá para conferir as regras de validação. Também dá para salvar o arquivo local em XML e só depois transmitir. O processamento é síncrono, então o retorno vem na hora, e os arquivos já processados podem ser consultados depois pelo protocolo. Isso vale se o fluxo de João Pessoa passar por lá, o que não confirmei para a retenção de ISS.

Dá para conferir a regra antes de gastar tentativa de envio. Um caminho a avaliar é ler os requisitos de validação da NFS-e Via e comparar campo a campo com a nota, pra não esquecer, ó, da retenção de ISS de João Pessoa. O outro é mandar pelo fluxo da concessionária e consultar o resultado através do protocolo de recebimento. O primeiro vale quando o envio tem custo operacional; o segundo, quando só a resposta do serviço decide. Eu começaria pelo primeiro.