...
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
...
Tipo
...
Parâmetro | loginPLS |
Descrição | Login de acesso a API do Protheus PLS |
Tipo | Caractere |
Conteúdo | Preencher com o usuário Protheus que será utilizado para autenticar as transações REST |
Parâmetro | senhaPLS |
Descrição | Senha de acesso a API do Protheus PLS |
Tipo | Caractere |
Conteúdo | Preencher com a senha do usuário Protheus que será utilizado para autenticar as transações REST |
Parâmetro | loginWS |
Descrição | Login do webservice do Protheus PLS |
Tipo | Caractere |
Conteúdo | Preencher com o usuário Protheus que será utilizado para autenticar as transações SOAP |
Parâmetro | senhaWS |
Descrição | Senha do webservice do Protheus PLS |
Tipo | Caractere |
Conteúdo | Preencher com a senha do usuário Protheus que será utilizado para autenticar as transações SOAP |
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 | Gestao Lotes HATGeren. Ped. Integra |
Programa | PLSA417PLSA274 |
Status | Habilitado |
Módulo | Plano de Saúde |
Tipo | Função Protheus |
...
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.
É necessário criar um ambiente cada empresa e nesse ambiente ser informadas as chaves JEMP, JFIL, EMPROBOXML e FILROBOXML, configurar uma porta REST, uma porta WS e os Jobs de processamento.
Abaixo há um exemplo de configuração do appserver.ini para o ambiente de uma empresa:
...
theme | Midnight |
---|---|
title | appserver.ini |
...
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 |
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.
É 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 | |||||
---|---|---|---|---|---|
| |||||
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..
|
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 | ||||
---|---|---|---|---|
| ||||
;------------------------------------------------------------------------------
;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 | ||||
---|---|---|---|---|
| ||||
;------------------------------------------------------------------------------
;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 | ||||
---|---|---|---|---|
| ||||
;------------------------------------------------------------------------------
;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=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.
...
Função | Chaves | Logs |
---|---|---|
PLSYNCAUTH | JEMP e JFIL | authorizations authorizations - cancelamento |
PLSYNCLIAT | JEMP e JFIL | clinicalattachments clinicalattachments - cancelamento |
PLSYNCTREX | JEMP e JFIL | treatmentextensions treatmentextensions - cancelamento |
PJOBHATXML | EMPROBOXML e FILROBOXML | plsxmldownload.log |
XMLIMPORT | EMPROBOXML e FILROBOXML | logs no console do appserver |
XMLROUTE | EMPROBOXML e FILROBOXML | logs no console do appserver |
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
...
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
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.
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)
...