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 o HAT(Health Autorizer Totvs) com o Protheus PLS.

Sistemas Envolvidos

Health Authorizer TOTVS (HAT)

SIGAPLS

Integração

Essa integração foi feita para que haja a comunicação e transferencia de dados entre o HAT e o Protheus PLS, ajudando a manter os dados integros e atualizados para a utillizaçã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 autorizador do Protheus PLS é necessário que algumas informações estejam atualizadas no banco de dados do HAT. Essa integração foi criada para atender essa demanda e trazer agilidade nas rotinas de atendimento por parte dos prestadores.

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.

Instalação/Atualização

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

Configuração do Schedule

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().

A opção Recorrencia () permite que você configure a frequência da troca de informações entre o HAT 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 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:

Integraçã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 - 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