Á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

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

...

Configuração no APPSERVER.INI

No appserver.ini do ambiente crie as chaves abaixo:

É 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
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$   SESSÃO DE AMBIENTE (ACRESCENTAR AS CHAVES ABAIXO) $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
;$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$

[AMBIENTE/ENVIROMENT]
...
JEMP=CodigoEmpresa
JFIL=CodigoFilial------------------------------------------------------------------------------
;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 
;------------------------------------------------------------------------------
[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,PLSYNCAUTH,PLSYNCLIAT,PLSYNCTREX,PLSHATPJobPlsHat
Refreshrate=120

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

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

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

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

#Job responsavel por integrar as guias de autorização e as guias canceladas
[PLSYNCAUTH]
ENVIRONMENT=SEUPROCUCAO_AMBIENTEEMP01
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=SEUPROCUCAO_AMBIENTEEMP01
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=SEUPROCUCAO_AMBIENTEEMP01
MAIN=PLSYNCTREX
INSTANCES=1,1
PREPAREIN=CodigoEmpresa,CodigoFilial   

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

[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=<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

...

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 


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)Siga para o passo Passo 5 - Envio de Acesso aos Prestadores para continuar a implantação;