Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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údoPreencher com: https://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_PSVCLOG
DescriçãoHabilita log para serviços do PLS (0=Desativado / 1=Ativado)
TipoCaractere
Conteúdo1
ParâmetroMV_PHATTOK
DescriçãoToken de autorização do TOTVS Saúde Portal Autorizador.
TipoCaractere
ConteúdoPreencher 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âmetroMV_PHATIDT
DescriçãoID do tenant da operadora no TOTVS Saúde Portal Autorizador. 
TipoCaractere
ConteúdoPreencher 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âmetroMV_PHATNMT
DescriçãoNome do tenant da operadora no TOTVS Saúde Portal Autorizador.
TipoCaractere
ConteúdoPreencher 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

Configuração de Parâmetros Totvs Saúde Portal Autorizador - Administração

ParâmetrologinPLS
DescriçãoLogin de acesso a API do Protheus PLS
TipoCaractere
ConteúdoPreencher com o usuário Protheus que será utilizado para autenticar as transações REST
ParâmetrosenhaPLS
DescriçãoSenha de acesso a API do Protheus PLS
TipoCaractere
ConteúdoPreencher com a senha do usuário Protheus que será utilizado para autenticar as transações REST
ParâmetrologinWS
DescriçãoLogin do webservice do Protheus PLS
TipoCaractere
ConteúdoPreencher com o usuário Protheus que será utilizado para autenticar as transações SOAP
ParâmetrosenhaWS
DescriçãoSenha do webservice do Protheus PLS
TipoCaractere
ConteúdoPreencher com a senha do usuário Protheus que será utilizado para autenticar as transações SOAP

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

...

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

PLHATWZD - Wizard de configuração de tabelas 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.

Image Added

Configuração no APPSERVER.INI

É necessário criar um ambiente para cada empresa e nesse ambiente serem informadas as chaves JEMP, JFIL, EMPROBOXML e FILROBOXML, configurar uma porta REST, uma porta WS e os Jobs de processamento.

Aviso
titleImportante

Caso o ambiente possua um Broker, para correto funcionamento, os appservers deverão estar abaixo de um BROKER WS.

Atenção: Não recomendamos a utilização de um broker HTTP, pois esse retorna uma resposta de redirecionamento (302) e caso se adicione a tag USING_COOKIES=0 o broker irá direcionar o tráfego apenas para um appserver sem realizar o balanceamento da carga..

Bloco de código
titleExemplo .ini Broker Web Service
[GENERAL]
; configuracao recomendada para gravacao de log
ConsoleLog=1
ConsoleLogDate = 0 

[BALANCE_WEB_SERVICES]
LOCAL_SERVER_PORT=4000            ; porta de entrada do Broker HTTP
REMOTE_SERVER_01=127.0.0.1 5000   ; ip e porta do Broker WebServices encadeado

; etc
; a chave REMOTE_SERVER_xx aceita letras e números para identificar servidores,
; por exemplo REMOTE_SERVER_0A, REMOTE_SERVER_XY, etc, e as chaves
; podem estar em qualquer ordem
 
; nome do serviço Windows, caso seja utilizado
; (não pode conter espaços)
SERVICE_NAME=XXX_TOTVS_BALANCE_WS_001
 
; (opcional, disponível a partir de 01/dez/2017)
; "display name" do serviço Windows
SERVICE_DISPLAY_NAME = "BROKER SERVICE"


Recomendamos que haja um appserver para cada funcionalidade. Sendo assim necessários 3 appservers: 1 Rest, 1 Portal e 1 JOB/Schedule
Abaixo exemplos de configuração do appserver.ini para o ambiente de uma empresa de cada serviço:

Appserver REST

Configuração no APPSERVER.INI

No appserver.ini do ambiente crie as chaves abaixo:

Bloco de código
themeMidnight
titleappserver.ini
;------------------------------------------------------------------------------
;Para cada empresa é necessário haver uma configuração específica de ambiente 
;------------------------------------------------------------------------------
[PROCUCAO_EMP01] 
SourcePath=C:\Protheus\PROCUCAO_EMP01\apo
RootPath=C:\Protheus\PROCUCAO_EMP01\protheus_data
StartPath=\system\
#Informações utilizadas para identificar a CodigoEmpresa e filial pelos jobs
EMPROBOXML=CodigoEmpresa
FILROBOXML=CodigoFilial
JEMP=CodigoEmpresa
JFIL=CodigoFilial 
...

