Linha Datasul

Árvore de páginas


01. DADOS GERAIS

Linha de Produto:

Datasul

Segmento:

Saúde

Módulo:TOTVS Saúde Planos (Linha Datasul)
Função:Auditoria Médica - Chat de Intercâmbio
Issues:

DSAUGPSAUTOR-13473 - Obtendo detalhes do item... STATUS

DSAUGPSAUTOR-14144 - Obtendo detalhes do item... STATUS

DSAUGPSAUTOR-14143 - Obtendo detalhes do item... STATUS

02. SITUAÇÃO/REQUISITO

Adequar o sistema para a nova forma de abrir "Chat" no Auditoria Médica para guias de Intercâmbio.

03. SOLUÇÃO

Criado um novo processo para o Chat de Intercâmbio e alterado o Auditoria Médica Pré para realizar a chamada ao novo serviço. 


A implementação descrita no documento estará disponível a partir da atualização do pacote no cliente.

O pacote está disponível no portal (https://suporte.totvs.com/download).


  • Acessar o menu Central de Integrações Saúde Planos (hgp.integrationsParams), no menu "Chat de Intercambio", ativar a integração e informar os "Endpoints" das URL's de acesso (disponível no PTU - Integrações):


  • Acessar o menu Usuário x Usuário Chat Intercâmbio (hat.userChatExchange) e cadastrar os usuários com acesso ao GIU e que utilizarão a integração, informando no campo "Usuário GIU" o CPF e a Unimed separados por ‘-’(traço) Exemplo: 99999999999-111, onde: 99999999999 é o CPF e 111 é a Unimed. O código da Unimed deve ser enviado sem zeros à esquerda (Ex: 001 = 1):



Importante: Devido à Lei Geral de Proteção de Dados Pessoais (LGPD) e a presença de campos sensíveis (CPF e Senha), apenas o próprio usuário terá permissão de alterar/detalhar informações desse cadastro (usuário logado igual ao "Usuário Sistema").


  • Acessar o Auditoria Médica (http://NomeServidor:Porta/hau/authorization-audit/), a abrir o chat através do botão "Chat" que estará habilitado somente para as solicitações de autorizações que trafegaram através do Intercâmbio Eletrônico. Após clicar no botão, será aberta uma nova guia no navegador com o sala referente a transação no Intercâmbio Eletrônico.



Após clicado no botão, será aberto em uma nova guia a sala do Chat de Intercâmbio referente a transação da guia:




  • Disponibilizados novos parâmetros do Chat de Intercâmbio na Central de Integrações Saúde Planos (hgp.integrationsParams) para informar as URL's que fazeam a comunicação com a Unimed do Brasil.
  • Disponibilizados novos parâmetros na Usuário x Usuário Chat Intercâmbio (hat.userChatExchange) para informar os dados de autenticação.
  • Disponibilizados novos métodos no processo do Chat de Intercâmbio:

    • abrirSala - Método para retornará o link da sala do chat, se houver sala já criada. 

      Parâmetros de requisição:

      ElementoDescriçãoTipo 
      userCode Usuário para localizar o código do usuário gerado na tela Usuário x Usuário Chat Intercâmbio, campo obrigatório.String
      transactionNumber Número da transação da sala, campo obrigatório.Number
      unimedExecutorCode Código da Unimed executora, campo obrigatório.String
      listUsuariosArray de usuários.Array


      Parâmetros de retorno:

      ElementoDescriçãoTipo 
      linkSalaUsuarioLink da sala do usuário.String


      Ex: 
       Requisição:

      Retorno:


    • getRestClient - Método para autenticação do usúario, retornará um token valido. 

      Método privado, utilizado para autenticação dos parâmetros de usuário cadastrados no menu "Parâmetros do Chat de Intercambio".

      Parâmetros de retorno:

      ElementoDescrição

      oGpsRest

      Cabeçalho e Autorização para requisições.

    • validateRestConnection - Método privado utilizado para validar a autenticação do usuário, verificando se não houve erro durante o processo e se o token foi gerado. 

    • validaDados - Método utilizado para validar os campos obrigatórios da requisição "abrirSala", verificando se os campos obrigatórios estão devidamente preenchidos. 

    • sendMessage  - Método utilizado para o envio da mensagem.

      • Parâmetros de requisição:

        ElementoDescriçãoTipo

        userCode 

        		Usuário para localizar o código do usuário gerado na tela Usuário x Usuário Chat Intercâmbio, campo obrigatório.String
        transactionNumber Número da transação da sala, campo obrigatório.Number
        unimedExecutorCode Código da Unimed executora, campo obrigatório.String

        messageChat

        		Texto da mensagem.String



      • Retorno:

        ElementoDescrição

        idTransaction

        		Número da transação da sala.

        status

        		Código de retorno da requisição. 

        descricao

        		Descrição do retorno.

        msgErro

        		Mensagem de erro em casos de erro, caso não ocorra erros, retornará esse campo vazio.

        Ex:


    • sendAttachment - Método de "enviarAnexo", realiza a chamada do serviço "anexarArquivo" para enviar anexos na sala aberta. 

      • Parâmetros de requisição:

        

      ElementoDescriçãoTipo 
      userCode Usuário para localizar o código do usuário gerado na tela Usuário x Usuário Chat Intercâmbio, campo obrigatório.String
      transactionNumber Número da transação da sala, campo obrigatório.Number
      unimedExecutorCode Código da Unimed executora, campo obrigatório.String

      attachmentName

      		Nome do arquivo em anexo, com a extensão do arquivo, campo obrigatório. 'Ex: teste.pdf'String

      attachmentValue

      		Arquivo anexado. base64


      • Retorno:

        ElementoDescrição
        idTransactionNúmero da transação da sala.
        statusCódigo de retorno da requisição. 
        descricaoDescrição do retorno.
        msgErroMensagem de erro em casos de erro, caso não ocorra erros, retornará esse campo vazio.


        Ex:



    • findSala - Método para criação de sala, retornará o link da sala do chat, este método realiza mais uma requisição para obter o acesso a sala chamando
      a requisição "redirecionaUsuario" após o retorno desta requisição o token é acrescentado no link da sala. Exemplo: linkSalaUsuario&tokenSSO. 

        • Parâmetros de requisição:

          ElementoDescriçãoTipo
          userCode Usuário para localizar o código do usuário gerado na tela Usuário x Usuário Chat Intercâmbio, campo obrigatório.String

          beneficiaryCode

          		Código do beneficiario.String
          transactionNumber Número da transação da sala, campo obrigatório.Number

          createDate

          		Data que a autorização foi criada.Date
          unimedSourceCode Código da Unimed origem, campo obrigatório.Number
          unimedExecutorCode Código da Unimed executora, campo obrigatório.Number



        • Retorno:

          ElementoDescriçãoTipo
          linkSalaUsuarioLink da sala do usuario.String
    • redirecionaUsuario - Método utilizado para obter o token de acesso ao link da sala retornada. Após o retorno desta requisição o token é acrescentado no link da sala.
      Exemplo:  linkSalaUsuario&tokenSSO. 

      • Parâmetros de requisição:

        ElementoDescrição
        Client_IDO Client ID do novo Chat no GIU.
        Redirect_uriURL de redirecionamento. 

        X-UNIMED-APP

        		Código da unimed origem.



      • Retorno:

        ElementoDescrição
        TokenSSOToken de acesso ao link da sala.


04. DEMAIS INFORMAÇÕES


DT Chat Intercâmbio REST - Criação da classe de autenticação do serviço

Usuário_x_Usuário_Chat_Intercâmbio_hat.userChatExchange

Importação de certificados Https

DT Criação de novo método para criar/abrir sala de chat