Mensageria PLS x HAT

CONTEÚDO

1. Visão Geral
2. Configurações INI
3. Configurações SIGACFG
   1. Cadastro de Parâmetros
   2. Cadastro de Schedule para atualização do status da Mensageria
4. Configurações Remote
   1. Cadastro de Configurações APIS de Terceiros
5. Detalhamento da Funcionalidade
6. Menus
7. Tabelas Utilizadas
8. Campos descontinuados

01. VISÃO GERAL

Implementada melhoria com a criação da funcionalidade de Mensageria no Plano de Saúde (SIGAPLS). O objetivo, é disponibilizar um canal de comunicação entre o Auditor Médico e Prestador de Saúde, permitindo realizar a troca de mensagens e arquivos. 

A Mensageria está disponível para cliente que utilizam a ferramenta Portal Autorizador HAT, assim, as mensagens e anexos são armazenadas na nuvem. O acesso a nuvem no Plano de Saúde (SIGAPLS) é realizado através da rotina Auditoria Por Guia (PLSA790V).

Observação: a Mensageria no Portal Autorizador HAT é liberada somente para guias que estão em Análise da Auditoria.

02. CONFIGURAÇÕES INI

No arquivo appserver.ini, é necessário configurar a chave General com o atributo MaxStringSize com o valor 10 pelo menos. Esta alteração é necessária para liberar o sistema para realizar o Upload de arquivos de até 10mb.

[general]
maxStringSize=10

Mais informações: MaxStringSize 

03. CONFIGURAÇÕES SIGACFG

a) Cadastro de parâmetros

Acesse Configurador / Ambiente / Cadastros / Parâmetros. Configure os parâmetros abaixo:

b) Cadastro de Schedule para atualização de Status da Mensageria

Acesse Configurador / Ambiente / Schedule / Schedule. No menu Agendamentos/Cadastro clique em Incluir.

• Realize o cadastro de acordo com a sua necessidade, indicando:

• No campo Recorrência é recomendado cadastrar para que os schedule seja processado diariamente dentro de um intervalo estipulado.

Exemplo de cadastro:

O objetivo deste Schedule é acessar as APIS para atualizar o Status (B53_MSGSTA) das guias atualizadas pelos Prestadores na Mensageria.

04. CONFIGURAÇÕES REMOTE

a) Cadastro de Configurações APIS Terceiros

Acesse Plano de Saúde / Operadora de Saúde / Configurações Integrações (PLSA994). Clique em Incluir.

Na aba Informações Gerais, informe a Operadora que será utilizada. Na aba Mensageria, informe os dados de acesso as APIS da Mensageria.

Importante: a URL padrão do HAT é https://hat.totvs.com.br/ (informar esse dado no campo URL Mensag.)

Parâmetros (SX6):

É necessário informar também os dados de acesso as API´s do Portal Autorizador. São os mesmos dados da API de Integrações via Pedidos (Tabela BNV). Caso já esteja configurado no seu ambiente, pule esse passo.

Para preencher esses dados, é necessário gerar um Master Token no Portal de Administração. Acesse o portal da administração (https://admin.hat.totvs.com.br/), clique em Configurações / Configurações de Integração. Na parte inferior informe o nome do Token e clique em Gerar Token. Preencha os parâmetros no Sistema de Gestão SIGAPLS conforme a imagem abaixo:

05. DETALHAMENTO DA FUNCIONALIDADE

O objetivo da funcionalidade é disponibilizar uma sala para troca de mensagens/arquivos entre o Auditor e o Prestador.

No Plano de Saúde, acesse: Atualizações / Auditoria / Por Guia (PLSA790V). Selecione a guia que deseja abrir a sala para troca de mensagens com o Prestador. Clique em Outras Opções / Mensageria / Consulta Sala:

Caso a sala não exista, o sistema questiona se deseja criá-la:

Observação: o sistema permite abertura de sala somente para guias que foram geradas no Portal Autorizador HAT. A abertura da sala também pode ser realizada pelo Prestador no Portal Autorizador HAT (somente guias em estudo da auditoria).

Como a sala foi aberta pelo Auditor, a pendência da responsabilidade da sala fica pendente com ele através do campo Status Mens. (B53_MSGSTA). A responsabilidade passa para o Prestador após o envio de uma mensagem com a solicitação. Para enviar a mensagem basta digitá-la no campo Adicionar Mensagem e clicar no botão Confirmar. 

Ao enviar uma mensagem para o Prestador, a pendência da sala fica com responsabilidade do Prestador atualizando o campo Status Mens. (B53_MSGSTA). A mensagem é adicionada e apresentada no grid inferior. Com duplo clique nela, é apresentada os dados detalhados da mensagem.

Caso o Auditor precise anexar um arquivo neste mensagem para o Prestador, basta acessar a mensagem com duplo clique, selecione a opção Outras Ações / Adicionar Anexos. Selecione o arquivo e confirme:

O arquivo é adicionado no grid inferior da mensagem.

Com duplo no anexo, o arquivo é executado (abrir um arquivo TXT/DOC/PDF por exemplo). Caso o Auditor deseje realizar o download do arquivo, basta acessar Outras Ações / Download Anexos, selecione o diretório e confirme. É realizado o download de todos os arquivos anexados a mensagem.

Nesta etapa, o Prestador deve acessar a Mensageria no Portal Autorizador HAT e responder a mensagem enviada pelo Auditor. Quando um Prestador realiza uma interação na sala, o status da mensagem é alterado para Pendente Auditor no servidor do HAT.

O Schedule PLChatSchd parametrizado na sessão 02 deste documento é o responsável por atualizar o campo Status Mens. (B53_MSGSTA) das guias no sistema TOTVS Saúde Planos.

Acessando novamente a rotina Auditoria por Guia (PLSA790V), a guia é apresentada com o Status Mens. (B53_MSGSTA) atualizado com o novo status Pend. Auditor. Caso o Auditor deseje filtrar as guias por este campo, o mesmo pode ser realizado em Outras Ações / Mensageria / Filtrar Guias. Selecione o status desejado:

Acessando novamente a mensageria através da opção Outras Opções / Mensageria / Consulta Sala, a mensagem apresentada pelo prestador é apresentada. Caso existam arquivos em anexo, o arquivo pode ser executado com duplo clique no grid. Para realizar o download dos arquivos, acesse Outras Ações / Download Anexos:

Quando o Auditor dispõe de todas as informações para realizar a análise da Auditoria, ele deve seguir o fluxo padrão do sistema para realizar a análise clicando no botão Analisar, selecionar os eventos desejados e clicar em Parecer:

Ao confirmar a análise da auditoria (autorizar ou negar o último evento pendente), o sistema envia uma mensagem para finalizar a sala. Esta é uma mensagem fixa, e deve ser informada no campo Msg.Fin.Sala (B7G_MSMSGF). Não foi utilizado o conteúdo do campo Obs. Análise (B72_OBSANA) pois normalmente esta é uma mensagem interna da Operadora.

Com a sala finalizada, não é permitido a adição de novas mensagens.

A funcionalidade também permite abrir a guia para consulta diretamente da Mensageria acessando Outras Ações / Visualizar Guia:

06. MENUS

Adicione os menus abaixo:

07. TABELAS UTILIZADAS

• Dicionário SX2:

• Dicionário SX3:

Campos tabela B7G:

Campos tabela B53:

• Dicionário SIX:

Índices tabela B7G:

• Dicionário SXA:

Folders tabela B7G:

• Dicionário SX7:

Gatilhos B7G:

08. CAMPOS DESCONTINUADOS

Os campos abaixo faziam parte da versão inicial, porém foram descontinuados: