...
Por padrão, a validade do token de autenticação será de 1 (uma) hora, 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..
03. Parâmetros Client ID e Client Secret
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 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 não tenham 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 EventosAlterar 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). - 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 |
|---|
| 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
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
|
|
...
