📅 Data de publicação

02/04/2026

🎯 Objetivo

Orientar a configuração do TSS (TOTVS Service SOA) para transmissão de NFS-e via Web Service utilizando o recurso NewNfse, conforme procedimento oficial da TOTVS. (Central de Atendimento TOTVS)

🖥️ Ambiente

Cross Segmentos - Backoffice Protheus - TSS
Aplicação: NFS-e
Abrangência: Todas as versões. (Central de Atendimento TOTVS)

🧩 Visão geral

A configuração do NewNfse no TSS é feita por meio da carga do arquivo tssNewNfse.JSON na pasta system do TSS. Após o processamento, o sistema consome esse arquivo, remove-o da pasta e cria estruturas de controle que determinam se o município utilizará o fluxo New NFS-e ou o fluxo padrão do TSS. (Central de Atendimento TOTVS)

⚙️ Como funciona a configuração

Durante a implantação do NewNfse, o TSS processa o arquivo tssNewNfse.JSON, cria e popula a tabela TSS0013 com os municípios adequados para uso da New NFS-e e atualiza automaticamente o parâmetro MV_NEWNFSE. Esse parâmetro passa a definir o fluxo de transmissão, consulta e cancelamento da NFS-e no ambiente. (Central de Atendimento TOTVS)

Além disso, o conteúdo do parâmetro MV_NEWNFSE depende da relação entre o município configurado na entidade do TSS e os municípios existentes na tabela TSS0013. Quando o município estiver presente nessa tabela, o parâmetro recebe "S"; caso contrário, recebe "N". (Central de Atendimento TOTVS)

✅ Procedimento de configuração

1. Parar o serviço do TSS

Antes de iniciar o processo, interrompa o serviço do TSS para evitar bloqueios durante a atualização do ambiente. (Central de Atendimento TOTVS)

2. Extrair o arquivo tssNewNfse.JSON

Acesse a pasta de instalação do TSS, extraia o arquivo tssNewNfse.JSON e grave-o na pasta system do TSS. (Central de Atendimento TOTVS)

3. Validar as propriedades do arquivo

Clique com o botão direito no arquivo e verifique suas propriedades. Caso a opção “somente leitura” esteja marcada, desmarque-a antes de prosseguir. (Central de Atendimento TOTVS)

4. Reiniciar o serviço do TSS

Reinicie o serviço do TSS para que o arquivo tssNewNfse.JSON seja lido, processado e excluído automaticamente da pasta system. (Central de Atendimento TOTVS)

5. Validar o consumo do arquivo

Se o arquivo não for apagado da pasta system, acesse a APSDU do TSS, filtre a tabela SPED000, apague o conteúdo do parâmetro MV_VERNFSE e execute novamente o procedimento. (Central de Atendimento TOTVS)

6. Reiniciar novamente o serviço

Após concluir o ajuste, reinicie mais uma vez o serviço do TSS para garantir a aplicação correta da configuração. (Central de Atendimento TOTVS)

🗂️ Estruturas e parâmetros envolvidos

Tabela TSS0013

Após a implantação da New NFS-e, o ambiente passa a contar com a tabela TSS0013, utilizada para armazenar os municípios adequados ao uso desse novo fluxo. (Central de Atendimento TOTVS)

Parâmetro MV_NEWNFSE

O parâmetro MV_NEWNFSE é criado automaticamente no ambiente do TSS, na tabela de parâmetros SPED000, e define se a entidade utilizará o fluxo New NFS-e ou o fluxo padrão. (Central de Atendimento TOTVS)

Regra de preenchimento do MV_NEWNFSE

A TOTVS informa que a atualização do MV_NEWNFSE ocorre automaticamente após a leitura do tssNewNfse.JSON e a criação da tabela TSS0013. A verificação considera o conteúdo do parâmetro MV_NFSEMUN da entidade, comparando-o com o campo COD_MUN da tabela TSS0013. (Central de Atendimento TOTVS)

🔍 Validação complementar

Para identificar se determinado município está homologado para uso da NewNfse, deve-se consultar a relação de municípios homologados e observar, no campo “Versão TSS Implementação”, a sigla NW. (Central de Atendimento TOTVS)

🛠️ Boas práticas

Para evitar falhas na implantação, recomenda-se:

• garantir que o serviço do TSS esteja realmente parado antes da cópia do arquivo;

• confirmar que o arquivo tssNewNfse.JSON não esteja com atributo de somente leitura;

• validar se o arquivo foi consumido e removido da pasta system;

• conferir a criação da tabela TSS0013;

• validar o preenchimento automático do parâmetro MV_NEWNFSE após o processamento.

Esses cuidados seguem diretamente o comportamento esperado descrito pela TOTVS para a ativação do fluxo New NFS-e. (Central de Atendimento TOTVS)

📌 Conclusão

A configuração do NewNfse no TSS depende do processamento correto do arquivo tssNewNfse.JSON, da criação da tabela TSS0013 e da atualização automática do parâmetro MV_NEWNFSE. Quando esse fluxo é implantado corretamente, o ambiente passa a decidir de forma automática se a entidade utilizará o modelo New NFS-e ou o fluxo padrão do TSS, de acordo com o município configurado. (Central de Atendimento TOTVS)

❓ FAQ

1. Onde devo colocar o arquivo tssNewNfse.JSON?

Na pasta system do TSS, após extraí-lo da pasta de instalação. (Central de Atendimento TOTVS)

2. O arquivo deve permanecer na pasta system?

Não. Após o processamento correto, o TSS deve consumir e excluir o arquivo da pasta system. (Central de Atendimento TOTVS)

3. O que fazer se o arquivo não for apagado?

Acesse a APSDU do TSS, filtre a tabela SPED000, limpe o conteúdo do parâmetro MV_VERNFSE e refaça o processo. (Central de Atendimento TOTVS)

4. Qual parâmetro controla o uso do fluxo New NFS-e?

O parâmetro MV_NEWNFSE. Ele define se a transmissão, consulta e cancelamento da NFS-e seguirão o fluxo New NFS-e ou o fluxo padrão. (Central de Atendimento TOTVS)

5. Como saber se um município usa NewNfse?

É necessário consultar a relação de municípios homologados e verificar a sigla NW no campo “Versão TSS Implementação”. (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.”