Passo 4 - Configurar Integração Cadastral

Visão Geral

A Integração Cadastral tem como objetivo efetuar a comunicação e transferência de dados entre o TOTVS Saúde Portal Autorizador e o Protheus PLS, com a finalidade de manter os dados íntegros e atualizados para a utilização.

Serão transferidos os dados de atualizações cadastrais dos beneficiários, os cadastros e as atualizações dos produtos, e as  alterações e configurações dos procedimentos, materiais, exames, etc.

Configurando a integração

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

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

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

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

PLSA274 - Gerenciamento dos pedidos de integração

PLSA275 - Endpoints de integração

PLSA277 - Erros Pedidos HAT

PLSA417 - Gestão de lotes do HAT

Carregar as transações - PLSA275 - Endpoints de integração

Acesse a rotina PLSA275 - Endpoints de integração no menu do Totvs Saúde Protheus e clique no botão Carregar Transações para que os endpoints de integração sejam carregados.

Configuração no APPSERVER.INI

No appserver.ini do ambiente crie as chaves abaixo:

;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$   SESSÃO DE AMBIENTE (ACRESCENTAR AS CHAVES ABAIXO) $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$

[AMBIENTE/ENVIROMENT]
...
JEMP=CodigoEmpresa
JFIL=CodigoFilial
EMPROBOXML=CodigoEmpresa
FILROBOXML=CodigoFilial
...  

;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$   JOBS INTEGRACAO HAT $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
[ONSTART]
JOBS=IMPXML,XML_ROBOT,PJobHatXML,PLSYNCAUTH,PLSYNCLIAT,PLSYNCTREX,PLSHAT
Refreshrate=120

#Job responsavel por realizar a importação dos XML's para o Protheus
[IMPXML]
Enviroment=SEU_AMBIENTE
Main=XmlImport
PREPAREIN=CodigoEmpresa,CodigoFilial  

#Job responsavel por processar os XML's baixados
[XML_ROBOT]
ENVIRONMENT=SEU_AMBIENTE
main=xmlroute
PREPAREIN=CodigoEmpresa,CodigoFilial  

#Job responsavel por verificar se existem arquivos XML para baixar e realizar o download
[PJobHatXML]
ENVIRONMENT=SEU_AMBIENTE
INSTANCES=1,1
main=PJobHatXML 
PREPAREIN=CodigoEmpresa,CodigoFilial 

#Job responsavel por integrar as guias de autorização e as guias canceladas
[PLSYNCAUTH]
ENVIRONMENT=SEU_AMBIENTE
MAIN=PLSYNCAUTH
INSTANCES=1,1
PREPAREIN=CodigoEmpresa,CodigoFilial  

#Job responsavel por integrar as guias de anexos clinicos e as guias de anexos canceladas
[PLSYNCLIAT]
ENVIRONMENT=SEU_AMBIENTE
MAIN=PLSYNCLIAT
INSTANCES=1,1 
PREPAREIN=CodigoEmpresa,CodigoFilial

#Job responsavel por integrar as guias de prorrogação de internação e as prorrogações canceladas
[PLSYNCTREX]
ENVIRONMENT=SEU_AMBIENTE
MAIN=PLSYNCTREX
INSTANCES=1,1
PREPAREIN=CodigoEmpresa,CodigoFilial  

#Job resposavel por realizar a integração de dados
[PLSHAT]
main=PJobPlsHat 
ENVIRONMENT=SEU_AMBIENTE
INSTANCES=1,1
PREPAREIN=CodigoEmpresa,CodigoFilial

;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$  FIM DA CONFIGURACAO DAS JOBS DE INTEGRACAO HAT $$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$

Obs.: também deve ser adicionada a chave PREPAREIN=CodigoEmpresa,CodigoFilial na sessão que é chamada na chave URIs do [HTTPURI], no APPSERVER.ini.

Para mais informações sobre o PJobHatXML consulte o documento disponível em: https://tdn.totvs.com/pages/viewpage.action?pageId=636318321

IMPORTANTE: O job PLSHAT(PJobPlsHat) necessita de algumas configurações e campos adicionais, para mais informações acesse o documento disponível em:  DT Implementação Jobs Integração PLS x HAT

Logs das funções e chaves da sessão ambiente

Durante a execução das funções, são utilizadas as chaves JEMP, JFIL, EMPROBOXML e FILROBOXML configuradas na sessão [AMBIENTE/ENVIROMENT] do APPSERVER.INI.

A seguir está a lista de quais funções utilizam quais chaves, junto com quais logs são gerados durante sua execução.

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

Para realizar a integração, basta fazer a chamada das rotinas conforme configuração mostrada no passo  4.1 - Configurar Integração Cadastral

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. 

IMPORTANTE

As guias integradas via API, não geram movimentação nas tabelas de processamento de contas (BD5, BD6 e BD7)

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

Caso queira utilizar a integração de dados PLENVHATSC() no schedule, não realize a configuração do job PLSHAT(PJobPlsHat) no appserver.ini e siga as instruções do passo 4.1 - Configurar Agendamento de Integração (Schedule)