Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

Índice

Introdução

INTEGRAÇÃO HAT X PLS (PROTHEUS)

Contexto de negócio (Introdução)

Este documento trata das informações referente as configurações para integração com entre TOTVS Saúde Portal Autorizador com o Protheus PLS.


Sistemas Envolvidos

TOTVS Saúde Portal Autorizador

SIGAPLS

Integração


Sobre a integração de dados

Essa integração foi feita para que haja a comunicação e transferência de dados entre o TOTVS Saúde Portal Autorizador e o Protheus PLS, ajudando a manter os dados íntegros e atualizados para a utilização.

Serão transferidos dados de atualizações cadastrais dos beneficiários, cadastros e atualizações de produtos além de dados referente a alterações nas configurações dos procedimentos, materiais, exames, etc.

Para que o cliente possa utilizar o  TOTVS Saúde Portal Autorizador como portal autorizador do Protheus PLS é necessário que algumas informações estejam atualizadas no banco de dados do HAT TOTVS Saúde Portal Autorizador. Essa integração foi criada para atender essa demanda e trazer agilidade nas rotinas de atendimento por parte dos prestadores.



Configurando a integração

Para que a integração entre o Protheus PLS e

Pré-requisitos instalação/implantação/utilização

Principais fontes da integração do  TOTVS Saúde Portal Autorizador x PLS são:

PLENVHAT – Fonte de envio dos pedidos para o TOTVS Saúde Portal Autorizador. Este fonte é responsável pela montagem do JSON e envio do mesmo para o TOTVS Saúde Portal Autorizador.

PLHATMAP – É o “mapa” dos dados que serão enviados ao TOTVS Saúde Portal Autorizador. Ele monta arrays com as estruturas de dados que serão enviados ao TOTVS Saúde Portal Autorizador. Os dados são separados por Alias.

PLSHATPED – Este fonte realiza a gestão da gravação dos pedidos. Sempre que um registro que deve ser enviado no HAT por incluído/alterado no Protheus, esse fonte realiza a gravação do pedido.

PLSA275 – Carrega as transações/Ações do TOTVS Saúde Portal Autorizador.

Para que os fontes sejam incluídos no RPO deve ser baixado o patch através do link abaixo e aplicado no ambiente do Protheus PLS.

*** Incluir link de download ***

Adicione no menu sigapls.xnu, a rotina PLSA275 – Transações HAT. Ao entrar na rotina, clique no botão Carregar Transações para carregar todas as integrações já desenvolvidas.

Caso deseje que uma transação seja enviada prioritariamente, selecione a mesma, clique em Alterar e preencha o campo Prior. (BNN_PRIORI) com “1- Sim”.

Exemplo de inclusão do menu no arquivo sigapls.xnu:

Bloco de código
languagexml
themeMidnight
<Menu Status="Enable">
	<Title lang="pt">Genérico</Title>
	<Title lang="es">Generico</Title>
	<Title lang="en">Generic</Title>
	<ItemId>0000005777</ItemId>
		<MenuItem Status="Enable">
			<Title lang="pt">Transações Hat.</Title>
			<Title lang="es">Transações Hat.</Title>
			<Title lang="en">Transações Hat.</Title>
			<Function>PLSA275</Function>
			<Type>01</Type>
			<Access>xxxxxxxxxx</Access>
			<Module>33</Module>
			<Owner>0</Owner>
			<ItemId>0000023125</ItemId>
			<KeyWord>
				<KeyWord lang="pt"></KeyWord>
				<KeyWord lang="es"></KeyWord>
				<KeyWord lang="en"></KeyWord>
			</KeyWord>
		</MenuItem>
</Menu>

é necessário que alguns procedimentos sejam executados. Algumas configurações devem ser feitas dentro do Configurador (SIGACFG) do Protheus, para instruções sobre como utilizar o Configurador (SIGACFG) acesse o documento Framework - Protheus 12

1 - Dicionário de dados

Certifique-se que seu ambiente esteja com as ultimas atualizações disponíveis no portal de Expedição Contínua Protheus - Linha Microsiga Protheus - TDN (totvs.com).

Para a listagem das tabelas acesse o link: Tabelas utilizadas na integração com o TOTVS Saúde Portal Autorizador

2 -Pacote de atualização

Certifique-se que seu ambiente esteja com as ultimas atualizações disponíveis no portal de Expedição Contínua Protheus - Linha Microsiga Protheus - TDN (totvs.com).

Para a listagem dos fontes utilizados acesse o link: Fontes utilizados na integração com o TOTVS Saúde Portal Autorizador - Home Soluções Saúde - TDN

Configuração dos parâmetros:

3 - Configuração de parâmetros


Para que a integração com o TOTVS Saúde Portal Autorizador funcione corretamente é necessário que os parâmetros abaixo estejam configurados no Configurador (SIGACFG).