[ONSTART]
JOBS=HTTPJOB,HTTPREST
Refreshrate=120

;--------------------------------
;------------- REST -------------
;--------------------------------
[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=PROCUCAO_EMP01

[HTTPV11]
Enable=1
Sockets=HTTPREST

[HTTPREST] 
Port=Porta
IPsBind=Endereco
URIs=URIHTML
SECURITY=1
MaxQueue=10
SSL2=0
SSL3=0
TLS1=0
BUGS=0
State=0
Verbose=0
HSM=0
Module=
Certificate=
Certificate2=
Key=
Key2=
PassPhrase=  

[URIHTML]
URL=/rest
PrepareIn=CodigoEmpresa,CodigoFilial
Instances=1,5
AllowOrigin=*
CORSEnable=1

Appserver Portal:

Bloco de código
themeMidnight
titleappserver.ini
;------------------------------------------------------------------------------
;Para cada empresa é necessário haver uma configuração específica de ambiente 
;------------------------------------------------------------------------------
[PROCUCAO_EMP01] 
SourcePath=C:\Protheus\PROCUCAO_EMP01\apo
RootPath=C:\Protheus\PROCUCAO_EMP01\protheus_data
StartPath=\system\
#Informações utilizadas para identificar a CodigoEmpresa e filial pelos jobs[AMBIENTE/ENVIROMENT]
...
JEMP=CodigoEmpresa
JFIL=CodigoFilial
EMPROBOXML=CodigoEmpresa
FILROBOXML=CodigoFilial
JEMP=CodigoEmpresa
JFIL=CodigoFilial 
...

[ONSTART]
JOBS=JOB_PP
Refreshrate=120
;--------------------------------
;--------- Web Service ----------
;--------------------------------

[http]
enable=1
path=E:\protheus\PROCUCAO_EMP01\Protheus_data
port=Porta
INSTANCES=1,10
ENVIRONMENT=PROCUCAO_EMP01
SESSIONTIMEOUT=TempoDeTimeout
SECURITY=1

[Endereco:Porta]
ENABLE=1
PATH=E:\protheus\PROCUCAO_EMP01\Protheus_data\Web\PP
ENVIRONMENT=PROCUCAO_EMP01
INSTANCENAME=pp 
RESPONSEJOB=JOB_PP
JEMP=CodigoEmpresa 
JFIL=CodigoFilial
UPLOADPATH=E:\protheus\PROCUCAO_EMP01\Protheus_data\TISS\upload
TPACESSO=1
INSTANCES=5,10,3,3

[JOB_PP]
TYPE=WEBEX
ENVIRONMENT=PROCUCAO_EMP01
INSTANCES=5,10,3,3
PREPAREIN=CodigoEmpresa,CodigoFilial
SIGAWEB=PP
INSTANCENAME=PP
ONSTART=STARTWEBEX
ONCONNECT=CONNECTWEBEX
ONEXIT=FINISHWEBEX
WEBSERVICELOCATION=http://Endereco:Porta/ws

[Endereco:Porta/ws]
ENABLE=1
PATH=E:\protheus\PROCUCAO_EMP01\Protheus_data\Web\Ws
ENVIRONMENT=PROCUCAO_EMP01
INSTANCENAME=ws
RESPONSEJOB=JOB_WS
DEFAULTPAGE=wsindex.apw
;;SESSIONTIMEOUT=30

[JOB_WS]
TYPE=WEBEX
ENVIRONMENT=PROCUCAO_EMP01
INSTANCES=1,10,3,3
SIGAWEB=WS
INSTANCENAME=ws
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=CodigoEmpresa,CodigoFilial

Appserver JOB:

Bloco de código
themeMidnight
titleappserver.ini
;------------------------------------------------------------------------------
;Para cada empresa é necessário haver uma configuração específica de ambiente 
;------------------------------------------------------------------------------
[PROCUCAO_EMP01] 
SourcePath=C:\Protheus\PROCUCAO_EMP01\apo
RootPath=C:\Protheus\PROCUCAO_EMP01\protheus_data
StartPath=\system\
#Informações utilizadas para identificar a CodigoEmpresa e filial pelos jobs
EMPROBOXML=CodigoEmpresa
FILROBOXML=CodigoFilial
JEMP=CodigoEmpresa
JFIL=CodigoFilial 
...
  

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

;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$   JOBS INTEGRACAO HAT $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$

#Job responsavel por realizar a importação dos XML's para o Protheus
[IMPXML]
Enviroment=SEUPROCUCAO_AMBIENTEEMP01
Main=XmlImport
 
#Job;Job responsavel por processar os XML's baixados
[XML_ROBOT]
ENVIRONMENT=SEUPROCUCAO_AMBIENTEEMP01
main=xmlroute
 
#Job responsavel por verificar se existem arquivos XML para baixar e realizar o download
[PJobHatXML]
ENVIRONMENT=SEUPROCUCAO_AMBIENTEEMP01
INSTANCES=1,1
main=PJobHatXML
 
#Job responsavel por integrar as guias de autorização e as guias canceladas
[PLSYNCAUTH]
ENVIRONMENT=SEUPROCUCAO_AMBIENTEEMP01
MAIN=PLSYNCAUTH
INSTANCES=1,1
 
#Job responsavel por integrar as guias de anexos clinicos e as guias de anexos canceladas
[PLSYNCLIAT]
ENVIRONMENT=SEUPROCUCAO_AMBIENTEEMP01
MAIN=PLSYNCLIAT
INSTANCES=1,1
 
#Job responsavel por integrar as guias de prorrogação de internação e as prorrogações canceladas
[PLSYNCTREX]
ENVIRONMENT=SEUPROCUCAO_AMBIENTEEMP01
MAIN=PLSYNCTREX
INSTANCES=1,1
  
#Job responsavelresposavel por realizar gerenciara integração osde schedulesdados
[FWSCHDMANAGPJobPlsHat]
Mainmain=FWSCHDMANAGPJobPlsHat
EnvironmentENVIRONMENT=SEUPROCUCAO_AMBIENTEEMP01

#Job responsavel por gerenciar as filas dos schedules
[FWSCHDQUEUEINSTANCES=1,1

[FWSCHDMANAG]
Main=FWSCHDQUEUEFWSCHDMANAG
Environment=SEUPROCUCAO_AMBIENTEEMP01

#Job resposavel por realizar a integração de dados
[PLSHAT]
main=PJobPlsHat 
ENVIRONMENT=SEU_AMBIENTE
INSTANCES=1,1
[FWSCHDQUEUE]
Main=FWSCHDQUEUE
Environment=PROCUCAO_EMP01
 
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$  FIM DA CONFIGURACAO DAS JOBS DE INTEGRACAO HAT $$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$


Alerta de risco: fique atento ao utilizar o parâmetro de configuração com a chave Security=0, pois isso fará com que as integrações (APIs) não exijam autenticação, consequentemente dados do seu ambiente poderão ser consultados sem qualquer controle de autorização.

Obs.: também deve ser adicionada a chave PREPAREIN=<CodigoGrupoEmpresa>,<CodigoEmpresa><CodigoFilial> na sessão que é chamada na chave URIs do [HTTPURI], no APPSERVER.ini. Para mais informações: Configuração do REST Protheus para uso com os aplicativos Mobile.

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

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

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.


Função

Chaves

Logs
PLSYNCAUTHJEMP e JFIL

authorizations

authorizations - cancelamento

PLSYNCLIAT JEMP e JFIL

clinicalattachments

clinicalattachments - cancelamento

PLSYNCTREXJEMP e JFILtreatmentextensions treatmentextensions - cancelamento
PJOBHATXMLEMPROBOXML e FILROBOXMLplsxmldownload.log
XMLIMPORTEMPROBOXML e FILROBOXMLlogs no console do appserver
XMLROUTEEMPROBOXML e FILROBOXMLlogs no console do appserver


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

Função

Descriçã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. 

IMPORTANTE

Recomentados que seja feita a exclusão periódica do arquivo protheus_data/tiss/online/log/onlinelog.txt, pois este pode ficar grande e impactar na performance das rotinas de gravação de guias. Também recomendamos a desativação dos parâmetros MV_LOGSCHE e MV_PTLOGTO, pois podem onerar a performance ao realizar uma grande quantidade de gravações em arquivo de log. Os parâmetros podem ser ativados para análise de processamento e posteriormente desativados.


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 


Siga para o passo Passo 5 - Envio de Acesso aos Prestadores para continuar a implantação;Para dar continuidade as configurações de Integração no PLS, acesse o item 4.2 - Configurar Agendamento de Integração (Schedule)