TSS TOTVS: o que é, como atualizar o RPO e não parar a NF-e

O TSS (TOTVS Service SOA) é o componente que cuida da emissão e da transmissão dos documentos fiscais eletrônicos no Protheus e no RM. Manter esse serviço bem implantado e atualizado é o que garante que a sua empresa continue emitindo NF-e, NFC-e, CT-e e NFS-e sem travar.

Este guia reúne, num só lugar, o que é o TSS, a diferença entre as versões Protheus e RM, como implantar, como atualizar (inclusive o arquivo RPO) e como manter o ambiente seguro. E com a Reforma Tributária em transição, o tema fica mais sério: os documentos que o TSS transmite passam a carregar o IBS e a CBS, então um TSS desatualizado vira risco fiscal direto.

O que é o TSS TOTVS e qual a sua função?

O TOTVS Service SOA é um componente voltado à comunicação fiscal eletrônica em ambientes Protheus e RM. Ele isola e centraliza a troca de mensagens entre o ERP e os órgãos fiscais (Sefaz estaduais e prefeituras), cuidando da emissão, da recepção e da transmissão dos documentos fiscais eletrônicos, os DFe, como NF-e, NFC-e, CT-e, NFS-e e MDF-e.

A função principal do TSS é isolar, gerenciar e monitorar as conexões entre o ERP e as autoridades fiscais, mantendo a rastreabilidade de todos os eventos transmitidos ou recebidos. Na prática, ele é a camada que protege a operação contra autuações e atrasos, porque concentra num só lugar a parte mais sensível do fluxo fiscal.

Qual a diferença entre o TSS Protheus e o TSS RM?

As duas versões têm a mesma finalidade, mas mudam na arquitetura:

• TSS Protheus: é uma aplicação separada do ERP, altamente configurável. Tem base e parâmetros próprios e permite gerenciar cenários fiscais complexos, com mais controle sobre a emissão dos documentos.
• TSS no RM: é mais integrado ao sistema e oferece menos opções de personalização. É mais simples de operar, mas tem limitações para quem precisa de configurações avançadas.

Para empresas com operação fiscal robusta e muitos cenários tributários, o modelo separado do Protheus costuma dar mais flexibilidade. A escolha, porém, segue a linha de produto que a empresa já usa.

Como implantar o TSS no Protheus ou no RM?

A implantação envolve preparar a infraestrutura, instalar o serviço e configurá-lo no ambiente que já roda Protheus ou RM. O roteiro que aplicamos na WeePulse segue estas etapas:

1. Avaliar a arquitetura (nuvem ou local), a compatibilidade dos sistemas e os requisitos técnicos (versões, Java, paths, portas, firewall).
2. Instalar os pacotes do TSS na máquina designada, de preferência um servidor dedicado.
3. Configurar os parâmetros fiscais (CNPJ, UF, natureza da operação, CSC e token).
4. Definir rotas, endereço e portas para atender aos módulos do Protheus ou RM.
5. Testar a comunicação interna (ERP com TSS) e externa (TSS com Sefaz).
6. Cadastrar os certificados digitais (A1 ou A3), validando prazos e permissões.
7. Capacitar a equipe e documentar os procedimentos de contingência.

Uma instalação incompleta gera falhas em cadeia, que podem atrasar o faturamento e a escrituração. Por isso vale validar um checklist após cada etapa e contar com apoio técnico especializado.

Como o TSS emite e transmite os documentos fiscais?

O TSS funciona como canal intermediário entre o ERP e o Fisco. Depois de configurados os parâmetros e o certificado digital, o fluxo segue assim:

• o ERP envia as informações fiscais para o TSS;
• o TSS valida o leiaute e o XML (em ambiente de homologação ou produção);
• a transmissão segue para a Sefaz ou prefeitura pelo webservice apropriado;
• o retorno (autorização ou rejeição) é recebido e registrado para a escrituração e a geração do DANFE, do DANFCE ou do RPS.

Antes de operar em produção, vale rodar testes em ambiente controlado e treinar a equipe nos procedimentos de contingência, como o envio offline e a transmissão posterior quando a Sefaz está indisponível.

