Data de publicação: 17/07/2026

🎯 Objetivo

Orientar a atualização e a configuração do TOTVS Service SOA (TSS) e do TOTVS Backoffice – Linha Protheus para transmissão de NFS-e pelo provedor GissOnline, considerando o novo leiaute relacionado à Reforma Tributária do Consumo (RTC) e os principais erros já mapeados pela TOTVS.

🧩 Ambiente

Cross Segmentos – TSS Transmissão de Documentos Eletrônicos – Todas as versões. (Central de Atendimento TOTVS)

🔎 Visão geral

O provedor GissOnline utiliza versões distintas de leiaute de acordo com o município responsável pela emissão da NFS-e. No Wizard.cfg, a TOTVS indica atualmente duas opções principais:

• 2.04_RT, utilizada por municípios como Guarulhos, São José do Rio Preto, Maceió, Jundiaí, Diadema, Itu, Santos, São Caetano do Sul e Campos dos Goytacazes, entre outros;

• 3.01, utilizada por municípios como Santo André, São Bernardo do Campo e Hortolândia, entre outros. (Central de Atendimento TOTVS)

A escolha da versão não deve ser feita somente com base no provedor. É necessário verificar qual leiaute foi adotado pelo município para evitar rejeições decorrentes de estrutura XML incompatível.

O novo leiaute também passa a validar informações adicionais relacionadas à RTC, incluindo dados de IBS, CBS, NBS e outros elementos exigidos na composição da NFS-e. (Central de Atendimento TOTVS)

⚙️ Atualizações necessárias

Antes de reconfigurar o município no Protheus, é indispensável atualizar os componentes do TSS e do Protheus.

1. 🖥️ Atualizações no TSS

1.1 Atualização do repositório

O repositório de objetos do TSS deve ser atualizado com o pacote indicado pela TOTVS para atendimento ao novo leiaute do GissOnline. (Central de Atendimento TOTVS)

A aplicação do pacote deve seguir o procedimento padrão de atualização do ambiente, respeitando:

• cópia de segurança do RPO atual;

• aplicação inicialmente em homologação;

• reinicialização dos serviços envolvidos;

• validação dos logs após a atualização.

1.2 Atualização dos schemas

Os arquivos .XSD correspondentes à release do ambiente devem ser incluídos na pasta SCHEMAS do TSS.

A TOTVS disponibiliza pacotes específicos para:

• release 12.1.2410;

• release 12.1.2510. (Central de Atendimento TOTVS)

Os schemas são utilizados para validar a estrutura do XML antes e durante o processo de transmissão. Arquivos desatualizados podem causar rejeições de schema mesmo quando os dados fiscais estiverem corretamente preenchidos.

1.3 Atualização do arquivo tssnewnfse.json

Também deve ser atualizado o arquivo:

tssnewnfse.json

Esse arquivo deve ser colocado na pasta SYSTEM do TSS, utilizando o pacote correspondente à release instalada:

• 12.1.2410; ou

• 12.1.2510. (Central de Atendimento TOTVS)

Deve ser incluído somente o arquivo indicado, evitando copiar indiscriminadamente outros conteúdos para a pasta SYSTEM.

1.4 Ambientes TSS compartilhados

Segundo a TOTVS, os ambientes de TSS compartilhado já contemplam as atualizações necessárias do próprio TSS. Nesses casos, ainda devem ser verificadas as atualizações e configurações do ambiente Protheus. (Central de Atendimento TOTVS)

2. 🧱 Atualizações no Protheus

2.1 Atualização do NFSEXMLENV

Deve ser compilada a versão mais recente do rdmake:

NFSEXMLENV

Esse fonte participa da montagem e do envio das informações da NFS-e e precisa estar compatível com o novo leiaute. (Central de Atendimento TOTVS)

Antes da compilação, recomenda-se:

• confirmar a compatibilidade do fonte com a release;

• preservar cópia do objeto anteriormente compilado;

• validar se existem customizações locais;

• compilar primeiro em homologação.

2.2 Aplicação do pacote correspondente à release

