Início / TOTVS Sped Service / Instaladores

📘 Instalação e atualização do TSS On-Line no Windows


📅 Data de publicação

02/04/2026

🎯 Objetivo

Orientar a instalação e a atualização do TSS On-Line no Windows, destacando os pré-requisitos, a configuração do ambiente e os principais cuidados recomendados pela TOTVS para evitar falhas futuras. (TDN - TOTVS Developer Network)

🖥️ Ambiente

TSS – TOTVS Service SOA
Plataforma: Windows
Modalidade: TSS On-Line (TDN - TOTVS Developer Network)

🧩 Visão geral

A TOTVS orienta que, antes da instalação ou atualização do TSS On-Line no Windows, sejam verificados os pré-requisitos do ambiente. Essa etapa é importante para evitar problemas operacionais posteriores e garantir melhor desempenho da solução. (TDN - TOTVS Developer Network)

O processo contempla desde a preparação do banco de dados e do DbAccess até a execução do instalador TSS.exe e a definição dos parâmetros do serviço HTTP, conexão com banco e configuração do TOTVS AppServer. (TDN - TOTVS Developer Network)

✅ Pré-requisitos recomendados

1. Banco de dados exclusivo para o TSS

A TOTVS recomenda criar um banco de dados de uso exclusivo para cada TSS instalado. Segundo a documentação, isso traz benefícios como:

  • ganho de performance;

  • redução de concorrência com o ERP;

  • menor impacto em futuras atualizações de banco, já que o processo pode exigir acesso exclusivo. (TDN - TOTVS Developer Network)

2. DbAccess exclusivo para o TSS

Também é recomendada a instalação de um DbAccess exclusivo para o TSS, pelos seguintes motivos:

A própria documentação informa que a instalação do DbAccess pode ser realizada pelo instalador do TSS On-Line no Windows. (TDN - TOTVS Developer Network)

⚠️ Cuidados importantes na atualização

Durante a atualização do TSS, a TOTVS recomenda que o arquivo appserver.ini não seja simplesmente substituído pelo arquivo utilizado em instalações anteriores. Quando necessário, os ajustes devem ser feitos manualmente após a instalação, evitando reaproveitamento inadequado de configurações antigas. (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. Na abertura do instalador, selecione o idioma desejado. (TDN - TOTVS Developer Network)

2. Avançar pela tela inicial e aceitar o contrato

Na sequência, será exibida a tela de boas-vindas do assistente de instalação. Avance e leia o contrato de licença. Caso aceite os termos, prossiga com a instalação. (TDN - TOTVS Developer Network)

3. Definir a pasta de instalação

Escolha a pasta onde o TSS será instalado. Segundo a TOTVS, o diretório padrão é:

C:\totvssped\ (TDN - TOTVS Developer Network)

4. Selecionar o tipo de instalação

Na etapa seguinte, selecione a opção TSS On-Line.

A TOTVS define o modo On-Line como um aplicativo server-side, executado no lado do servidor, com objetivo de realizar a comunicação e a transmissão de documentos eletrônicos. Já o modo Off-Line é um aplicativo client-side, voltado a contingência em situações de queda de comunicação. (TDN - TOTVS Developer Network)

5. Escolher o idioma do repositório

Defina o idioma que será utilizado no repositório do TSS. (TDN - TOTVS Developer Network)

6. Configurar o serviço HTTP

Informe os dados do serviço HTTP que o TSS disponibilizará, preenchendo os campos Servidor e Porta. (TDN - TOTVS Developer Network)

Atenção ao campo Servidor

A documentação destaca que o campo Servidor deve receber o IP do servidor onde a instalação está sendo realizada. Se for informado LOCALHOST, o acesso ficará restrito à própria máquina onde o TSS está instalado, impedindo que outras máquinas da rede enxerguem o serviço. (TDN - TOTVS Developer Network)

7. Configurar a conexão com o banco

Depois de definir servidor e porta, informe os parâmetros de banco de dados:

  • Database: tipo do banco, como MSSQL, Oracle, Postgres etc.;

  • Alias: conexão ODBC criada para o banco do TSS;

  • Servidor: identificação do servidor correspondente. (TDN - TOTVS Developer Network)

8. Selecionar os programas a instalar

Escolha os componentes que serão instalados no ambiente. (TDN - TOTVS Developer Network)

9. Configurar o TOTVS AppServer

Na etapa seguinte, preencha os campos referentes à configuração do TOTVS AppServer, conforme o ambiente definido para o TSS. (TDN - TOTVS Developer Network)

10. Concluir a instalação

Após as configurações, clique em Próximo para continuar. Aguarde o término da barra de progresso, escolha se deseja criar atalhos e finalize o processo clicando em Pronto. (TDN - TOTVS Developer Network)

🔍 Boas práticas

Para uma instalação mais segura e estável, recomenda-se:

  • utilizar banco de dados exclusivo para o TSS;

  • manter um DbAccess dedicado;

  • executar o instalador como administrador;

  • informar o IP do servidor no serviço HTTP, evitando uso de LOCALHOST quando houver acesso por outras máquinas;

  • revisar manualmente configurações antigas em vez de reaproveitar automaticamente o appserver.ini;

  • validar previamente a conexão ODBC do banco do TSS. (TDN - TOTVS Developer Network)

📌 Conclusão

A instalação e atualização do TSS On-Line no Windows exigem atenção especial à preparação do ambiente. O uso de banco de dados exclusivo, DbAccess dedicado e configuração correta do serviço HTTP são pontos fundamentais para garantir melhor desempenho e evitar problemas de comunicação com o ERP e com os serviços do TSS. Além disso, em processos de atualização, a recomendação é não substituir automaticamente o appserver.ini antigo, realizando os ajustes de forma controlada e manual. (TDN - TOTVS Developer Network)

❓ FAQ

1. Posso usar o mesmo banco de dados do ERP para o TSS?

A recomendação da TOTVS é utilizar um banco exclusivo para cada TSS instalado, visando performance e redução de concorrência com o ERP. (TDN - TOTVS Developer Network)

2. O DbAccess pode ser compartilhado com o ERP?

A orientação é usar um DbAccess exclusivo para o TSS, para melhorar performance, configuração dedicada e consumo de memória isolado. (TDN - TOTVS Developer Network)

3. Posso reaproveitar o appserver.ini de uma instalação anterior?

A TOTVS recomenda que o appserver.ini antigo não seja simplesmente substituído. Caso necessário, os ajustes devem ser feitos manualmente após a instalação. (TDN - TOTVS Developer Network)

4. O que acontece se eu configurar o servidor HTTP como LOCALHOST?

Nesse caso, o serviço ficará acessível apenas na própria máquina onde o TSS está instalado, sem visibilidade para outras máquinas da rede. (TDN - TOTVS Developer Network)

5. Qual é a pasta padrão de instalação do TSS no Windows?

O diretório padrão indicado na documentação é C:\totvssped\. (TDN - TOTVS Developer Network)

6. O instalador do TSS pode instalar o DbAccess?

Sim. A documentação informa que é possível realizar a instalação do DbAccess por meio do instalador do TSS On-Line no Windows. (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.”

Atualizado em 02/04/2026
Este artigo foi útil?  
Agradecemos sua avaliação.