...
Conteúdo
- Visão Geral
- Segurança
- Parâmetros Client ID TSS e Client Secret
- Processos que utilizam integração com TSS
- Geração Configurações do TokenTSS
- Tela Parâmetro RM - Conexão ao TOTVS ServicesTSS
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). 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. Com essas credenciais, o ERP controla a geração do Token de Autenticação, e consequentemente, envia
Esse Token de autenticação, será inserido no cabeçalho de todas as requisições enviadas para do RM para o TSS.
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.
02. 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:
, 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| Âncora |
|---|
| ClientIDeClientSecret |
|---|
| ClientIDeClientSecret |
|---|
|
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.
| Informações |
|---|
| title | 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.
|
...
...
- 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.
|
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.
04. Processos que utilizam integração com TSS
| Deck of Cards |
|---|
|
| Card |
|---|
| label | Nota Fiscal Eletrônica (NF-e) |
|---|
| title | Quando 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
|
| Card |
|---|
| label | Nota 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
|
| Card |
|---|
| label | Nota 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
|
| Card |
|---|
| 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| Â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
...
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 |
|---|
|
| Card |
|---|
| 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 |
|---|
| 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
|
|
...