Como atualizar o TSS (binário, appserver.ini e RPO)?

Manter o TSS atualizado é o que garante que ele acompanhe as mudanças de leiaute e as novas notas técnicas. Sem isso, o risco de rejeição e de bloqueio na emissão cresce. O ciclo de atualização envolve o binário do serviço, o arquivo de configuração e o repositório de objetos (RPO).

O passo a passo seguro que recomendamos:

1. Pare o serviço do TSS e os aplicativos conectados, para não haver arquivos abertos durante a troca.
2. Faça backup completo: o arquivo RPO, os arquivos de configuração, a base associada e os XMLs e logs em processamento. É o que permite restaurar rápido se algo der errado.
3. Atualize o binário (appserver) com a versão correspondente à sua release, baixada do Portal do Cliente da TOTVS.
4. Ajuste o appserver.ini habilitando apenas os protocolos de segurança atuais. Use TLS 1.2 ou superior e mantenha o SSL2 e o SSL3 desativados, porque são obsoletos e inseguros.
5. Substitua o RPO: na pasta APO, faça backup do appserver.rpo atual e coloque a versão nova, correspondente à sua release do TSS.
6. Aplique patches apenas se necessário. Quando o repositório já é atualizado por completo, normalmente não é preciso aplicar o patch acumulado.
7. Reinicie o serviço e acompanhe o log de inicialização, conferindo se não há mensagens de erro.
8. Homologue: teste a emissão, a transmissão e o retorno de eventos (inclusive cenários de rejeição) antes de liberar a produção.

O que é o RPO do TSS e por que ele importa?

O RPO (Repositório de Objetos) é a biblioteca compilada que reúne as rotinas, telas e regras do TSS. É ele que contém o que o serviço precisa para funcionar. Um RPO defasado pode paralisar a emissão de documentos fiscais, porque deixa de ter as adequações legais e técnicas mais recentes. Por isso a atualização do RPO é parte central da manutenção do TSS, e nunca deve ser feita direto em produção, sempre passando por homologação primeiro.

Quais cuidados ter na atualização (compatibilidade e certificado)?

Boa parte das instabilidades no TSS vem de incompatibilidade entre versões. Antes e durante a atualização, vale garantir:

• Compatibilidade de versões entre o TSS, o ERP (Protheus ou RM) e o banco de dados, seguindo as recomendações da TOTVS.
• Certificado digital vigente: se a atualização exigir troca de certificado, valide o prazo e a compatibilidade antes. Certificado vencido impede a transmissão.
• Permissões de acesso: alguns ambientes exigem permissão administrativa para substituir o RPO. Planeje a janela de manutenção.
• Janela fora de pico e comunicação às áreas envolvidas.
• Plano de retorno: com o backup feito, é possível restaurar o RPO anterior caso a nova versão traga conflito.

Manutenção, backup e erros comuns do TSS

Erros de versão, conexão bloqueada e falha no certificado são imprevistos que afetam a gestão fiscal. Para reduzir o impacto:

• mantenha uma rotina de backup automático dos diretórios, principalmente XMLs e logs;
• automatize alertas de erro na integração entre o ERP e o TSS;
• teste a leitura e a renovação do certificado digital com antecedência, não só perto do vencimento;
• monitore bloqueios de firewall nas portas configuradas;
• documente os principais status e erros, o que agiliza o suporte.

Entre os problemas mais recorrentes estão: erros de comunicação com a Sefaz, certificados vencidos ou inválidos, portas bloqueadas pela rede, leiautes XML desatualizados e falhas de login do serviço. Para diagnosticar, vale checar se a origem é o TSS ou o ambiente externo (a própria Sefaz ou os servidores SVRS e SVAN podem estar instáveis), analisar os logs e validar tudo em homologação antes de mexer na produção. Quando o problema persiste, o caminho é acionar o suporte com apoio de uma consultoria especializada, como o serviço de AMS da WeePulse.

Segurança e conformidade fiscal

Além de manter o serviço atualizado, vale proteger o ambiente:

