Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 12

changes.mady.by.user Renan Sakai de Almeida

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Renan Sakai de Almeida

Gravado em

Chave

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

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. 

...

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
titleappserver.ini
[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:

CampoConteúdo
ParâmetroMV_
PLHAT
PLSHAT
TipoCaracter
DescriçãoHabilita integração PLS x HAT
Conteúdo1


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

...

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

Rotina 

PLChatSchd

PLMensSchd

ParâmetrosOperadora - Indique a código da Operadora parametrizada
AmbienteAmbiente utilizado
Empresa/FilialEmpresa/Filial utilizados 
Módulo33 (Plano de Saúde)


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

...

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 / Config. API Terceiros 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. Esses dados devem ser solicitados a equipe técnica responsável pelo Portal Autorizador HAT.

Image Removed

Image Added

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


Parâmetros (SX6):

Campo
CampoTipo
UsernameNome de usuário da Operadora que realizará acesso a Mensageria.B7G_MSPASSPasswordSenha da Operadora que realizará acesso a Mensageria.B7G_MSCLIDClient IDID de acesso da Operadora a Mensageria.B7G_MSCSECClient SecretClient Secret para acesso da Operadora a Mensageria.B7G_MSURLM
DescriçãoFuncionalidade
B7G_CODOPECaracterCod Operad.Informar o código da sua Operadora.
B7G_
MSUSER
MSURLMCaracter
URL Mensag.URL de acesso as APIS da Mensageria.
B7G_MSURLRURL RacURL de acesso ao RAC (sistema de logins do Portal Autorizador RAC).
(Informar https://hat.totvs.com.br/)
B7G_MSMSGFCaracterMsg.Fin.SalaInformar 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:

Image Added


CampoTipoFuncionalidade
MV_PHATIDTCaracterID do tenant da operadora no TOTVS Saúde Portal Autorizador.
MV_PHATNMTCaracterNome do tenant da operadora no TOTVS Saúde Portal Autorizador.
MV_PHATTOKCaracterToken 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.

...

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

Image RemovedImage Added

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. 

Image RemovedImage Added


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:Image Removed.

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:

Image RemovedImage Added

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.

Image RemovedImage Added


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.

...

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:

Image RemovedImage Added


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:

Image RemovedImage Added


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:

Image RemovedImage Added


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.

Image RemovedImage Added

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:

Image Added


06. MENUS

Adicione os menus abaixo:

Menu

Nome Rotina

Função

Atualizações / OperadoraConfigurações APIS TerceirosPLSA994

...

07. TABELAS UTILIZADAS

  • Dicionário SX2:

Campo

Conteúdo

X2_CHAVEB7G
X2_NOMEConfigurações APIS Terceiros
X2_MODOCompartilhado
X2_MODOUNExclusivo
X2_MODOEMPExclusivo
X2_UNICOB7G_FILIAL + B7G_CODOPE

...

  • Dicionário SX3:

Campos tabela B7G:

CampoConteúdo
X3_CAMPOB7G_FILIAL
X3_ORDEM01
X3_TIPOCaracter
X3_TAMANHO8
X3_DECIMAL0
X3_TITULOFilial
X3_DESCRICFilial do Sistema
X3_PICTURE@!
X3_USADONão
X3_OBRIGATNão
X3_RELACAO
X3_VALID
X3_FOLDER1
X3_BROWSENão
X3_VISUALVisual
X3_CONTEXTReal
CampoConteúdo
X3_CAMPOB7G_CODOPE
X3_ORDEM02
X3_TIPOCaracter
X3_TAMANHO4
X3_DECIMAL0
X3_TITULOCod Operad.
X3_DESCRICCódigo Operadora
X3_PICTURE@!
X3_USADOSim
X3_OBRIGATSim
X3_RELACAO
X3_VALIDVazio() .Or. (ExistCpo("BA0",M->B7G_CODOPE,1) .And. ExistChav("B7G") )
X3_FOLDER1
X3_BROWSESim
X3_VISUALAlterar
X3_CONTEXTReal
X3_F3

BA0OPE

X3_TRIGGERS
CampoConteúdo
X3_CAMPOB7G_DESOPE
X3_ORDEM03
X3_TIPOCaracter
X3_TAMANHO60
X3_DECIMAL0
X3_TITULODesc. Oper.
X3_DESCRICDescricao Operadora
X3_PICTURE@!
X3_USADOSim
X3_OBRIGATNão
X3_RELACAOIf(INCLUI,"",Posicione("BA0",1,xFilial("BA0")+B7G->B7G_CODOPE,"BA0_NOMINT"))
X3_VALID
X3_FOLDER2
X3_BROWSESim
X3_VISUALVisual
X3_CONTEXTVirtual
X3_INIBRWPosicione("BA0",1,xFilial("BA0")+B7G->B7G_CODOPE,"BA0_NOMINT")
CampoConteúdo
X3_CAMPOB7G_
MSUSERX3_ORDEM04X3_TIPOCaracterX3_TAMANHO30X3_DECIMAL0X3_TITULOUsernameX3_DESCRICUsernameX3_PICTUREX3_USADOSimX3_OBRIGATNãoX3_RELACAOX3_VALIDX3_FOLDER2X3_BROWSENãoX3_VISUALAlterarX3_CONTEXTRealCampoConteúdoX3_CAMPOB7G_MSPASSX3_ORDEM05X3_TIPOCaracterX3_TAMANHO30X3_DECIMAL0X3_TITULOPasswordX3_DESCRICPasswordX3_PICTUREX3_USADOSimX3_OBRIGATNãoX3_RELACAOX3_VALIDX3_FOLDER2X3_BROWSENãoX3_VISUALAlterarX3_CONTEXTRealCampoConteúdoX3_CAMPOB7G_MSCLIDX3_ORDEM06X3_TIPOCaracterX3_TAMANHO50X3_DECIMAL0X3_TITULOClient IDX3_DESCRICClient IDX3_PICTUREX3_USADOSimX3_OBRIGATNãoX3_RELACAOX3_VALIDX3_FOLDER2X3_BROWSENãoX3_VISUALAlterarX3_CONTEXTRealCampoConteúdoX3_CAMPOB7G_MSCSECX3_ORDEM07X3_TIPOCaracterX3_TAMANHO50X3_DECIMAL0X3_TITULOClient SecretX3_DESCRICClient SecretX3_PICTUREX3_USADOSimX3_OBRIGATNãoX3_RELACAOX3_VALIDX3_FOLDER2X3_BROWSENãoX3_VISUALAlterarX3_CONTEXTRealCampoConteúdoX3_CAMPOB7G_
MSURLM
X3_ORDEM08
X3_TIPOCaracter
X3_TAMANHO100
X3_DECIMAL0
X3_TITULOURL Mensag.
X3_DESCRICURL Mensageria
X3_PICTUREX3_USADOSimX3_OBRIGATNãoX3_RELACAOX3_VALIDX3_FOLDER2X3_BROWSENãoX3_VISUALAlterarX3_CONTEXTRealCampoConteúdo
X3_
CAMPOB7G_MSURLRX3_ORDEM09X3_TIPOCaracterX3_TAMANHO100X3_DECIMAL0X3_TITULOURL RacX3_DESCRICURL RacX3_
PICTURE
X3_USADOSim
X3_OBRIGATNão
X3_RELACAO
X3_VALID
X3_FOLDER2
X3_BROWSENão
X3_VISUALAlterar
X3_CONTEXTReal
CampoConteúdo
X3_CAMPOB7G_MSMSGF
X3_ORDEM10
X3_TIPOMemo
X3_TAMANHO100
X3_DECIMAL0
X3_TITULOMsg.Fin.Sala
X3_DESCRICMensagem Finalização Sala
X3_PICTURE
X3_USADOSim
X3_OBRIGATNão
X3_RELACAO
X3_VALID
X3_FOLDER2
X3_BROWSENão
X3_VISUALAlterar
X3_CONTEXTReal


Campos tabela B7GB53:

CampoConteúdo
X3_CAMPOB53_MSGSTA
X3_TIPOCaracter
X3_TAMANHO1
X3_DECIMAL0
X3_TITULOStatus Mens.
X3_DESCRICStatus Mensageria
X3_PICTURE@!
X3_USADOSim
X3_OBRIGATNão
X3_CBOX1=Pend. Auditor;2=Pend. Prestador;3=Finalizado
X3_RELACAO
X3_VALID
X3_FOLDER
X3_BROWSENão
X3_VISUALVisual
X3_CONTEXTReal


  • Dicionário SIX:

Índices tabela B7G:

...

CampoConteúdo
X7_CAMPOB7G_CODOPE
X7_SEQUENC001
X7_REGRABA0->BA0_NOMINT
X7_CDOMINB7G_DESOPE
X7_TIPOX
X7_SEEKS
X7_ALIASBA0
X7_ORDEM1
X7_CHAVExFilial("BA0")+M->B7G_CODOPE
X7_CONDIC
X7_PROPRIS


08. CAMPOS DESCONTINUADOS

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

CampoTipoTamanhoDescrição
B7G_MSURLRCaracter100URL Rac     
B7G_MSCLIDCaracter50Client ID   
B7G_MSCSECCaracter50ClientSecret
B7G_MSUSERCaracter30Username
B7G_MSPASSCaracter30Password


Templatedocumentos