Além do rdmake, deve ser aplicado o pacote oficial destinado à release do Protheus:

• 12.1.2410; ou

• 12.1.2510. (Central de Atendimento TOTVS)

A atualização deve ser tratada como um conjunto. Atualizar somente o TSS, sem atualizar o Protheus, pode manter incompatibilidades na geração do XML.

🛠️ Reconfiguração do GissOnline no Protheus

Após concluir as atualizações, o município deve ser reconfigurado integralmente.

1. Acessar a rotina FISA022

No Protheus, acesse a rotina:

FISA022

Em seguida, abra o Wizard.cfg referente ao município que utiliza o provedor GissOnline.

2. Refazer completamente a configuração

A TOTVS orienta reconfigurar o wizard por completo, e não apenas alterar pontualmente a versão do leiaute. (Central de Atendimento TOTVS)

Na configuração, informe:

• Modelo: 1 - NFS-e Prefeitura;

• Versão: 2.04_RT ou 3.01, conforme o município;

• demais dados de autenticação, série, ambiente e parâmetros exigidos pelo provedor.

3. Validar a versão correta do município

A versão deve ser definida com base na listagem oficial de municípios atendidos pelo provedor.

Exemplos:

A relação acima é exemplificativa. A versão efetivamente adotada deve ser confirmada na documentação oficial atualizada. (Central de Atendimento TOTVS)

4. Emitir uma nova nota do zero

Depois da reconfiguração, a TOTVS orienta transmitir uma nova NFS-e criada do zero. (Central de Atendimento TOTVS)

Não é recomendável utilizar somente uma nota anteriormente rejeitada como teste inicial, pois ela pode manter dados ou estruturas gerados antes da atualização.

⚠️ Erros mapeados

1. Erro E160 – Arquivo em desacordo com o XML Schema

Mensagem

E160 - Arquivo em desacordo com o XML Schema

Possíveis causas

Esse erro indica que o XML gerado não está compatível com o schema esperado pelo provedor. Entre as causas mais comuns estão:

• schemas desatualizados na pasta do TSS;

• arquivo tssnewnfse.json incompatível com a release;

• RPO do TSS desatualizado;

• pacote do Protheus não aplicado;

• versão incorreta selecionada no Wizard.cfg;

• XML gerado antes da atualização do ambiente.

A TOTVS mantém uma orientação específica para o tratamento da rejeição E160 nos provedores GissOnline/Ginfes. (Central de Atendimento TOTVS)

Tratamento recomendado

1. Confirmar a versão utilizada pelo município.

2. Atualizar o RPO do TSS.

3. Atualizar os schemas.

4. Atualizar o tssnewnfse.json.

5. Atualizar e recompilar os componentes do Protheus.

6. Refazer o Wizard.cfg.

7. Gerar uma nova nota fiscal.

2. Erro 9999 – Valor retido de CSLL informado para tipo de retenção sem CSLL

Mensagem

9999 - Valor retido de CSLL informado para tipo de retenção sem CSLL

Causa

A rejeição ocorre quando a tag:

<tpRetPisCofins>

é gerada com conteúdo 1 ou 2, representando retenção somente de PIS e COFINS, enquanto o XML também possui valor retido de CSLL.

Segundo a TOTVS, esse comportamento pode ocorrer quando o parâmetro MV_NT007 está configurado como .F.. (Central de Atendimento TOTVS)

Correção

Criar ou alterar o parâmetro:

MV_NT007 = .T.

Também deve ser conferido se os títulos de PCC retidos foram corretamente gerados na tabela SE1. (Central de Atendimento TOTVS)

Para retenção na emissão:

MV_NFSEPCC = F

Para retenção na baixa:

MV_NFSEPCC = T

A configuração deve refletir o momento efetivo em que a empresa realiza a retenção. (Central de Atendimento TOTVS)

3. Erro 9999 – Valor de PIS inconsistente com alíquota

Mensagem

9999 - Valor de PIS inconsistente com alíquota

Causa

