Versões comparadas

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. 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). 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 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.

...

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.

...

 

...

Segurança

         Por padrão, a validade do token de autenticação será de 1 (uma) hora, é configurável por TSSTOKEN_TIMEEXP, lembrando  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.

...


03Parâmetros Client ID e Client Secret

Para a 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

       

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 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 não tenham 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.

...

04Processos que utilizam integração com TSS no Fiscal


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 Eventos
  • Alterar 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


Aviso

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

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

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
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

Para todos os eventos o fluxo é basicamente o mesmo, alterando o XML de transmissão.

...

05Tela - Conexão ao TOTVS Services

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

...