56272-O que é o TSS e Como utilizar

O TSS é um servidor de aplicação da TOTVS, responsável pelo gerenciamento da NF-e e geração do arquivo ECD (Escrituração Contábil Digital).

Como funciona o TSS?
A partir do ERP da empresa são processados os dados e enviado via WebService (TSS). O envio é efetuado por meio de conexão local ou internet (LAN ou WAN) no formato de XML. A TOTVS dispõe de três modelos de instalação do TSS, variando do mais seguro para as redes corporativas, até a mais simples e menos segura.
Para integrar o EMS com o TSS é necessário ativar a função SPP-NFe + SPP-INTEG-TSS

CD7070 - Ativar a função “NFE” (Chamar o programa via CTRL + ALT + X), Digite CDP/CD7070.r
*** IMPORTANTE *** No campo chave solicitada, informe: NFE

Em seguida ative a função INTEG-TSS, informando no campo chave: INTEG-TSS

O EAI deverá ser parametrizado corretamente para as transações ConfigEmpresa e ConfigTSS. O XML gerado no EAI será lido pelo aplicativo de transmissão (Integrator) e, por de mapas de conversão, será desmembrado em novos XML’s no formato do TSS.

O envio destes XML’s ao TSS será realizado pelo Integrator. Cada XML enviado ao TSS receberá um retorno. O Integrator deverá obter todos os retornos, criar uma nova mensagem XML no formato do EMS e encaminhá-la ao EAI.

Para que os arquivos enviados ao TSS sejam corretamente recebidos e encaminhados à SEFAZ, é necessário realizar parametrizações no servidor (com a equipe de Tecnologia).

Para tanto, o programa CD0403 (Manutenção de Estabelecimentos) irá executar uma rotina (AXSEP007) para enviar os dados do estabelecimento emissor de NF-e ao TSS.

Também foi desenvolvido um novo programa (CD0403B) de cadastro e manutenção de todas as informações de configuração necessárias ao TSS. Será cadastrado neste programa o e-mail do emissor de NF-e e o diretório onde serão gravados os XML’s enviados à SEFAZ.

O cadastro realizará o envio dos parâmetros gravados através do novo programa AXSEP008, responsável por gerar o XML com os dados de configuração e enviá-los para o EAI (Enterprise Application Integration).

Todos os retornos, de envio, cancelamento e inutilização, que a SEFAZ retorna autorizando, enviando XML com as informações da nota e número de protocolo de validação, informações do certificado digital, etc.

A empresa emissora das notas deve armazenar estes arquivos XML, conforme norma do Fisco, e também deve disponibilizar o XML ao seu cliente, o destinatário da nota.

Para isso, foi criado o parâmetro “Caminho XML” no cadastro de estabelecimento (CD0403B) onde serão armazenados os arquivos retornados da SEFAZ. Isso garante o armazenamento destas informações, caso a empresa seja solicitada pelo Fisco.

Para a empresa emissora disponibilizar o XML ao destinatário da nota, será enviado um e-mail para o cliente, para que ele tome conhecimento da nota, e a armazene.

Para esta funcionalidade foi criado um parâmetro no CD0403B, campo “E-mail”, que será o Remetente do e-mail, e o e-mail de destinatário será o e-mail informado no cadastro de emitentes – CD0704.

O armazenamento e envio do e-mail serão feitos no retorno da nota, no programa receiver.

O fluxo que segue com o EMS integrado ao TSS:

O processo de envio de XML da NF-e continuará como é feito hoje, pelo faturamento das notas, ou seja, a cada nota gerada no EMS será enviado o XML da NF-e, em formato de layout SEFAZ, de forma assíncrona.

O XML chegará na fila do EAI, o Integrator busca a informação na fila, transforma para o layout padrão do TSS, utilizando-se de mapas, e disponibiliza no WebService do TSS. O TSS devolve se recebeu ou não a informação.

Como o TSS é passivo, ou seja, devolve informações se lhe forem solicitadas, foi alterado o programa de Consulta de Notas Fiscais Eletrônicas – FT0909 para buscar o resultado do processamento das notas.

Esta solicitação é feita utilizando um novo programa de envio de XML (Sender) onde é disparado no (Botão Atualizar), que irá ler todas as notas que aparecem na consulta que ainda estão pendentes de resposta nas situações: Em Processamento no EAI ou Em Processamento no Aplicativo de Transmissão e envia XML de consulta destas notas (Web Método padrão TSS), de forma assíncrona. O XML chegará na fila do EAI, o Integrator busca a informação na fila e disponibiliza no WebService do TSS. O TSS devolve o resultado processamento, se ainda está processando na SEFAZ, se já chegou a nota na SEFAZ, se a SEFAZ já aprovou, se a SEFAZ rejeitou, etc.

O Integrator recebe o resultado e envia para a fila do EAI. O EAI parametrizado para receber a resposta, através de transações, executa o programa receptor de XML (Receiver) para então atualizar a situação da NF-e no EMS e dispara as rotinas de atualização de outros módulos, se for o caso de nota autorizada.

O Cancelamento e Inutilização, através do programa de Cancelamento de Notas Fiscais - FT2200 ou Inutilização de Notas Fiscais - FT2201, cancelando NF-e que está com situação de Uso Autorizado e inutilizando notas rejeitadas.

Os envios de solicitação de cancelamento e inutilização serão feitos de forma assíncrona, em formato de XML padrão SEFAZ.

O TSS envia a solicitação de cancelamento ou inutilização à SEFAZ, e fica aguardando o resultado do processamento.

O EMS envia solicitação de consulta, para saber se a SEFAZ homologou o cancelamento/inutilização. Recebendo o retorno de Cancelamento ou Inutilização homologado pela SEFAZ, o EMS dispara as rotinas de cancelamento de nota.

Neste momento também irá chamar o método para armazenar o XML de cancelamento/inutilização no ambiente.

Foi desenvolvido novo programa de envio de XML (sender), para consultar se os serviços da SEFAZ estão no ar ou não, formato de XML padrão SEFAZ, de forma síncrona.

O Integrator recebe o XML e envia a solicitação ao TSS, convertendo para o formato dele através de mapas.

O TSS devolve os status dos serviços dos estados emissores de notas que constam na consulta do programa de Consulta Notas Fiscais Eletrônicas – FT0909 na pasta Serviços SEFAZ.

Para o sistema considerar como emissão de notas com Tipo de Emissão = Contingência, foi criado um parâmetro no programa de Manutenção de Estabelecimento - CD0403B “Tipo de emissão” Normal ou Contingência.

Por padrão, ficará parametrizado como Tipo de Emissão = Normal.

Então, fatura-se uma nota fiscal eletrônica. Se o TSS devolver o resultado do processamento como Serviço da SEFAZ fora, parametriza o emissor para Tipo de Emissão = Contingência, e reenvia a nota utilizando o FT0909, botão Contingência.

Neste momento, altera-se a situação a NF-e para “Em Processamento no EAI”, para que seja possível a solicitação de retorno desta nota.

O botão de Contingência estará habilitado somente se o parâmetro no estabelecimento estiver parametrizado para Emissão em Contingência, e quando a função “INTEG-TSS” estiver ativa.

01. Com relação as configurações do Integrator, Servidor e WebService, ambos são parametrizados com auxilio do Suporte de Tecnologia.

02. A Datasul Logística, poderá auxiliar na parametrização e dúvidas relacionadas ao ERP (EMS).