Conteúdo
- Visão Geral
- Segurança
- Parâmetros Client ID e Client Secret
- Processos que utilizam integração com TSS
- Configurações do TSS no Fiscal
- 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). 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, 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.
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 , 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 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 |
|---|
| 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. Caso 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. Caso Se não tenham 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
...
| 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
- Alterar Responsável Técnico
|
| 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). Os processos são basicamente os mesmos da NF-e, alterando alguns detalhes na transmissão.- 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 |
|---|
|
| 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
| 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 |
|---|
| 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. |
|
|
...
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
|
|
