Árvore de páginas

01. DADOS GERAIS

Produto:

TOTVS Backoffice

Linha de Produto:

Linha Protheus

Segmento:

Backoffice

Módulo:TOTVS Automação Fiscal (TAF)
Função:WSTAF038.PRW
País:Brasil
Ticket:Não há.
Requisito/Story/Issue (informe o requisito relacionado) :DSERTAF1-25432

02. SITUAÇÃO/REQUISITO

Atualmente, os clientes só conseguem descobrir que um certificado digital venceu quando é efetuada uma transmissão após o vencimento. Nesta situação, o TSS retorna um erro de schema informando a ocorrência e que o cliente tem que realizar a transmissão novamente após configurar um novo certificado.

Este comportamento pode causar problemas ao cliente, pois se o mesmo esquecer de renovar o certificado, não será possível realizar as transmissões até que um novo seja expedido, e este operação pode não ser tão ágil.

Pensando neste cenário, iremos realizar a criação de uma interface de aviso de vencimento de certificado.

03. SOLUÇÃO

A fim de criar uma interface de aviso de vencimento de Certificado Digital, foi desenvolvida uma API Rest do Protheus para consumir um serviço SOAP do TSS responsável pelas informações do Certificado Digital. Agora será possível ter acesso a informações como, por exemplo, a data de validade do Certificado Digital, e poder decidir por alertar o usuário da proximidade do vencimento.

04. DEMAIS INFORMAÇÕES

  • PARAMETROS DA REQUISICAO REST
    • token - Token de validação de conexão
    • codEntTSS - Código de Entidade no TSS ( SPED400 )
  • RETORNO BEM SUCEDIDO
    • Arquivo JSON com informações do Certificado Digital cadastrado no TSS
  • RETORNO MAL SUCEDIDO
    • Não informar alguns dos parâmetros obrigatórios da requisição
      • "Token e/ou Entidade do TSS nao foram informados nos parametros." 
        • "Os Query Params 'token' e 'codEntTSS' sao obrigatorios e devem ser informados com um token valido e um codigo de entidade do TSS valido, respectivamente."
    • Parâmetro MV_TAFSURL em branco ou com conteúdo inválido
      • "TSS nao pode ser conectado."
        • "A tentativa de conexao na API SPEDCFGNFE falhou. Favor verificar: Query Params informados. TSS ativo. VPN ativa. Parametros Protheus com conteudos validos."
    • Para os parâmetros informados não foi encontrado Certificado ou requisição falhou
      • "Nao foi possivel obter informacoes de Certificados"
        • "Endpoint CFGSTATUSCERTIFICATE da API SPEDCFGNFE falhou ou retornou vazio."
    • Para os parâmetros informados não foi encontrado Certificado
      •  "Nenhum Certificado encontrado."
        • "Nenhum Certificado foi encontrado para os parametros informados."

05. ASSUNTOS RELACIONADOS