Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 1

changes.mady.by.user Ismael Silva Andrade

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Luis Otavio de Oliveira Rodrigues

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


01. DADOS GERAIS

Linha de Produto:

Datasul

Segmento:

Saúde

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

Jira
serverJIRA
serverId0c783de1-186e-383b-975c-a1acd7d76cb5
keyDSAUGPSAUTOR-13473

Jira
serverJIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId0c783de1-186e-383b-975c-a1acd7d76cb5
keyDSAUGPSAUTOR-14144

Jira
serverJIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId0c783de1-186e-383b-975c-a1acd7d76cb5
keyDSAUGPSAUTOR-14143

02. SITUAÇÃO/REQUISITO

Realizar a chamada do serviço "sala/abrirSala" e alterar o Auditoria Médica Pré para realizar a chamada da nova BOAdequar o sistema para a nova forma de abrir "Chat" no Auditoria Médica para guias de Intercâmbio.

03. SOLUÇÃO

Criada uma nova BO Criado um novo processo para o Chat -Intercambio, de Intercâmbio e alterado BO do Auditoria o Auditoria Médica Pré para realizar a chamada ao novo serviço. 

...

Totvs custom tabs box
tabsProcedimento para Implantação, Procedimento para Configuração, Procedimento para Utilização
idspasso1,passo2,passo3
Totvs custom tabs box items
defaultyes
referenciapasso1

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).

  • No TOTVS12, acesse o programa Rodar Programa Progress - TEEXCPRO e execute o SPP/SP-CRIAR-HISTS-RESSUS-ABI.R para efetuar a criação dos registros de histórico de movimentos em aberto no RESSUS e possibilitar a provisão dos mesmos.

Image Removed

  • No TOTVS12, acesse o programa Manutenção Conta Contábil por Evento - PP0110V e cadastre a(s) conta(s) de provisão para o grupo de prestador do RESSUS.

Image Removed

  • No TOTVS12, acesse o programa Manutenção Conta Contábil por Evento - PP0110H e cadastre a(s) conta(s) de despesa e reversão de despesa para os eventos x grupo de prestador do RESSUS.

Image Removed

Totvs custom tabs box items
defaultno
referenciapasso2
Informações
titleImportante

Para utilização do módulo RESSUS é recomendado que seja criado um grupo de prestador e um prestador exclusivos para este fim, informando o prestador na tela de parâmetros do RESSUS, conforme documentação: DT Parâmetros do Ressarcimento ao SUS.


  • 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):

Image Added


  • 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):


Image Added


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.


Image Added


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:

Image Added


  • Certificado utilizado para comunicação e integração.
    Para realizar a instalação siga os passos apresentados nessa documentação Importação de certificados Https . 
    View file
    namecertificadoChatIntercambio.cer
    height250




Totvs custom tabs box items
defaultno
referenciapasso3
  • 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:
      Image Added

      Retorno:
      Image Added

    • 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:
        Image Added

    • 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:
        Image Added


    • 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.
  • No TOTVS12, acesse o programa Central de Movimentação RESSUS - hrs.ressusAbiImportation e efetue a importação das ABI's:

Image Removed

  • No TOTVS12, acesse o programa Percentual Histórico de Cobrança-hrs.adjustmentPercentage e cadastre os percentuais de histórico de cobrança informados pela ANS para a operadora para cada mês. Caso não haja percentual cadastrado para o mês, os movimentos do RESSUS serão provisionados com 100% do valor cobrado.

  • Image Removed

  • No TOTVS12, acesse o programa Demonstrativo Provisao IN32 - PP0710F  ou Demonst. Provisão IN32 - DTVW20AA.

Image RemovedImage Removed

Ao efetuar a provisão dos movimentos de documentos que foram incluídos através da importação de ABI's do RESSUS, será aplicado o Percentual Histórico de Cobrança (%HC) sobre o valor cobrado do movimento. Por exemplo, se em um movimento o valor cobrado foi de R$100,00 e o percentual do mês de inclusão do movimento foi cadastrado com 50%, serão provisionados R$50,00 referentes à este movimento. Nos meses seguintes, caso haja alteração do percentual, será provisionada a diferença entre o valor já provisionado e o percentual atual, conforme exemplos a seguir:

Provisão - Recebimento ABI com valor de R$100,00, com variação do percentual de HC.

Mês 1 - Recebimento ABI - % HC (50%)
Conta ContábilCréditoDébitoParametrizaçãoEvento
21111.1024 - Provisão de Eventos/Sinistros a Liquidar para o SUS50,000,00PP0110V-
41181.xxx1 - Despesas com Eventos / Sinistros - SUS0,0050,00PP0110HNormal
Mês 2 - Aplicação % HC (70%)
Conta ContábilCréditoDébitoParametrizaçãoEvento
21111.1024 - Provisão de Eventos/Sinistros a Liquidar para o SUS20,000,00PP0110V-
41181.xxx1 - Despesas com Eventos / Sinistros - SUS0,0020,00PP0110HNormal
Mês 3 - Aplicação % HC (80%)
Conta ContábilCréditoDébitoParametrizaçãoEvento
21111.1024 - Provisão de Eventos/Sinistros a Liquidar para o SUS10,000,00PP0110V-
41181.xxx1 - Despesas com Eventos / Sinistros - SUS0,0010,00PP0110HNormal
Mês 4 - Aplicação % HC (50%)
Conta ContábilCréditoDébitoParametrizaçãoEvento
21111.1024 - Provisão de Eventos/Sinistros a Liquidar para o SUS0,0030,00PP0110V-
41181.xxx2 - Reversão da Despesa - SUS30,000,00PP0110HGlosa

Pagamento (opção 1) - Recebimento ABI com valor de R$100,00, com variação do percentual de HC e pagamento da GRU no valor de 50,00.

Mês 5 - Recebimento da GRU
Conta ContábilCréditoDébitoParametrizaçãoEvento
21111.1024 - Provisão de Eventos/Sinistros a Liquidar para o SUS0,0050,00PP0110V-
91111 - Transitória de Pagamento de Prestadores50,000,00PP0110G-

Pagamento (opção 2) - Recebimento ABI com valor de R$100,00, com variação do percentual de HC e pagamento da GRU no valor de 70,00.

Mês 5 - Recebimento da GRU
Conta ContábilCréditoDébitoParametrizaçãoEvento
21111.1024 - Provisão de Eventos/Sinistros a Liquidar para o SUS0,0050,00PP0110V-
41181.xxx1 - Despesas com Eventos / Sinistros - SUS0,0020,00PP0110HNormal
91111 - Transitória de Pagamento de Prestadores70,000,00PP0110G-

Pagamento (opção 3) - Recebimento ABI com valor de R$100,00, com variação do percentual de HC e pagamento da GRU no valor de 10,00.

Mês 5 - Recebimento da GRU
Conta ContábilCréditoDébitoParametrizaçãoEvento
21111.1024 - Provisão de Eventos/Sinistros a Liquidar para o SUS0,0050,00PP0110V-
41181.xxx2 - Reversão da Despesa - SUS40,000,00PP0110HGlosa
91111 - Transitória de Pagamento de Prestadores10,000,00PP0110G-

Pagamento (opção 4) - Recebimento ABI com valor de R$100,00, com variação do percentual de HC e movimento não pago na GRU (desconsiderar pagamento).

Mês 5 - Recebimento da GRU
Conta ContábilCréditoDébitoParametrizaçãoEvento
21111.1024 - Provisão de Eventos/Sinistros a Liquidar para o SUS0,0050,00PP0110V-
41181.xxx2 - Reversão da Despesa - SUS50,000,00PP0110HGlosa
  • No TOTVS12, acesse o programa Relatório de Conferência da Contabilização - hpp.accountingCheckReport.

Image Removed

No relatório CSV, foi incluída a coluna ABI RESSUS, que será preenchida com o código da ABI para todos os movimentos provenientes do módulo RESSUS. A coluna Status será preenchida com os indicadores A (aumento do % HC) e R (redução do % HC) quando houver variação do % HC.

Image Removed

Também será gerado arquivo CSV totalizando os lançamentos nas respectivas contas contábeis para auxiliar no processo de conferência da contabilização. 

Image Removed

  • No TOTVS12, acesse o programa Contabilização Provisao IN32 - PP0710G, Contab. Provisão IN32 - RPW - DTVW21AA ou Contabilização Pagamento Prestadores - hpp.paymentAccounting para efetuar a contabilização dos movimentos provenientes do módulo RESSUS.

Image Removed

  • No TOTVS12, acesse o programa Sinistros a Liquidar - hpp.sinistrosLiquidar.

Image Removed

No relatório CSV, foram incluídas as colunas Dt.Aviso e ABI RESSUS.

Image Removed

Neste relatório, os movimentos provenientes do RESSUS serão listados em todos os meses em que eles forem considerados na contabilização, sendo listados com valores positivos nos meses em que houver provisão de valores devido ao aumento do % HC e com valores negativos nos meses em que houver redução do % HC, fazendo com que seja possível consultar o saldo dos movimentos no mês a partir da soma dos valores referentes ao movimento.

Image Removed

  • No TOTVS12, acesse o programa Livro Aux. ANS/RN390-Registro Evento Conhecido ou Avisado - AF0510X.

Image Removed

No relatório CSV, na coluna Vl.Evento será preenchida com o saldo do movimento no mês de emissão do relatório para os movimentos provenientes do módulo RESSUS, e nas colunas Provisao Deb, Provisao Cred, Custo Deb, Custo Cred e Glosa Cred o valor do lançamento contábil nas respectivas contas ocorridos no mês da emissão para o movimento. 

Image Removed

  • No TOTVS12, acesse o programa Migração Plano de Contas - TE0110U.

Image Removed

Ao alterar a movimentação do pagamento de prestadores, os registros de contabilização de provisão relacionados a mudança do percentual histórico de cobrança, serão apresentados no arquivo HPP_PROVISAO.CSV com status A (aumento do % HC) e R (redução do % HC).

Image Removed


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


Templatedocumentos


HTML
<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>