📅 Data de publicação

02/04/2026

🎯 Objetivo

Orientar a adequação do TSS para a NFS-e do município de Guarujá/SP, com foco nas mudanças da Reforma Tributária no provedor GissOnline, utilizando a opção 2.04_RT. A documentação informa que a implementação contempla os métodos de envio e consulta. (TOTVS Developer Network)

🖥️ Ambiente

Produto: TSS
Linha de produto: Protheus
Segmento: Serviços
Módulo: NFSE
Funções envolvidas: newNfseGissOnline204_RT.prw, nfse_v2.04_rt_3518701.xsd e tssnewnfse.json. (TOTVS Developer Network)

🧩 Visão geral

A página técnica da TOTVS registra a adequação da RTC para a Prefeitura de Guarujá/SP, em razão da inclusão de novas tags XML exigidas no contexto da Reforma Tributária. A orientação é utilizar, a partir de 19/02/2026, o provedor GissOnline com a opção 2.04_RT. (TOTVS Developer Network)

Essa atualização introduz grupos e tags voltados à tributação federal, carga tributária aproximada e ao novo bloco de IBS/CBS, exigindo alinhamento entre o TSS e o ERP Protheus para geração correta do XML. (TOTVS Developer Network)

🔎 Situação atendida

Segundo a documentação, a Prefeitura de Guarujá/SP disponibilizou a inclusão de novas tags para adequação à Reforma Tributária. A implantação realizada pela TOTVS abrangeu os métodos de:

• Envio

• Consultas. (TOTVS Developer Network)

✅ Solução aplicada

A TOTVS orienta que, para esse cenário, seja utilizada a opção 2.04_RT do provedor GissOnline. Essa adequação passa a considerar novos grupos XML para suportar as exigências tributárias da NFS-e no contexto da reforma. (TOTVS Developer Network)

🧱 Novos grupos e tags XML

1. Grupo <trib>

Esse grupo é responsável por detalhar os impostos incidentes e a carga tributária estimada da operação. (TOTVS Developer Network)

1.1 Subgrupo <tribFed>

O subgrupo <tribFed> reúne os dados de PIS e COFINS, com as seguintes informações:

• CST: código de situação tributária;

• vBCPisCofins: base de cálculo;

• pAliqPis: alíquota de PIS;

• pAliqCofins: alíquota de COFINS;

• vPis: valor do PIS;

• vCofins: valor da COFINS;

• tpRetPisCofins: tipo de retenção. (TOTVS Developer Network)

1.2 Subgrupo <totTrib>

Esse subgrupo é utilizado para informar a carga tributária aproximada ao consumidor. Segundo a TOTVS, ele contempla:

• <pTotTrib>: percentuais estimados para empresas do Regime Normal;

• <pTotTribSN>: percentual total pago por empresas do Simples Nacional. (TOTVS Developer Network)

2. Grupo <IBSCBS>

O grupo <IBSCBS> foi introduzido para identificar as operações relacionadas a IBS e CBS. Entre as tags destacadas pela documentação estão:

• finNFSe: finalidade da emissão;

• indFinal: indicador de consumidor final;

• cIndOp: indicador da operação;

• tpOper: tipo da operação;

• tpEnteGov: ente governamental recebedor do tributo;

• indDest: indicador de destino. (TOTVS Developer Network)

⚠️ Exigência a partir de 2026

A documentação técnica informa que, a partir de 2026, a transmissão da NFS-e exigirá obrigatoriamente o cálculo de IBS e CBS. Com isso, a geração dessas tags passa a depender da parametrização realizada no Configurador de Tributos (FISA170). (TOTVS Developer Network)

🔄 Dependências no ERP Protheus

A TOTVS orienta verificar se o fonte TSSnfsexmlenv.prw está atualizado com data igual ou superior a 27/01/2026, para garantir a correta integração das novas tags no XML enviado pelo TSS. (TOTVS Developer Network)

