📅 Data de publicação
02/04/2026
🎯 Objetivo
Orientar o processo de instalação e atualização do TSS Off-Line no Windows, apresentando as etapas de implantação e os cuidados técnicos recomendados para evitar problemas de configuração no ambiente. (TDN - TOTVS Developer Network)
🖥️ Ambiente
TOTVS Service SOA (TSS)
Modalidade: Off-Line
Plataforma: Windows. (TDN - TOTVS Developer Network)
🧩 Visão geral
O TSS Off-Line é definido pela TOTVS como um aplicativo client-side, executado no lado do cliente, com a finalidade de atuar em contingência quando houver eventual queda de comunicação. Já o TSS On-Line é um aplicativo server-side, responsável pela comunicação e transmissão de documentos eletrônicos. (TDN - TOTVS Developer Network)
Na instalação ou atualização do TSS Off-Line, a TOTVS orienta executar o instalador TSS.exe como administrador e recomenda que, em cenários de atualização, o arquivo appserver.ini não seja simplesmente substituído por versões antigas; os ajustes devem ser feitos manualmente após a instalação, quando necessário. (TDN - TOTVS Developer Network)
✅ Procedimento de instalação e atualização
1. Executar o instalador como administrador
Execute o arquivo TSS.exe com privilégios de administrador, tanto para nova instalação quanto para atualização. Em seguida, selecione o idioma desejado para a instalação. (TDN - TOTVS Developer Network)
2. Avançar na tela inicial e aceitar o contrato
Após a abertura do assistente, avance pela tela de boas-vindas, leia o contrato de licença e, caso concorde com os termos, prossiga com a instalação. Se a opção for não aceitar, o processo é encerrado. (TDN - TOTVS Developer Network)
3. Definir a pasta de instalação
Selecione o diretório de instalação do TSS. Conforme a documentação, o caminho padrão é:
C:\totvssped\ (TDN - TOTVS Developer Network)
4. Selecionar o tipo de instalação
Na etapa de tipo de instalação, escolha TSS Off-Line. Esse modo é destinado ao uso em contingência no lado cliente. (TDN - TOTVS Developer Network)
5. Definir o idioma do repositório
Escolha o idioma que será utilizado no repositório do TSS. (TDN - TOTVS Developer Network)
6. Configurar o serviço HTTP
Configure os campos de Servidor e Porta do serviço HTTP disponibilizado pelo TSS. A TOTVS orienta que no campo Servidor seja informado o IP do servidor onde a instalação está sendo realizada. Se for informado LOCALHOST, o acesso ficará restrito apenas à própria máquina onde o TSS está instalado, sem visibilidade para outras máquinas da rede. (TDN - TOTVS Developer Network)
7. Configurar a comunicação entre TSS Off-Line e TSS On-Line
Depois de preencher os campos de servidor e porta, avance com a configuração referente à comunicação entre o TSS Off-Line e o TSS On-Line. (TDN - TOTVS Developer Network)
8. Selecionar os programas a instalar
Escolha os programas e componentes que deverão ser instalados no ambiente. Nessa etapa, o instalador apresenta o que será efetivamente instalado e o que ainda pode ser selecionado. (TDN - TOTVS Developer Network)
9. Configurar o TOTVS AppServer
Realize as configurações do TOTVS AppServer, definindo a porta em que o AppServer será executado e a nomenclatura do serviço. (TDN - TOTVS Developer Network)
10. Finalizar a instalação
Clique em Avançar para continuar, aguarde a conclusão da barra de progresso, defina se deseja criar atalhos, prossiga com o encerramento do assistente e finalize clicando em Pronto. (TDN - TOTVS Developer Network)
⚠️ Cuidados importantes na atualização
Em processos de atualização, a recomendação da TOTVS é não substituir automaticamente o arquivo appserver.ini por um arquivo antigo de outra instalação. Quando houver necessidade de reaproveitar parâmetros, o ideal é realizar os ajustes manualmente após o término da instalação. (TDN - TOTVS Developer Network)
🛠️ Boas práticas
Para reduzir falhas de implantação, é recomendável:
executar o TSS.exe sempre como administrador;
informar o IP do servidor no campo de serviço HTTP;
evitar o uso de LOCALHOST quando o serviço precisar ser acessado por outras máquinas;
revisar manualmente configurações antigas do appserver.ini em processos de atualização;
validar corretamente a comunicação entre o TSS Off-Line e o TSS On-Line antes de liberar o ambiente para uso. (TDN - TOTVS Developer Network)
📌 Conclusão
A instalação do TSS Off-Line no Windows é um procedimento relativamente direto, mas exige atenção à definição correta do tipo de instalação, à configuração do serviço HTTP e aos parâmetros do TOTVS AppServer. Em atualizações, o principal cuidado é preservar a consistência do ambiente, evitando reutilização inadequada do appserver.ini e garantindo que a comunicação com o TSS On-Line esteja corretamente configurada. (TDN - TOTVS Developer Network)
❓ FAQ
1. Qual executável deve ser utilizado na instalação?
A instalação é feita pelo arquivo TSS.exe, que deve ser executado como administrador. (TDN - TOTVS Developer Network)
2. Qual é a pasta padrão de instalação?
O diretório padrão informado na documentação é C:\totvssped\. (TDN - TOTVS Developer Network)
3. Posso substituir o appserver.ini antigo durante a atualização?
Não é o recomendado. A TOTVS orienta que o arquivo antigo não seja simplesmente reaproveitado; as alterações devem ser feitas manualmente, se necessário. (TDN - TOTVS Developer Network)
4. O que acontece se eu informar LOCALHOST no campo Servidor?
Nesse caso, o serviço ficará acessível apenas internamente na máquina onde o TSS foi instalado, sem acesso por outras máquinas da rede. (TDN - TOTVS Developer Network)
5. Qual a função do TSS Off-Line?
Segundo a TOTVS, o TSS Off-Line é um aplicativo client-side voltado à contingência, para uso em situações de eventual queda de comunicação. (TDN - TOTVS Developer Network)
6. O que preciso configurar no TOTVS AppServer?
É necessário definir a porta de execução do AppServer e a nomenclatura do serviço. (TDN - 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.”