Linha RM

Atalhos

Páginas filhas
  • Autenticação com TSS

Versões comparadas

Versão antiga 9

changes.mady.by.user Yuri Siman Nogueira

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Thiago Henrique Grugel

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Conteúdo

  1. Visão Geral
  2. Processo
  3. Segurança
  4. Parâmetros Client ID e Client Secret
  5. Processos que utilizam integração com TSS no Fiscal
  6. Configurações do TSS
  7. Parâmetro RM Tela - Conexão ao TOTVS ServicesTSS


01. Visão Geral
Âncora
VisaoGeral
VisaoGeral

        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). 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 será inserido no cabeçalho de todas as requisições enviadas para do RM 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 deverá controlar a geração do Token de autenticação, e consequentemente, 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. 

...

Segurança
Âncora
Seguranca
Seguranca

        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.

...

         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 mas pode ser parametrizável. Quanto maior 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.

...

. 

        

03. Client ID e Client Secret
Âncora
ClientIDeClientSecret
ClientIDeClientSecret

Para a comunicação com o TSS vamos precisar foi criado campos para 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 sistemaclient_id e client_secret do TSS. 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:

...

       

Informações
titleRegras 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 Se 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:
    1. Caso o TSS esteja parametrizado para realizar a Autenticação via Token, os campos de credenciais deverão ser preenchidos. Caso Se não tenham tiverem sido preenchidos ou as credenciais estiverem inválidas, será emitida uma mensagem de erro em tela;
    2. 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.

...

04. Processos que utilizam integração com TSS

...

Âncora
Processos
Processos


Deck of Cards
id0
Card
labelNota Fiscal Eletrônica (NF-e)
titleQuando a NFS-e esta pendente o processo esta consultando uma autorização

Os processos de NFe ficam localizados no sistema Gestão de Estoque, Compras e Faturamento em Vendas | Faturamento | SPED (Estadual).

  • Enviar
  • Consultar Autorização
  • Consultar Autorização Automática (Job)
  • Inutilizar
  • Consultar Inutilização
  • Alterar Modalidade de Operação
  • Monitor SEFAZ
  • Envio de Eventos
  • Consulta de EventosAlterar Responsável Técnico



Card
labelNota Fiscal de Consumidor Eletrônica (NFC-e)

Os processos de NFCe ficam localizados no sistema Gestão de Estoque, Compras e Faturamento em Vendas | Faturamento | SPED (Estadual).

  • Enviar
  • Consultar Autorização
  • Consultar Autorização Automática (Job)
  • Inutilizar
  • Consultar Inutilização
  • Alterar Modalidade de Operação
  • Monitor SEFAZ
  • Envio de Eventos
  • Consulta de Eventos
  • Alterar Responsável Técnico
warning

Os processos são basicamente os mesmos da NF-e, alterando alguns detalhes na transmissão.

No momento da implementação/testes pode não haver dados na TOTVS de município que permitam a execução de todos os processos com sucesso. Porém, é possível validar se não irá ocorrer problema de comunicação com o TSS sem a necessidade do teste completo.


Card
labelNota Fiscal de Serviço Eletrônica (NFS-e)

Os processos de NFSe ficam localizados no sistema Gestão de Estoque, Compras e Faturamento em Vendas | Faturamento | SPED NF-e (Municipal).

  • Enviar NFS-e
  • Gerar Arquivo TXT/XML
  • Consultar Geração do Arquivo TXT
  • Consultar Autorização/Cancelamento
  • Consultar Autorização pelo número do RPS
  • Consultar Autorização/Cancelamento Automático (Job)
  • Cancelar NFS-e
  • Substituir NFS-e
Aviso
Para todos os eventos o fluxo é basicamente o mesmo, alterando o XML de transmissão.


Card
labelEFD-Reinf

Os processos da REINF ficam localizados no sistema Gestão Fiscal em Obrigações Acessórias| SPED | EFD - Reinf.

  • Transmitir Evento
  • Consultar Evento
Aviso

05. Configurações do TSS
Âncora
ConfiguracoesTSS
ConfiguracoesTSS

      As configurações do TSS referente a autenticação estão disponíveis no documento: https://tdn.totvs.com/x/1RhcIw


06. 

...

Parâmetro RM - Conexão ao

...

TSS
Âncora
ParametroRM
ParametroRM

       Informando os parâmetros Client ID TSS , e Client Secret TSS e URL do Servidor:CaminhoTSS no RM.

       IMPORTANTE: O Parâmetro deve ser informado no caminho correspondente aos processos que a empresa utiliza.


Deck of Cards
id0
Card
labelNF-e/NFC-e/NFS-e

Caminho para NF-e/NFC-e/NFS-e: BackOffice | Gestão de Estoque, Compras e Faturamento | Ambiente | Parâmetros | Gestão de Estoque, Compras e Faturamento | Integrações | Fiscal | Dados Fiscais | Parâmetros por Filial | Conexão NF-e


Observação: O Client ID e Client Secret deve ser gerado no TSS (Passo 5) e informado nos parâmetros do RM.

Image Added

Card
labelEFD-Reinf

Caminho para REINF: BackOffice | Gestão Fiscal | Ambiente | Parâmetros | TOTVS Gestão Fiscal | TOTVS Gestão Fiscal | Integração | TSS | Parâmetros por Filial | Gerais


Observação: O Client ID e

...

Client Secret deve ser gerado no TSS (Passo 5) e informado nos parâmetros do RM.

Image Added

...