Histórico da Página

CONTEÚDO

1. Visão Geral
2. Processo
3. Segurança
4. Parâmetros Client ID TSS e Client Secret TSS
5. Geração do TokenProcessos que utilizam integração com TSS no Fiscal
6. Tela - Conexão ao TOTVS Services

...

        A partir do release 12.1.33, o TSS implementa a funcionalidade de utilização de Token de Autenticação baseado em credenciais, contemplando a LGPD (Lei Geral de Proteção de Dados). O TSS fornece as credenciais que  Para o fluxo de autenticação, serão utilizadas as credenciais (client_id e client_secret) geradas pelo TSS. Essas credenciais deverão ser informadas no ERP para que sejam utilizadas na requisição de solicitação do Token de autenticação da empresa, para isso foi desenvolvido o método TOKEN do webservice TSSAUTHENTICATION, que é responsável pela geração e atualização do Token de autenticação da empresa. 

        Esse Token de autenticação, deverá ser inserido no cabeçalho de todas as requisições enviadas para o TSS, para que seja realizada a autenticação segura no consumo do serviço. Resumidamente, o TSS fornecerá as credenciais que deverão ser importadas no ERP. Com essas credenciais, o ERP controla deverá controlar a geração do Token de Autenticaçãoautenticação, e consequentemente, envia enviar no cabeçalho de todas requisições para o TSS. 

A partir da versão 12.1.33 ao instalar o TSS essa configuração fica ativada automaticamente. Porém o cliente pode desabilitá-la se desejar.

02. Processo

Ao serem passados os valores para os parâmetros Client ID TSS e Client Secret TSS é validado e gerado o Token em um arquivo xml de autenticação dentro do TSS.  

        Ao executar algum processo no RM que integra com o TSS, internamente o sistema consome métodos dos webservices do TSS como configuração da entidade, configuração do certificado e processos específicos da rotina por exemplo. Antes do ERP consumir os métodos dos websercices do TSS, precisará validar se existe Token válido, caso não possua solicitar a renovação do token através do REFRESH_TOKEN ou solicitar um novo Token com o CLIENT_ID e CLIENT_SECRET. 

Com o Token válido, todos os consumos de métodos dos webservices do TSS, precisará ser enviado o Token de autenticação no cabeçalho do arquivo.

03. Segurança

         Por padrão, a validade do token de autenticação será de 1 (uma) hora, é configurável por TSSTOKEN_TIMEEXP, lembrando que quanto maior seja a validade menor será sua segurança. A validade do token de refresh será 24 horas, esse não é configurável, entendemos que caso o ERP não realize nenhum consumo do serviço do TSS dentro deste prazo, será necessário realizar a solicitação do token de autenticação novamente.

04

...

. Parâmetros Client ID TSS e Client Secret TSS

Para realizar a autenticação no TSS é necessário informar os campo Client ID TSS e Client Secret TSS, além de também a URL do Servidor:
comunicação com o TSS vamos precisar salvar as informações do usuário e senha do TSS para solicitação do Token que serão utilizados nos vários processos do sistema. O Token pode ser cadastrado por entidade (Filial) do TSS. 

• Cadastro de Filiais: Como o Token precisará ser utilizado em vários processos, o melhor lugar para salvar a informação é no cadastro da Filial (Já que o local dos parâmetros dos vários processos não é o mesmo).

Campos:

• CLIENT_ID: Alfanumérico - Tamanho 40
• CLIENT_SECRET: Alfanumérico - Tamanho 200

Regras de Preenchimento CLIENT_ID e CLIENT_SECRET       Regras de Preenchimento Client ID e Client Secret

1. Esses campos deverão ser preenchidos juntos, não será possível prosseguir com as alterações em tela caso apenas uma delas estiver preenchida;
2. Caso a versão do TSS seja menor que 12.1.33 estes campos não deverão ser preenchidos. Caso forem preenchidos, será emitida uma mensagem de erro em tela;
3. Caso a versão do TSS seja maior ou igual a 12.1.33 este campo poderá ou não ser preenchido, dependendo da configuração do TSS:
   • Caso o TSS esteja parametrizado para realizar a Autenticação via Token, os campos de credenciais deverão ser preenchidos. Caso não tenham sido preenchidos ou as credenciais estiverem inválidas, será emitida uma mensagem de erro em tela;
   • Caso o TSS esteja parametrizado para não utilizar a Autenticação via Token, estas informações das credenciais não deverão ser preenchidas.

03. Geração do Token

O Token de Acesso está configurado para validade de 60 minutos, e fica a cargo do usuário alterar. Após o vencimento do mesmo, é gerado um novo token para realizar a autenticação. 

05. Processos que utilizam integração com TSS no Fiscal

• Nota Fiscal Eletrônica (NF-e)
• Nota Fiscal de Consumidor Eletrônica (NFC-e)
• Nota Fiscal de Serviço Eletrônica (NFS-e)
• EFD-Reinf

06

...

. Tela - Conexão ao TOTVS Services

       Informando os parâmetros Client ID TSS, Client Secret TSS e URL do Servidor:

...