ParâmetroMV_PLSHAT
DescriçãoHabilita a integração com o HATTOTVS Saúde Portal Autorizador. 1 habilita a integração e 0 desabilita a Integração.
TipoCaractere
Conteúdo1
ParâmetroMV_PHATURL
DescriçãoIndica o endereço do endpoint de integração do HATTOTVS Saúde Portal Autorizador
TipoCaractere
Conteúdohttps://hat.totvs.com.br/api/healthcare/hat/
ParâmetroMV_PHATLOG
Descrição

Registra as informações das transações feitas pela integração com o HATTOTVS Saúde Portal Autorizador.

1 Habilita o log da integração com o HAT TOTVS Saúde Portal Autorizador e 0 desabilita o log integração com o HATTOTVS Saúde Portal Autorizador.

TipoCaractere
Conteúdo1
ParâmetroMV_PHATTOK
DescriçãoToken de autorização do TOTVS Saúde Portal Autorizador.
TipoCaractere
Conteúdo
ParâmetroMV_PHATIDT
DescriçãoID do tenant da operadora no TOTVS Saúde Portal Autorizador. 
TipoCaractere
Conteúdo
ParâmetroMV_PHATNMT
DescriçãoNome do tenant da operadora no TOTVS Saúde Portal Autorizador.
TipoCaractere
Conteúdo

4 -Menus do sistema

Criar os menus abaixo no Configurador (SIGACFG) dentro do módulo Plano de saúde (Módulo 33) para gerenciar os pedidos de integração

4.1

- PLSA274 - Gerenciamento dos pedidos de integração

CampoValor
Desc. PortuguesGeren. Ped. Integra
ProgramaPLSA274
StatusHabilitado
MóduloPlano de Saúde

Tipo

Função Protheus

4.2 - PLSA275 - Endpoints de integração

CampoValor
Desc. PortuguesEnd. Integr. HAT
ProgramaPLSA275
StatusHabilitado
MóduloPlano de Saúde
TipoFunção Protheus

4.3 - PLSA277 - Erros Pedidos HAT

CampoValor
Desc. PortuguesErros Pedidos HAT
ProgramaPLSA277
StatusHabilitado
MóduloPlano de Saúde
TipoFunção Protheus

4.4 - PLSA417 - Gestão de lotes do HAT

CampoValor
Desc. PortuguesGestao Lotes HAT
ProgramaPLSA417
StatusHabilitado
MóduloPlano de Saúde
TipoFunção Protheus


4.5 - PLHATWZD - Wizard de configuração de tabelas do hat

CampoValor
Desc. PortuguesWizard HAT
ProgramaPLHATWZD
StatusHabilitado
MóduloPlano de Saúde
TipoFunção Protheus

5 - Configuração no APPSERVER.INI

No appserver.ini do ambiente crie as chaves abaixo:

Bloco de código
themeMidnight
titleappserver.ini
[AMBIENTE/ENVIROMENT]
...
JEMP=CodigoEmpresa
JFIL=CodigoFilial
EMPROBOXML=CodigoEmpresa
FILROBOXML=CodigoFilial
...

[ONSTART]
JOBS=IMPXML,XML_ROBOT,PLSXHAT002,PLSVHAT002,FWSCHDMANAG,FWSCHDQUEUE, PLSYNCAUTH, PLSYNCLIAT, PLSYNCTREX
Refreshrate=120

[IMPXML]
Enviroment=SEUAMBIENTEAQUI
Main=XmlImport //nome da função que processa a importação do xml

[XML_ROBOT]
ENVIRONMENT=SEUAMBIENTEAQUI
main=xmlroute //nome da função que checa as regras e define se o arquivo foi acatado ou não

[PLSXHAT002]
ENVIRONMENT=SEUAMBIENTEAQUI
main=PLSxHAT002 //Integração para verificação se há XML disponível no HAT para download
Instances=1,1

[PLSVHAT002]
ENVIRONMENT=SEUAMBIENTEAQUI
main=PLSVHAT002 //Integração para baixar o arquivo XML do HAT
Instances=1,1

[PLSYNCAUTH]
ENVIRONMENT=SEUAMBIENTEAQUI
MAIN=PLSYNCAUTH
INSTANCES=1,1

[PLSYNCLIAT]
ENVIRONMENT=SEUAMBIENTEAQUI
MAIN=PLSYNCLIAT
INSTANCES=1,1

[PLSYNCTREX]
ENVIRONMENT=SEUAMBIENTEAQUI
MAIN=PLSYNCTREX
INSTANCES=1,1

Instalação/Atualização

6 - Configurando o schedule


Para realizar o envio das transações, é necessário chamar a função PLENVHATSC(). Definir com o cliente a periodicidade e chamar ela com um Schedule (ou criar um robô para envio).configurar os 3 schedules descritos abaixo:

FunçãoDescrição
PLENVHATSC()Responsável por realizar a integração de dados cadastrais entre o Protheus e o TOTVS Saúde Portal Autorizador
PLJBATUTISS()Responsável por realizar a atualização dos status dos lotes de faturamento no TOTVS Saúde Portal Autorizador após a validações das regras no Protheus.


