Histórico da Página
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) o TOTVS Saúde Portal Autorizador com o Protheus PLS.
Integração
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. 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 do TOTVS Saúde Portal Autorizador x PLS são:
PLENVHAT – Fonte de envio dos pedidos para o HAT TOTVS Saúde Portal Autorizador. Este fonte é responsável pela montagem do JSON e envio do mesmo para o HAT TOTVS Saúde Portal Autorizador.
PLHATMAP – É o “mapa” dos dados que serão enviados ao HAT TOTVS Saúde Portal Autorizador. Ele monta arrays com as estruturas de dados que serão enviados ao HAT 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 HAT.
UPPLSHAT – Compatibilizador para a criação da estrutura de dados (fonte temporário, criado para auxiliar no desenvolvimento).
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 | ||||
---|---|---|---|---|
| ||||
<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 TOTVS Saúde Portal Autorizador funcione corretamente é necessário que os parâmetros abaixo estejam configurados.
Parâmetro | MV_PLSHAT |
---|---|
Descrição | Habilita a integração com o HAT. 1 habilita a integração e 0 desabilita a Integração. |
Tipo | Caractere |
Conteúdo | 1 |
Parâmetro | MV_PHATURL |
---|---|
Descrição | Indica o endereço do endpoint de integração do HAT |
Tipo | Caractere |
Conteúdo | https://hat.totvs.com.br/api/healthcare/hat/ |
Parâmetro | MV_PHATLOG |
---|---|
Descrição | Registra as informações das transações feitas pela integração com o HAT. 1 Habilita o log da integração com o HAT e 0 desabilita o log integração com o HAT. |
Tipo | Caractere |
Conteúdo | 1 |
Instalação/Atualização
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).
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
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), preencher o campo EndpointAut (BA0_ENDPOI) com o valor: https://hat.totvs.com.br/api/healthcare/hat/v1/auditing
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.