Além disso, a geração de informações do bloco IBSCBS depende do correto preenchimento no ERP:

• a tag cIndOp tem origem no Configurador de Tributos (FISA170), em Regras de Cálculo Documento Fiscal > Cadastro Regras de Escrituração > campo Indic. Opera (CJ2_INDOP);

• a tag cClasTrib também tem origem no FISA170, em Regras de Cálculo Documento Fiscal > Cadastro Regras de Escrituração > campo Class Trib. (CJ2_CSTCCT);

• a tag NBS é obtida no Cadastro de Complemento de Produto (SB5), campo B5_NBS. (TOTVS Developer Network)

🛠️ Procedimento recomendado

Para implantação segura dessa adequação, recomenda-se:

1. validar se o município e o provedor correspondem ao cenário Guarujá/SP – GissOnline;

2. configurar o uso da opção 2.04_RT no TSS;

3. conferir se os fontes e artefatos técnicos do TSS estão atualizados;

4. validar no Protheus a atualização do fonte TSSnfsexmlenv.prw;

5. revisar a parametrização tributária no FISA170 para cálculo de IBS e CBS;

6. conferir os campos que alimentam as tags cIndOp, cClasTrib e NBS;

7. executar testes de envio e consulta da NFS-e após a atualização.

Esses cuidados decorrem diretamente dos requisitos técnicos descritos pela TOTVS para essa adequação. (TOTVS Developer Network)

🔍 Boas práticas

Para evitar rejeições ou XML incompleto, é importante:

• manter o TSS na versão com suporte ao layout 2.04_RT;

• garantir o cálculo correto de IBS e CBS no ERP;

• revisar os cadastros e regras de escrituração antes da transmissão;

• confirmar a origem dos dados tributários que alimentam o XML;

• validar o XML gerado com base no layout atualizado do provedor. (TOTVS Developer Network)

📌 Conclusão

A adequação da RTC para Guarujá/SP no TSS exige atualização técnica voltada ao layout GissOnline 2.04_RT, incluindo novos grupos XML relacionados à Reforma Tributária. A partir de 19/02/2026, esse cenário passa a considerar novas tags e, desde 2026, a transmissão da NFS-e exige o cálculo de IBS e CBS, tornando indispensável a correta parametrização do FISA170 e a atualização dos fontes do Protheus e do TSS. (TOTVS Developer Network)

❓ FAQ

1. Qual município é atendido por essa adequação?

A adequação documentada é específica para Guarujá/SP. (TOTVS Developer Network)

2. Qual provedor deve ser utilizado nesse cenário?

O provedor indicado é o GissOnline, com uso da opção 2.04_RT. (TOTVS Developer Network)

3. Quais métodos foram implantados?

A documentação informa suporte aos métodos de envio e consultas. (TOTVS Developer Network)

4. O cálculo de IBS e CBS é obrigatório?

Sim. A TOTVS informa que, a partir de 2026, a transmissão da NFS-e exigirá obrigatoriamente o cálculo de IBS e CBS. (TOTVS Developer Network)

5. Onde é parametrizada a tag cIndOp?

No Configurador de Tributos (FISA170), em Regras de Cálculo Documento Fiscal > Cadastro Regras de Escrituração > campo Indic. Opera (CJ2_INDOP). (TOTVS Developer Network)

6. Onde é parametrizada a tag cClasTrib?

Também no FISA170, em Regras de Cálculo Documento Fiscal > Cadastro Regras de Escrituração > campo Class Trib. (CJ2_CSTCCT). (TOTVS Developer Network)

7. De onde vem a tag NBS?

Do Cadastro de Complemento de Produto (SB5), campo B5_NBS. (TOTVS Developer Network)

8. Qual fonte do Protheus deve ser validado?

O fonte TSSnfsexmlenv.prw deve estar com data igual ou superior a 27/01/2026. (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.”