Histórico da Página
...
- Visão Geral
- Configurações INI
- Configurações RemoteSIGACFG
- Cadastro de Usuários APIParâmetros
- Cadastro de FuncionalidadesSchedule para atualização do status da Mensageria
- Configurações Remote
- Cadastro de Operadoras
- Cadastro de Bloqueios BG1 e BG3
- Cadastro de Layouts do Cartão
- Cadastro Formas de Pagamento
- API Primeiro Acesso - novoUsuario
- API Login Beneficiário - login
- API Reiniciar Senha - reiniciarSenha
- API Trocar Senha - trocarSenha
- API Extrato de Utilização - extrato
- API Lista Débitos - listaDebitos
- API Detalhe Débito - detalheDebito
- API Boleto PDF - boletoPdf
- API Extrato Fatura PDF - extratoFaturaPdf
- Menus
- Tabelas Utilizadas
01. DADOS GERAIS
...
Solucoes_totvs | ||
---|---|---|
|
...
Linhas_totvs | ||
---|---|---|
|
...
Segmentos_totvs | ||
---|---|---|
|
...
- de Configurações APIS de Terceiros
- Detalhamento da Funcionalidade
- Menus
- Tabelas Utilizadas
- 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.
Bloco de código | ||
---|---|---|
| ||
[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:
Campo | Conteúdo |
---|---|
Parâmetro | MV_PLSHAT |
Tipo | Caracter |
Descrição | Habilita integração PLS x HAT |
Conteúdo | 1 |
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:
Rotina | PLMensSchd |
---|---|
Parâmetros | Operadora - Indique a código da Operadora parametrizada |
Ambiente | Ambiente utilizado |
Empresa/Filial | Empresa/Filial utilizados |
Módulo | 33 (Plano de Saúde) |
- 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):
Campo | Tipo | Descrição | Funcionalidade |
---|---|---|---|
B7G_CODOPE | Caracter | Cod Operad. | Informar o código da sua Operadora. |
B7G_MSURLM | Caracter | URL Mensag. | URL de acesso as APIS da Mensageria. (Informar https://hat.totvs.com.br/) |
B7G_MSMSGF | Caracter | Msg.Fin.Sala | Informar a mensagem padrão que será utilizada na mensagem que finaliza uma sala (esta mensagem é enviada automaticamente quando o Auditor dar o Parecer ao último evento em Estudo, finalizando a auditoria da guia). |
É 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:
Campo | Tipo | Funcionalidade |
---|---|---|
MV_PHATIDT | Caracter | ID do tenant da operadora no TOTVS Saúde Portal Autorizador. |
MV_PHATNMT | Caracter | Nome do tenant da operadora no TOTVS Saúde Portal Autorizador. |
MV_PHATTOK | Caracter | Token de autorização do TOTVS Saúde Portal Autorizador. |
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:
Menu | Nome Rotina | Função |
---|---|---|
Atualizações / Operadora | Configurações APIS Terceiros | PLSA994 |
07
02. SITUAÇÃO/REQUISITO
03. SOLUÇÃO
...
tabs | Passo 01, Passo 02, Passo 03, Passo 04 |
---|---|
ids | passo1,passo2 |
...
default | yes |
---|---|
referencia | passo1 |
...
default | no |
---|---|
referencia | passo2 |
04. DEMAIS INFORMAÇÕES
Card documentos | ||||
---|---|---|---|---|
|
05. ASSUNTOS RELACIONADOS
05. ASSUNTOS RELACIONADOS
05. ASSUNTOS RELACIONADOS
05. ASSUNTOS RELACIONADOS
...
. TABELAS UTILIZADAS
- Dicionário SX2:
Campo | Conteúdo |
---|---|
X2_CHAVE | B7G |
X2_NOME | Configurações APIS Terceiros |
X2_MODO | Compartilhado |
X2_MODOUN | Exclusivo |
X2_MODOEMP | Exclusivo |
X2_UNICO | B7G_FILIAL + B7G_CODOPE |
...
- Dicionário SX3:
Campos tabela B7G:
Campo | Conteúdo |
---|---|
X3_CAMPO | B7G_FILIAL |
X3_ORDEM | 01 |
X3_TIPO | Caracter |
X3_TAMANHO | 8 |
X3_DECIMAL | 0 |
X3_TITULO | Filial |
X3_DESCRIC | Filial do Sistema |
X3_PICTURE | @! |
X3_USADO | Não |
X3_OBRIGAT | Não |
X3_RELACAO | |
X3_VALID | |
X3_FOLDER | 1 |
X3_BROWSE | Não |
X3_VISUAL | Visual |
X3_CONTEXT | Real |
Campo | Conteúdo |
---|---|
X3_CAMPO | B7G_CODOPE |
X3_ORDEM | 02 |
X3_TIPO | Caracter |
X3_TAMANHO | 4 |
X3_DECIMAL | 0 |
X3_TITULO | Cod Operad. |
X3_DESCRIC | Código Operadora |
X3_PICTURE | @! |
X3_USADO | Sim |
X3_OBRIGAT | Sim |
X3_RELACAO | |
X3_VALID | Vazio() .Or. (ExistCpo("BA0",M->B7G_CODOPE,1) .And. ExistChav("B7G") ) |
X3_FOLDER | 1 |
X3_BROWSE | Sim |
X3_VISUAL | Alterar |
X3_CONTEXT | Real |
X3_F3 | BA0OPE |
X3_TRIGGER | S |
Campo | Conteúdo |
---|---|
X3_CAMPO | B7G_DESOPE |
X3_ORDEM | 03 |
X3_TIPO | Caracter |
X3_TAMANHO | 60 |
X3_DECIMAL | 0 |
X3_TITULO | Desc. Oper. |
X3_DESCRIC | Descricao Operadora |
X3_PICTURE | @! |
X3_USADO | Sim |
X3_OBRIGAT | Não |
X3_RELACAO | If(INCLUI,"",Posicione("BA0",1,xFilial("BA0")+B7G->B7G_CODOPE,"BA0_NOMINT")) |
X3_VALID | |
X3_FOLDER | 2 |
X3_BROWSE | Sim |
X3_VISUAL | Visual |
X3_CONTEXT | Virtual |
X3_INIBRW | Posicione("BA0",1,xFilial("BA0")+B7G->B7G_CODOPE,"BA0_NOMINT") |
Campo | Conteúdo |
---|---|
X3_CAMPO | B7G |
_ |
MSURLM | |
X3_ORDEM | 08 |
X3_TIPO | Caracter |
X3_TAMANHO | 100 |
X3_DECIMAL | 0 |
X3_TITULO | URL Mensag. |
X3_DESCRIC | URL Mensageria |
X3_PICTURE | |
X3_USADO | Sim |
X3_OBRIGAT | Não |
X3_RELACAO | |
X3_VALID | |
X3_FOLDER | 2 |
X3_BROWSE | Não |
X3_VISUAL | Alterar |
X3_CONTEXT | Real |
Campo | Conteúdo |
---|---|
X3_CAMPO | B7G_ |
MSMSGF | |
X3_ORDEM | 10 |
X3_TIPO | Memo |
X3_TAMANHO | 100 |
X3_DECIMAL | 0 |
X3_TITULO | Msg.Fin.Sala |
X3_DESCRIC | Mensagem Finalização Sala |
X3_PICTURE | |
X3_USADO | Sim |
X3_OBRIGAT | Não |
X3_RELACAO | |
X3_VALID | |
X3_FOLDER | 2 |
X3_BROWSE | Não |
X3_VISUAL | Alterar |
X3_CONTEXT | Real |
Campos tabela B7GB53:
Campo | Conteúdo |
---|---|
X3_CAMPO | B53_MSGSTA |
X3_TIPO | Caracter |
X3_TAMANHO | 1 |
X3_DECIMAL | 0 |
X3_TITULO | Status Mens. |
X3_DESCRIC | Status Mensageria |
X3_PICTURE | @! |
X3_USADO | Sim |
X3_OBRIGAT | Não |
X3_CBOX | 1=Pend. Auditor;2=Pend. Prestador;3=Finalizado |
X3_RELACAO | |
X3_VALID | |
X3_FOLDER | |
X3_BROWSE | Não |
X3_VISUAL | Visual |
X3_CONTEXT | Real |
- Dicionário SIX:
Índices tabela B7G:
...
Campo | Conteúdo |
---|---|
XA_ALIAS | B7G |
XA_ORDEM | 2 |
XA_DESCRIC | Mensageria |
XA_PROPRI | S |
- Dicionário SX7:
Gatilhos B7G:
Campo | Conteúdo |
---|---|
X7_CAMPO | B7G_CODOPE |
X7_SEQUENC | 001 |
X7_REGRA | BA0->BA0_NOMINT |
X7_CDOMIN | B7G_DESOPE |
X7_TIPO | X |
X7_SEEK | S |
X7_ALIAS | BA0 |
X7_ORDEM | 1 |
X7_CHAVE | xFilial("BA0")+M->B7G_CODOPE |
X7_CONDIC | |
X7_PROPRI | S |
...
08. CAMPOS DESCONTINUADOS
Os campos abaixo faziam parte da versão inicial, porém foram descontinuados:
Campo | Tipo | Tamanho | Descrição |
---|---|---|---|
B7G_MSURLR | Caracter | 100 | URL Rac |
B7G_MSCLID | Caracter | 50 | Client ID |
B7G_MSCSEC | Caracter | 50 | ClientSecret |
B7G_MSUSER | Caracter | 30 | Username |
B7G_MSPASS | Caracter | 30 | Password |
Templatedocumentos |
---|