Tempo de leitura: 3 minutos
Se você trabalha com documentos eletrônicos no Protheus, já deve ter enfrentado problemas relacionados à comunicação com o TSS. Um dos erros mais comuns está relacionado à configuração incorreta ou desatualizada da URL do TSS, o que impede a emissão de documentos como NF-e, NFS-e e MDF-e. Manter essas URLs em dia é vital para a sobrevivência fiscal da empresa, um tema central em Documentos Eletrônicos Protheus.
Neste guia objetivo, você aprenderá como atualizar a URL do TSS no Protheus na prática e como garantir que a comunicação com a SEFAZ seja restabelecida rapidamente.
O que são as URLs do TSS e qual sua finalidade?
As URLs do TSS são os endereços dos Web Services dos órgãos do governo (SEFAZ e Prefeituras). Quando o governo altera um desses endereços e o seu TSS não é atualizado, ocorre o erro de conexão. Esse processo afeta diretamente rotinas do módulo Faturamento (SIGAFAT), como o faturamento de notas e manifestos.
Em resumo, essas URLs são links de comunicação para que o TSS possa se comunicar enviando informações em formato xml via Web Service(Web Service é uma solução utilizada na integração de sistemas e na comunicação entre aplicações diferentes(fonte:https://pt.wikipedia.org/wiki/Web_service)), assim essas URL são endereços de serviços Web que recebem essas informações e fazem as devidas validações.
Tomamos como exemplo a tabela do SPED, a SPED158(tabela onde fica as URLs de transmissão):
Por que atualizar a URL do TSS?
A atualização é necessária sempre que houver:
- Migração do TSS para um novo servidor (novo IP/DNS).
- Alteração da porta de comunicação do serviço.
- Mudança de ambiente (ex: migração de Homologação para Produção).
Passo a Passo: Procedimentos para Atualizar URLs do TSS
1. Download dos Arquivos no Portal TOTVS
Primeiramente você deve acessar o portal da TOTVS em suporte.totvs.com/download. Ao entrar na seção de download, informe no filtro de pesquisa o conteúdo *TSS_URL, conforme mostrado na imagem abaixo:
2. Preparação do Pacote
Após fazer o download do arquivo(nesse exemplo a última versão 18-05-30-TSS_URLS_RELEASE_12.1.17.ZIP)extraia o pacote:
Dentro do pacote extraído teremos o arquivo tssatuurl.json (arquivo esse que substituiu o arquivo TSSATUURL.CFG, para TSS atualizado a partir de Janeiro/2018):
(Importante: Antes de colocarmos o arquivo tssatuurl.json no diretório raiz do TSS devemos parar o serviço do TSS.)
3. Substituição do Arquivo no Servidor
O próximo passo é colocar o arquivo tssatuurl.json no diretório raiz do TSS, dentro da pasta system(\totvssped\system):
4. Reinicialização e Validação
O próximo passo é subir o serviço do TSS, que poderá ser em modo console
ou em modo serviço do windows, dependendo de como está sua instalação:
Observação: Quando você subir o serviço do TSS o mesmo irá carregar o arquivo tssatuurl.json, caso ele não carregue o arquivo devemos apagar a pasta semaforo, localizada na pasta (\totvssped\semaforo), para assim forçamos o carregamento do arquivo e atualizar as URLs do TSS.
Domine a Infraestrutura de Mensageria
Para dominar este conceito em cenários complexos, como a gestão de Certificados A1, configuração de TLS 1.2 e automação de processos fiscais, conheça o Portal ProtheusAdvpl. Lá, exploramos a fundo a arquitetura do TSS e como evitar paradas no faturamento.
Conclusão
Atualizar as URLs do TSS é uma manutenção preventiva que evita dores de cabeça no Faturamento (SIGAFAT). Se o seu ambiente estiver configurado corretamente, esse processo leva poucos minutos. Se você ainda não tem o TSS instalado, confira nosso guia sobre Como Instalar e Configurar o TSS 3.0.
Links de referência(s):
