Árvore de páginas

Versões comparadas

Chave

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

...

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

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

...

Tipo

...

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

PLSA274 - Gerenciamento dos pedidos de integração

PLSA275 - Endpoints de integração

...

PLSA277 - Erros Pedidos HAT

...

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

Tipo

Função Protheus

...

PLSA275 - Endpoints de integração

...

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

PLSA277 - Erros Pedidos HAT

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

PLSA417 - Gestão de lotes do HAT

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

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

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

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 Removed

Configuração no APPSERVER.INI

No appserver.ini do ambiente crie as chaves abaixo:

Bloco de código
themeMidnight
titleappserver.ini
[ENVIRONMENT] 
SourcePath=C:\Protheus\...\apo
RootPath=C:\Protheus\...\protheus_data
StartPath=\system\
#Informações utilizadas para identificar a CodigoEmpresa e filial pela job
EMPROBOXML=CodigoEmpresa
FILROBOXML=CodigoFilial
JEMP=CodigoEmpresa
JFIL=CodigoFilial 
...

[ONSTART]
JOBS=HTTPJOB,HTTPREST,JOB_PP,IMPXML,XML_ROBOT,PJobHatXML,PLSYNCAUTH,PLSYNCLIAT,PLSYNCTREX,PLSHAT,
Refreshrate=120

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

[HTTPV11]
Enable=1
Sockets=HTTPREST

[HTTPREST] 
Port=Porta
IPsBind=
URIs=URIHTML
SECURITY=0

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

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

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

[FWSCHDMANAG]
Main=FWSCHDMANAG
Environment=ENVIRONMENT

[FWSCHDQUEUE]
Main=FWSCHDQUEUE
Environment=ENVIRONMENT
 
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$  FIM DA CONFIGURACAO DAS JOBS DE INTEGRACAO HAT $$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$


;--------------------------------
;--------- Web Service ----------
;--------------------------------

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

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

[JOB_PP]
TYPE=WEBEX
ENVIRONMENT=ENVIRONMENT
INSTANCES=1,5,1,1
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\ENVIRONMENT\Protheus_data\Web\Ws
ENVIRONMENT=ENVIRONMENT
INSTANCENAME=ws
RESPONSEJOB=JOB_WS
DEFAULTPAGE=wsindex.apw
;;SESSIONTIMEOUT=30

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

[HTTPV11]
Enable=1
Sockets=HTTPREST
TimeOut=120

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

[HTTPURI]
URL=\rest
PrepareIn=
OnStart=
OnConnect=
OnExit=
Instances=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=IMPXML,XML_ROBOT,PJobHatXML,PLSYNCAUTH,PLSYNCLIAT,PLSYNCTREX,PJobPlsHat
Refreshrate=120

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

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

[FWSCHDMANAG]
Main=FWSCHDMANAG
Environment=PROCUCAO_EMP01

[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=CodigoEmpresa<CodigoGrupoEmpresa>,CodigoFilial <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 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.

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

...