Índice

Introdução

INTEGRAÇÃO HAT X PLS (PROTHEUS)

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

Sistemas Envolvidos

Health Authorizer TOTVS (HAT)TOTVS Saúde Portal Autorizador

SIGAPLS

Sobre a integração de dados

Essa integração foi feita para que haja a comunicação e transferencia transferência de dados entre o HAT TOTVS Saúde Portal Autorizador e o Protheus PLS, ajudando a manter os dados integros íntegros e atualizados para a utillizaçãoutilizaçã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 HAT como protal 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 o TOTVS Saúde Portal Autorizador é 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

3 - Configuração de parâmetros

Para que a integração com o TOTVS Saúde Portal Autorizador

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

Principais fontes da integração do HAT x PLS são:

PLENVHAT – Fonte de envio dos pedidos para o HAT. Este fonte é responsável pela montagem do JSON e envio do mesmo para o HAT.

PLHATMAP – É o “mapa” dos dados que serão enviados ao HAT. Ele monta arrays com as estruturas de dados que serão enviados ao HAT. 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 HAT.

UPPLSHAT – Compatibilizador para a criação da estrutura de dados (fonte temporário, criado para auxiliar no desenvolvimento).

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.

12.1.25: https://suporte.totvs.com/portal/p/10098/download?e=777476
12.1.23: https://suporte.totvs.com/portal/p/10098/download?e=777475
12.1.17: https://suporte.totvs.com/portal/p/10098/download?e=777474

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:

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

Configuração dos parâmetros:

Para que a integração com o HAT funcione corretamente é necessário que os parâmetros abaixo estejam configurados no Configurador (SIGACFG).

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

4.2 - PLSA275 - Endpoints de integração

4.3 - PLSA277 - Erros Pedidos HAT

4.4 - PLSA417 - Gestão de lotes do HAT

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

5 - Configuração no APPSERVER.INI

No appserver.ini do ambiente crie as chaves abaixo:

[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

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:

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

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

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

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

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

Na pasta Schedule 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 ( Image Removed[Home Soluções Saúde > INTEGRAÇÃO TOTVS Saúde Portal Autorizador x PLS (PROTHEUS) > recorrencia.PNG] ) permite que você configure a frequência da troca de informações entre o HAT 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 HAT 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

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

Configuração do robô para envio de XML:

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

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 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=525032764Integração Upload XML PLS X HAT - Plano de Saúde - P12

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

Views de extração de dados PLS - Protheuspara ETL no TOTVS Saúde Portal Autorizador

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