Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

Índice

Introdução

Este documento trata das informações referente as configurações para integração entre o  TOTVS Saúde Portal Autorizador com o Protheus PLS.


Sistemas Envolvidos

TOTVS Saúde Portal Autorizador

SIGAPLS


Sobre a integração de dados

Essa integração foi feita para que haja a comunicação e transferência de dados entre o TOTVS Saúde Portal Autorizador e o Protheus PLS, ajudando a manter os dados íntegros e atualizados para a utilizaçã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  TOTVS Saúde Portal Autorizador como portal autorizador do Protheus PLS é necessário que algumas informações estejam atualizadas no banco de dados do TOTVS Saúde Portal Autorizador. Essa integração foi criada para atender essa demanda e trazer agilidade nas rotinas de atendimento por parte dos prestadores.



Configurando a integração

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

1 - 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

2 -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

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

ParâmetroMV_PLSHAT
DescriçãoHabilita a integração com o TOTVS Saúde Portal Autorizador. 1 habilita a integração e 0 desabilita a Integração.
TipoCaractere
Conteúdo1
ParâmetroMV_PHATURL
DescriçãoIndica o endereço do endpoint de integração do TOTVS Saúde Portal Autorizador
TipoCaractere
Conteúdohttps://hat.totvs.com.br/api/healthcare/hat/
ParâmetroMV_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.

TipoCaractere
Conteúdo1
ParâmetroMV_PHATTOK
DescriçãoToken de autorização do TOTVS Saúde Portal Autorizador.
TipoCaractere
Conteúdo
ParâmetroMV_PHATIDT
DescriçãoID do tenant da operadora no TOTVS Saúde Portal Autorizador. 
TipoCaractere
Conteúdo
ParâmetroMV_PHATNMT
DescriçãoNome do tenant da operadora no TOTVS Saúde Portal Autorizador.
TipoCaractere
Conteúdo

4 -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

4.1 - PLSA274 - Gerenciamento dos pedidos de integração

CampoValor
Desc. PortuguesGeren. Ped. Integra
ProgramaPLSA274
StatusHabilitado
MóduloPlano de Saúde

Tipo

Função Protheus

4.2 - PLSA275 - Endpoints de integração

CampoValor
Desc. PortuguesEnd. Integr. HAT
ProgramaPLSA275
StatusHabilitado
MóduloPlano de Saúde
TipoFunção Protheus

4.3 - PLSA277 - Erros Pedidos HAT

CampoValor
Desc. PortuguesErros Pedidos HAT
ProgramaPLSA277
StatusHabilitado
MóduloPlano de Saúde
TipoFunção Protheus

4.4 - PLSA417 - Gestão de lotes do HAT

CampoValor
Desc. PortuguesGestao Lotes HAT
ProgramaPLSA417
StatusHabilitado
MóduloPlano de Saúde
TipoFunção Protheus


4.5 - PLHATWZD - Wizard de configuração de tabelas do hat

CampoValor
Desc. PortuguesWizard HAT
ProgramaPLHATWZD
StatusHabilitado
MóduloPlano de Saúde
TipoFunção Protheus

5 - Configuração no APPSERVER.INI

No appserver.ini do ambiente crie as chaves abaixo:

Bloco de código
themeMidnight
titleappserver.ini
[AMBIENTE/ENVIROMENT]
...
JEMP=CodigoEmpresa
JFIL=CodigoFilial
EMPROBOXML=CodigoEmpresa
FILROBOXML=CodigoFilial
...

[ONSTART]
JOBS=IMPXML,XML_ROBOT,PLSXHAT002,PLSVHAT002,FWSCHDMANAG,FWSCHDQUEUE, PLSYNCAUTH, PLSYNCLIAT, PLSYNCTREX
Refreshrate=120

[IMPXML]
Enviroment=SEUAMBIENTEAQUI
Main=XmlImport //nome da função que processa a importação do xml

[XML_ROBOT]
ENVIRONMENT=SEUAMBIENTEAQUI
main=xmlroute //nome da função que checa as regras e define se o arquivo foi acatado ou não

[PLSXHAT002]
ENVIRONMENT=SEUAMBIENTEAQUI
main=PLSxHAT002 //Integração para verificação se há XML disponível no HAT para download
Instances=1,1

[PLSVHAT002]
ENVIRONMENT=SEUAMBIENTEAQUI
main=PLSVHAT002 //Integração para baixar o arquivo XML do HAT
Instances=1,1

[FWSCHDMANAG]
Main=FWSCHDMANAG
Environment=SEUAMBIENTEAQUI

[FWSCHDQUEUE]
Main=FWSCHDQUEUE
Environment=SEUAMBIENTEAQUIPLSYNCAUTH]
ENVIRONMENT=SEUAMBIENTEAQUI
MAIN=PLSYNCAUTH
INSTANCES=1,1

[PLSYNCLIAT]
ENVIRONMENT=SEUAMBIENTEAQUI
MAIN=PLSYNCLIAT
INSTANCES=1,1

[PLSYNCTREX]
ENVIRONMENT=SEUAMBIENTEAQUI
MAIN=PLSYNCTREX
INSTANCES=1,1

6 - Configurando o schedule

Para realizar o envio das transações, é necessário configurar os 3 schedules descritos abaixo:

FunçãoDescrição
PLENVHATSC()Responsável por realizar a integração de dados cadastrais entre o Protheus e o 
TOTVS Saúde Portal AutorizadorPLSYNCAUTH()Responsável por realizar a integração das guias de autorizações  realizadas no 
TOTVS Saúde Portal Autorizador
 e importar para o Protheus
PLJBATUTISS()Responsável por realizar a atualização dos status dos lotes de faturamento no TOTVS Saúde Portal Autorizador após a validações das regras no Protheus.


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

Para realizar a integração, basta fazer a chamada das rotinas conforme exemplo acima:

FunçãoDescrição
PLSYNCAUTHResponsável por realizar a integração das Autorizações.
PLSYNCLIATResponsável por realizar a integração dos Anexo Clinico.
PLSYNCTREXResponsável por realizar a integração das prorrogações.

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. 

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


Para consultar os dados sincronizados via schedule consulte a documentação disponível em Lista de dados sincronizados através do schedule

Para mais informações sobre como utilizar o schedule do Protheus acesse o endereço: Schedule - Como agendar a execução de rotinas


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 que deseja executar.

A opção Recorrencia ( [Home Soluções Saúde > INTEGRAÇÃO TOTVS Saúde Portal Autorizador x PLS (PROTHEUS) > recorrencia.PNG] ) permite que você configure a frequência da troca de informações entre o TOTVS Saúde Portal Autorizador 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 TOTVS Saúde Portal Autorizador estará ativa e funcional.


7 - Configurar integração para auditoria médica

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

8 - Configuração do robô para envio de faturamento

Para a integração de envio de lotes de faturamento e XML é necessário que sejam feitas as configurações descritas no documento abaixo:

https://tdn.totvs.com.br/pages/releaseview.action?pageId=525032764

Detalhamento das views utilizadas na extração de dados do Protheus - PLS

Views para ETL no TOTVS Saúde Portal Autorizador

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