📝 Resumo

Este artigo descreve como habilitar, coletar e desabilitar os logs de comunicação do TSS, tanto na troca de mensagens entre o ERP e o TSS quanto na comunicação do TSS com Web Services externos. O procedimento deve ser utilizado apenas durante simulação controlada.

🎯 Aplicabilidade

• 🧱 Produto/Componente: TSS (Transmissão de Documentos Eletrônicos)

• 🧭 Ambiente: Cross Segmentos

• 🗂️ Versões: Todas as versões

• 🧪 Cenário: Diagnóstico de falhas de comunicação / inconsistências / rejeições

✅ Pré-requisitos

• 🖥️ Acesso ao servidor onde o TSS está instalado

• 🔐 Permissão para editar appserver.ini e reiniciar o serviço do TSS

• 📁 Acesso às pastas WSLOGXML e SYSTEM

• ⏱️ Janela para simulação (pode gerar volume e causar lentidão)

🧰 Passo a passo

1) 📌 Localizar e editar o appserver.ini

1. Acesse o diretório de instalação do TSS

2. Localize o arquivo:

   • 📍 \bin\appserver\appserver.ini

3. Edite o arquivo e habilite/crie as chaves conforme a necessidade

2) 🌐 Habilitar logs do TSS com Web Services externos (TSS ↔ Internet)

No appserver.ini, inclua/ajuste:

[SPED]
SPED_SAVEWSDL=1

• 🧾 O que faz: grava os XMLs de comunicação do TSS com Web Services externos

• 📂 Onde grava: pasta SYSTEM do TSS

• ⚠️ Atenção: habilitar apenas quando necessário (pode causar lentidão)

3) 🔄 Habilitar logs do ERP com o TSS (ERP ↔ TSS)

No appserver.ini, inclua/ajuste:

[JOB_WS]
XMLSAVEALL=1

• 🧾 O que faz: grava todos os XMLs trocados entre o TSS e os ERPs (Web Services do TSS)

• 📂 Onde grava: pasta WSLOGXML (na estrutura/raiz do TSS)

• ⚠️ Atenção: gera grande número de arquivos XML

4) 🔁 Reiniciar o TSS

• 💾 Salve o appserver.ini

• 🔄 Reinicie o serviço do TSS para as chaves entrarem em vigor

5) 🧹 Limpeza antes da simulação (recomendado)

Antes de reproduzir o problema, apague os arquivos *.xml para isolar apenas o que será gerado no teste:

• 🗑️ WSLOGXML

• 🗑️ SYSTEM

6) 🧪 Simular o incidente

• ▶️ Reproduza o cenário que gera o erro (transmissão, consulta, autorização etc.)

7) 📦 Coletar evidências para análise

Ao término da simulação, separar e enviar:

• 📥📤 Na pasta WSLOGXML (ERP ↔ TSS):

  • arquivos com sufixo _in e _out

• 📩📨 Na pasta SYSTEM (TSS ↔ Web Services externos):

  • arquivos com sufixo _rcv e _snd

8) 🧯 Desabilitar as chaves e reiniciar novamente

Após a coleta, desabilite e reinicie o TSS para não gerar logs desnecessários.

Opções:

[SPED]
;SPED_SAVEWSDL=1
; ou
SPED_SAVEWSDL=0

[JOB_WS]
;XMLSAVEALL=1
; ou
XMLSAVEALL=0

🚫 Erros comuns

• 📄 Editar o arquivo errado (fora de \bin\appserver)

• 🔄 Esquecer de reiniciar o TSS após alterar o appserver.ini

• 🧩 Não limpar WSLOGXML/SYSTEM antes da simulação (mistura logs antigos)

• 🐘 Deixar as chaves ativas após o diagnóstico (impacto e crescimento de disco)

• 🔒 Falta de permissão nas pastas (logs não são gravados)

❓ FAQ

🔹 Preciso habilitar as duas chaves?
Não. Use apenas o necessário: XMLSAVEALL para ERP ↔ TSS e SPED_SAVEWSDL para TSS ↔ Web Services externos.

🔹 Onde ficam os logs?

• XMLSAVEALL=1 → 📂 WSLOGXML

• SPED_SAVEWSDL=1 → 📂 SYSTEM

🔹 O que enviar para análise?

• 📂 WSLOGXML: _in e _out

• 📂 SYSTEM: _rcv e _snd

🔹 Isso afeta o ambiente?
Sim. ⚠️ Pode causar lentidão e gerar muitos arquivos. Mantenha ativo apenas durante a simulação.

🔗 Referências

• 📌 Base de conhecimento TOTVS (Cross Segmentos) — “TSS - Procedimento para ativar os logs de comunicação do TSS” (08/10/2024 16:26)

🏷️ Sugestões para cadastro na Base de Conhecimento

• 🧾 Título: Procedimento para ativar logs de comunicação no TSS (ERP ↔ TSS e TSS ↔ Web Services externos)

• 🗂️ Categoria: Cross Segmentos > TSS > Diagnóstico

• 🏷️ Tags sugeridas: tss, appserver.ini, xmlsaveall, sped_savewsdl, wslogxml, system, logs, comunicacao, webservice, diagnostico