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.
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
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
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
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).
Parâmetro | MV_PLSHAT |
---|---|
Descrição | Habilita a integração com o TOTVS Saúde Portal Autorizador. 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 TOTVS Saúde Portal Autorizador |
Tipo | Caractere |
Conteúdo | Preencher com: 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 TOTVS Saúde Portal Autorizador. 1 Habilita o log da integração com o TOTVS Saúde Portal Autorizador e 0 desabilita o log integração com o TOTVS Saúde Portal Autorizador. |
Tipo | Caractere |
Conteúdo | 1 |
Parâmetro | MV_PSVCLOG |
---|---|
Descrição | Habilita log para serviços do PLS (0=Desativado / 1=Ativado) |
Tipo | Caractere |
Conteúdo | 1 |
Parâmetro | MV_PHATTOK |
---|---|
Descrição | Token de autorização do TOTVS Saúde Portal Autorizador. |
Tipo | Caractere |
Conteúdo | Preencher com o token gerado na tela Configurações de integração do portal de administração. Somente os números, sem os traços ( - ). Configurar Chave de Autenticação das Integrações (Master Token) e Dados de integração |
Parâmetro | MV_PHATIDT |
---|---|
Descrição | ID do tenant da operadora no TOTVS Saúde Portal Autorizador. |
Tipo | Caractere |
Conteúdo | Preencher com o id do tenant apresentado na tela Configurações de integração do portal de administração. Configurar Chave de Autenticação das Integrações (Master Token) e Dados de integração |
Parâmetro | MV_PHATNMT |
---|---|
Descrição | Nome do tenant da operadora no TOTVS Saúde Portal Autorizador. |
Tipo | Caractere |
Conteúdo | Preencher com o nome do tenant apresentado na tela Configurações de integração do portal de administração. Configurar Chave de Autenticação das Integrações (Master Token) e Dados de integração |
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
Campo | Valor |
---|---|
Desc. Portugues | Geren. Ped. Integra |
Programa | PLSA274 |
Status | Habilitado |
Módulo | Plano de Saúde |
Tipo | Função Protheus |
Campo | Valor |
---|---|
Desc. Portugues | End. Integr. HAT |
Programa | PLSA275 |
Status | Habilitado |
Módulo | Plano de Saúde |
Tipo | Função Protheus |
Campo | Valor |
---|---|
Desc. Portugues | Erros Pedidos HAT |
Programa | PLSA277 |
Status | Habilitado |
Módulo | Plano de Saúde |
Tipo | Função Protheus |
Campo | Valor |
---|---|
Desc. Portugues | Gestao Lotes HAT |
Programa | PLSA417 |
Status | Habilitado |
Módulo | Plano de Saúde |
Tipo | Função Protheus |
Campo | Valor |
---|---|
Desc. Portugues | Wizard HAT |
Programa | PLHATWZD |
Status | Habilitado |
Módulo | Plano de Saúde |
Tipo | Função Protheus |
No appserver.ini do ambiente crie 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 #Job responsavel por processar os XML's baixados [XML_ROBOT] ENVIRONMENT=SEU_AMBIENTE main=xmlroute #Job responsavel por verificar se existem arquivos XML para baixar e realizar o download [PJobHatXML] ENVIRONMENT=SEU_AMBIENTE INSTANCES=1,1 main=PJobHatXML #Job responsavel por integrar as guias de autorização e as guias canceladas [PLSYNCAUTH] ENVIRONMENT=SEU_AMBIENTE MAIN=PLSYNCAUTH INSTANCES=1,1 #Job responsavel por integrar as guias de anexos clinicos e as guias de anexos canceladas [PLSYNCLIAT] ENVIRONMENT=SEU_AMBIENTE MAIN=PLSYNCLIAT INSTANCES=1,1 #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 #Job resposavel por realizar a integração de dados [PLSHAT] main=PJobPlsHat ENVIRONMENT=SEU_AMBIENTE INSTANCES=1,1 ;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ ;$$$$$$$$$$$$$$$$$$$$$$ FIM DA CONFIGURACAO DAS JOBS DE INTEGRACAO HAT $$$$$$$$$$$$$$$$$$$$$$$ ;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
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
Para realizar a integração, basta fazer a chamada das rotinas conforme configuração mostrada no passo 4.1 - Configurar Integração Cadastral
Função | Descrição |
---|---|
PLSYNCAUTH | Responsável por realizar a integração das Autorizações. |
PLSYNCLIAT | Responsável por realizar a integração dos Anexo Clinico. |
PLSYNCTREX | Responsável por realizar a integração das prorrogações. |
Observação.:
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)
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