📅 Data de publicação

02/04/2026

🎯 Objetivo

Orientar sobre o ajuste disponibilizado pela TOTVS para a NFS-e de São Paulo/SP no TSS, envolvendo a geração da tag cPaisPrestacao e a priorização das alíquotas do Configurador de Tributos no processo de montagem do XML. (TOTVS Developer Network)

🖥️ Ambiente

Produto: TSS
Linha de Produto: Transmissão de Documentos Eletrônicos
Segmento: Backoffice
Módulo: TSS Transmissão de Documentos Eletrônicos
Fontes envolvidos: TSSnfseXmlNac.prw, nfseXmlNac.prw, TSSnfseXmlEnv.prw e nfseXmlEnv.prw
País: Brasil. (TOTVS Developer Network)

🧩 Visão geral

A documentação técnica da TOTVS registra um ajuste para o cenário de NFS-e com Configuração de Tributos no padrão SED, em que a regra passou a priorizar as alíquotas do Configurador de Tributos em vez da natureza da operação. Além disso, foi corrigida a geração da tag cPaisPrestacao, para atender ao padrão exigido no manual da Prefeitura de São Paulo. (TOTVS Developer Network)

🔎 Situação identificada

Segundo a TOTVS, a tag cPaisPrestacao estava sendo gerada com o código do país do tomador, porém em formato diferente do padrão ISO exigido pelo manual da Prefeitura de São Paulo/SP. A orientação funcional é que essa tag:

• contenha o código do país no padrão ISO com duas letras maiúsculas;

• seja informada somente quando o serviço for prestado fora do Brasil. (TOTVS Developer Network)

✅ Solução aplicada pela TOTVS

A correção disponibilizada trouxe dois pontos principais:

1. Priorização das alíquotas do Configurador de Tributos

O fonte foi ajustado para priorizar as alíquotas PISRET, COFRET e CSL do Configurador de Tributos. Antes dessa alteração, a prioridade era dada à natureza. (TOTVS Developer Network)

2. Adequação da tag cPaisPrestacao ao padrão ISO

Também foi realizado ajuste para que a tag cPaisPrestacao siga o padrão ISO exigido pela Prefeitura de São Paulo/SP, eliminando a inconsistência de formatação identificada no XML. (TOTVS Developer Network)

🛠️ Fontes ajustados

De acordo com a página técnica, o ajuste foi realizado nos seguintes fontes:

• TSSnfsexmlenv.prw

• nfsexmlenv.prw. (TOTVS Developer Network)

📋 Impacto prático

Na prática, essa correção melhora a aderência do XML da NFS-e ao layout exigido pelo município de São Paulo e ajusta a regra de composição tributária para respeitar primeiro o Configurador de Tributos, o que tende a reduzir divergências de cálculo e inconsistências na geração do documento eletrônico. Essa conclusão decorre diretamente do problema e da solução descritos pela TOTVS. (TOTVS Developer Network)

🔍 Boas práticas

Para aplicar esse ajuste com segurança, recomenda-se:

• atualizar os fontes envolvidos no ambiente do TSS;

• validar a geração da tag cPaisPrestacao em operações com prestação fora do Brasil;

• conferir se o valor está sendo gerado em ISO de duas letras maiúsculas;

• revisar a configuração tributária para confirmar a priorização correta de PISRET, COFRET e CSL no Configurador de Tributos;

• executar testes de transmissão da NFS-e para o município de São Paulo/SP após a atualização.

Esses cuidados são coerentes com a correção técnica descrita na documentação oficial. (TOTVS Developer Network)

📌 Conclusão

O ajuste documentado pela TOTVS para a NFS-e de São Paulo/SP corrige a geração da tag cPaisPrestacao para o padrão ISO exigido pelo município e altera a regra de prioridade tributária, passando a considerar primeiro as alíquotas do Configurador de Tributos. Com isso, o TSS fica mais aderente ao layout municipal e ao comportamento esperado na composição tributária do XML. (TOTVS Developer Network)

❓ FAQ

1. Qual era o problema na tag cPaisPrestacao?

Ela estava sendo gerada com o código do país do tomador em formato diferente do padrão ISO exigido pelo manual da Prefeitura de São Paulo/SP. (TOTVS Developer Network)

2. Quando a tag cPaisPrestacao deve ser informada?

Somente quando o serviço for prestado fora do Brasil. (TOTVS Developer Network)

3. Qual formato deve ser usado na tag cPaisPrestacao?

Código do país em padrão ISO, com duas letras maiúsculas. (TOTVS Developer Network)

4. O que mudou na priorização dos tributos?

O ajuste passou a priorizar as alíquotas PISRET, COFRET e CSL do Configurador de Tributos; antes, a prioridade era a natureza. (TOTVS Developer Network)

5. Quais fontes foram ajustados?

Segundo a TOTVS, os ajustes foram realizados nos fontes TSSnfsexmlenv.prw e nfsexmlenv.prw. (TOTVS Developer Network)

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria

“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”