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) 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:
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 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 |
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 PLENVHAT. 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.