• restrinja o acesso ao servidor do TSS a pessoal treinado e autorizado;
• proteja o armazenamento do certificado digital;
• documente o procedimento de troca rápida do certificado, para evitar bloqueio por expiração;
• mantenha logs detalhados das transações, garantindo rastreabilidade em auditorias;
• conte com suporte técnico qualificado nas operações críticas, reduzindo o tempo de parada.

O TSS e a Reforma Tributária: por que isso fica mais crítico agora

O TSS transmite os documentos fiscais, e são justamente esses documentos que passam a carregar o IBS e a CBS durante a transição da Reforma Tributária. Isso conecta três frentes que precisam andar juntas no seu ambiente:

• o cálculo correto dos novos tributos, que nasce no Configurador de Tributos do Protheus;
• a release vigente, porque os leiautes e as adequações fiscais saem nas versões suportadas (veja como planejar a atualização do Protheus 12.1.2410);
• o TSS atualizado, que efetivamente transmite o documento com os novos campos.

Se você está acompanhando a Reforma, vale entender também o split payment no Protheus e o que muda com a Plataforma Pública de Split Payment. Manter o TSS em dia é parte de chegar preparado nessa virada.

Perguntas frequentes sobre o TSS TOTVS

O que é o TSS da TOTVS?

O TSS (TOTVS Service SOA) é o componente de comunicação fiscal dos ambientes Protheus e RM. Ele cuida da emissão, da recepção e da transmissão dos documentos fiscais eletrônicos (NF-e, NFC-e, CT-e, NFS-e e MDF-e), centralizando a comunicação com a Sefaz e as prefeituras de forma segura.

Qual a diferença entre o TSS Protheus e o TSS RM?

No Protheus, o TSS é uma aplicação separada do ERP, mais configurável e com base própria, indicada para cenários fiscais complexos. No RM, ele é mais integrado e simples, com menos opções de personalização.

Como atualizar o TSS no Protheus?

Pare o serviço, faça backup completo, atualize o binário do appserver com a versão da sua release, ajuste o appserver.ini para usar apenas TLS atual, substitua o RPO pela versão correspondente, aplique patches se necessário, reinicie o serviço e valide tudo em homologação antes da produção.

O que é o RPO do TSS e como atualizar?

O RPO (Repositório de Objetos) é o arquivo compilado com as rotinas do TSS. Para atualizar, confirme a compatibilidade de versões, faça backup, pare o serviço, substitua o appserver.rpo na pasta APO pela versão correta, reinicie e teste a emissão. Mantê-lo atualizado evita rejeições e falhas de transmissão.

Quais erros comuns ocorrem no TSS?

Os mais frequentes são erros de comunicação com a Sefaz, certificados digitais vencidos ou inválidos, portas bloqueadas pela rede, leiautes XML desatualizados e falhas de login do serviço. Automatizar alertas e manter a manutenção em dia reduz a ocorrência.

A atualização do TSS é obrigatória?

Na prática, sim. Sempre que há mudança de legislação, correção técnica ou novo leiaute, o TSS precisa ser atualizado para continuar emitindo em conformidade. Ficar desatualizado leva a bloqueios e rejeições.

Onde baixar as versões do TSS?

As versões do TSS são obtidas no Portal do Cliente da TOTVS, com acesso vinculado a um contrato válido. Use sempre os arquivos oficiais e a versão correspondente à sua release, evitando fontes de procedência duvidosa.

Mantenha seu TSS em dia com quem entende de TOTVS em operação

O TSS é um componente discreto, mas é ele que sustenta a sua emissão fiscal. Mantê-lo bem implantado, com o RPO atualizado e seguro, é o que evita a operação parar por um problema de transmissão. A WeePulse apoia empresas que já usam o TOTVS Protheus ou RM na implantação, na atualização e na sustentação (AMS) do TSS, com consultoria e suporte especializados. Falar com um especialista e mantenha a sua emissão rodando sem sustos.

Fontes

• Portal NFS-e (gov.br): evoluções e padronização da NFS-e nacional.
• Serpro: SPED: volume e papel do SPED no fisco digital.