Conteúdo
- Visão Geral
- Segurança
- Client ID e Client Secret
- Processos que utilizam integração com TSS
- Configurações do TSS
- Parâmetro RM - Conexão ao TSS
01. Visão Geral
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.
Esse Token de autenticação, 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.
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
Por padrão, a validade do token de autenticação será de 1 (uma) hora 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.
03. Client ID e Client Secret
Para a comunicação com o TSS foi criado campos para salvar as informações do client_id e client_secret do TSS. O Token pode ser cadastrado por Filial do TSS.
Regras de Preenchimento CLIENT_ID e CLIENT_SECRET
- 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;
- Caso a versão do TSS seja menor que 12.1.33 estes campos não deverão ser preenchidos. Se forem preenchidos, será emitida uma mensagem de erro em tela;
- 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. Se não tiverem 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.
04. Processos que utilizam integração com TSS
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
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
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
Os processos da REINF ficam localizados no sistema Gestão Fiscal em Obrigações Acessórias| SPED | EFD - Reinf.
- Transmitir Evento
- Consultar Evento
05. Configurações do TSS
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
Informando os parâmetros Client ID TSS e Client Secret TSS no RM.
IMPORTANTE: O Parâmetro deve ser informado no caminho correspondente aos processos que a empresa utiliza.
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.
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.