A rejeição pode ocorrer em empresas enquadradas no Lucro Real, quando existem cálculos de PCC retido e apuração com alíquotas diferentes entre os impostos. (Central de Atendimento TOTVS)

Correção

A TOTVS indica verificar:

MV_NT007 = .T.

Também é necessário confirmar:

• geração correta dos títulos de PCC retido na SE1;

• MV_NFSEPCC = F quando a retenção ocorre na emissão;

• MV_NFSEPCC = T quando a retenção ocorre na baixa. (Central de Atendimento TOTVS)

Caso o ambiente esteja configurado para retenção na emissão, mas os títulos não sejam gerados corretamente na SE1, a equipe fiscal deve analisar a escrituração e a configuração tributária que originou os títulos. (Central de Atendimento TOTVS)

📋 Resumo dos parâmetros envolvidos

A configuração deve ser validada em conjunto com a área fiscal, pois depende do momento e da forma como a empresa reconhece as retenções.

✅ Checklist de implantação

Antes de liberar a transmissão em produção, valide:

•  RPO do TSS atualizado;

• schemas atualizados na pasta SCHEMAS;

• arquivo tssnewnfse.json atualizado na pasta SYSTEM;

• último NFSEXMLENV compilado;

•  pacote correspondente à release aplicado no Protheus;

•  versão correta do município confirmada;

• Wizard.cfg refeito completamente;

• modelo 1 - NFS-e Prefeitura configurado;

• parâmetros MV_NT007 e MV_NFSEPCC revisados;

• títulos de PCC retido conferidos na SE1;

•  nova NFS-e gerada do zero em homologação;

•  XML validado antes da liberação em produção.

✅ Resultado esperado

Após a atualização conjunta do TSS e do Protheus, a reconfiguração completa do Wizard.cfg e a seleção do leiaute correto, o ambiente estará preparado para transmitir NFS-e pelo GissOnline de acordo com as novas validações da RTC.

A emissão deverá contemplar as informações fiscais exigidas pelo novo leiaute, incluindo os dados relacionados a IBS, CBS, NBS e retenções aplicáveis. (Central de Atendimento TOTVS)

💡 Boas práticas

• aplicar as atualizações inicialmente em homologação;

• realizar backup dos repositórios e arquivos de configuração;

• documentar a versão de leiaute adotada por município;

• não misturar arquivos de releases diferentes;

• gerar uma nova nota após a reconfiguração;

• validar a existência dos títulos de retenção na SE1;

• envolver a equipe fiscal quando houver divergência entre cálculo, escrituração e títulos financeiros;

• registrar evidências do XML, retorno do provedor e configuração utilizada.

❓ FAQ

1. Qual versão deve ser configurada para o GissOnline?

Depende do município. As versões atualmente indicadas pela TOTVS são 2.04_RT e 3.01. (Central de Atendimento TOTVS)

2. É suficiente alterar somente a versão no Wizard?

Não. A orientação é atualizar os componentes necessários e reconfigurar completamente o Wizard.cfg. (Central de Atendimento TOTVS)

3. Qual modelo deve ser selecionado?

Deve ser utilizado:

1 - NFS-e Prefeitura

(Central de Atendimento TOTVS)

4. Preciso atualizar o TSS compartilhado?

A TOTVS informa que os ambientes de TSS compartilhado já contemplam as atualizações do TSS. Ainda assim, o Protheus e sua configuração devem ser revisados. (Central de Atendimento TOTVS)

5. O que significa o erro E160?

Significa que o arquivo gerado está em desacordo com o XML Schema esperado pelo provedor. (Central de Atendimento TOTVS)

6. Como tratar o erro de CSLL para tipo de retenção sem CSLL?

Deve-se revisar MV_NT007, MV_NFSEPCC e confirmar se os títulos de PCC retido foram gerados corretamente na SE1. (Central de Atendimento TOTVS)

7. Depois da atualização, posso retransmitir apenas a nota rejeitada?

Para a validação inicial, a TOTVS recomenda gerar e transmitir uma nova nota do zero. (Central de Atendimento TOTVS)

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria

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