7 - Integração autorizações, anexo clinico e prorrogação.

Para realizar a integração, basta fazer a chamada das rotinas conforme exemplo acima:

FunçãoDescrição
PLSYNCAUTHResponsável por realizar a integração das Autorizações.
PLSYNCLIATResponsável por realizar a integração dos Anexo Clinico.
PLSYNCTREXResponsável por realizar a integração das prorrogações.

Observação.: 

  • Os cancelamentos serão considerados quando bea_cancel = 1 e TrackingStatus = 1.
  • TrackingStatus recebe valor 1,2,3 e 4,
    • 1 = Processado com sucesso os atendimentos.
    • 3 = Erro no processamento dos atendimentos.
    • 2 = Processado com sucesso os cancelamentos.
    • 4 = Erro no processamento dos cancelamentos.

Os logs gerados do processamento estão na pasta logpls/data do dia. 

Authorizations, Authorizations - cancelamento, ClinicalAttachments, ClinicalAttachments - cancelamento, TreatmentExtensions e TreatmentExtensions - cancelamento 


Para consultar os dados sincronizados via schedule consulte a documentação disponível em Lista de dados sincronizados através do schedule

Configuração do SchedulePara mais informações sobre como utilizar o schedule do Protheus acesse o endereço: Schedule - Como agendar a execução de rotinas


No Configurador (SIGACFG), acesse Ambientes/Schedule/Schedule (CFGA010).

Na pasta Schedule inicie os serviços Task Manager e Queue Manager.


Na subpasta Agent clique em Incluir para cadastrar um novo agente.

Preencha os campos com as informações de conexão do appserver Protheus. Clique em Confirmar para gravar o cadastro.


Ao acessar a opção Monitor dentro da subpasta Agent o serviço estará criado. Selecione o serviço e clique em Iniciar serviço para ativá-lo.


Acesse a subpasta Agendamentos e clique em Cadastros

Clique em Incluir para cadastrar um novo agendamento. Preencha o campo Rotina(XX1_ROTINA) com a função PLENVHATSC()que deseja executar.

A opção Recorrencia ( [Home Soluções Saúde > INTEGRAÇÃO HAT TOTVS Saúde Portal Autorizador x PLS (PROTHEUS) > recorrencia.PNG] ) permite que você configure a frequência da troca de informações entre o TOTVS Saúde Portal Autorizador e o Protheus PLS.


Finalize o preenchimento dos campos restantes e clique em Confirmar para gravar as alterações.


Acesse a opção Monitor dentro da subpasta Agendamentos e clique em Executar agora para ativar o agendamento.


Após essas configurações a integração com o TOTVS Saúde Portal Autorizador estará ativa e funcional.Tabelas utilizadas na integração

BNN - TABELA COM OS ENDPOINTS DAS TRANSAÇÕES DE INTEGRAÇÃO

BNV - REGISTRO DAS TRANSAÇÕES FEITAS ENTRE O PROTHEUS E O HAT

BWB - TABELA DE LOGS

B2Z - REGISTRO DE AUTORIZAÇÕES FEITAS NO HAT

B1R- XML'S IMPORTADOS DO HAT
Arquivo PLSHAT.ini
Além das configurações do schedule são necessárias algumas outras configurações de integração do HAT, uma delas é o arquivo PLSHAT.INI. A documentação abaixo apresenta as informações sobre como deve ser configurado esse arquivo:
http://tdn.totvs.com/display/public/PROT/DSAUATE-3400+DT+Melhorias+HAT%3A+Arquivo+Plshat.ini
Configurar integração para auditoria médica:
Para que as guias gravadas com status "Auditoria" no HAT possam ser analisadas pelo Protheus é necessário, na rotina Operadora de Saúde (PLSA010),


7 - Configurar integração para auditoria médica

preencher o campo EndpointAut (BA0_ENDPOI) com o valor:

Para que as guias gravadas com status "Auditoria" no TOTVS Saúde Portal Autorizador possam ser analisadas pelo Protheus é necessário, na rotina Operadora de Saúde (PLSA010), preencher o campo EndpointAut (BA0_ENDPOI) com o valor:

https://hat.totvs.com.br/api/healthcare/hat/v1/auditing

8 - Configuração

do

robô

para envio de XML:Integração Upload XML PLS X HAT - Plano de Saúde - P12
Detalhamento das views utilizadas na extração de dados do Protheus - PLS:

para envio de faturamento

Para a integração de envio de lotes de faturamento e XML é necessário que sejam feitas as configurações descritas no documento abaixo:

https://tdn.totvs.com.br/pages/releaseview.action?pageId=525032764

Detalhamento das views utilizadas na extração de dados do Protheus - PLS

Views para ETL no TOTVS Saúde Portal Autorizador

Views de extração de dados PLS - Protheus

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Observação: Este modelo de suporte está sendo revisado pela TOTVS.














 




Anexos