Web

Services GPU - RN 395 -

Versão 1_1_0

Características do Requisito

Descrição

No Foundation Saúde foram implementadas alterações referentes à versão 1_1_0 dos webservices da Gestão de Protocolos Unimed (GPU).

Procedimento para Implantação

A implementação descrita no documento estará disponível a partir da atualização do pacote no cliente.

O pacote está disponível no portal (https://suporte.totvs.com/download).

Procedimento para Configuração

CONFIGURAÇÃO DE PARÂMETROS NO FOUNDATION SAÚDE

No arquivo "<JBoss>/server/<instancia>/conf/foundation-exchange.properties", foram criadas desenvolvidas novas propriedades que devem ser configuradas para o funcionamento dos web services no "Foundation Saúde".

Endpoints

Propriedades referentes aos "Endpoints", dos serviços da Unimed do Brasil. Existe uma propriedade para cada web service, e no exemplo abaixo está configurado para o ambiente de homologação.

com.totvs.foundation.protocolmanager.message.v1_1_0.RequestProtocol.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/V1_1_0/SolicitarProtocolo
com.totvs.foundation.protocolmanager.message.v1_1_0.AnswerProtocol.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/V1_1_0/RespostaAtendimento
com.totvs.foundation.protocolmanager.message.v1_1_0.CancelRequest.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/V1_1_0/Cancelamento
com.totvs.foundation.protocolmanager.message.v1_1_0.CompleteProtocol.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/V1_1_0/ComplementoProtocolo
com.totvs.foundation.protocolmanager.message.v1_1_0.SearchBeneficiaryProtocolHistory.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/V1_1_0/ConsultaHistorico
com.totvs.foundation.protocolmanager.message.v1_1_0.SearchProtocolStatus.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/V1_1_0/ConsultaStatusProtocolo
com.totvs.foundation.protocolmanager.message.v1_1_0.ForwardPerformedSolicitation.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/V1_1_0/EncaminharExecucao

URI

Propriedades que definem os "namespaces", dos web services definidos pelo "Schema". Existe uma propriedade para cada web service e não é necessário alterar a definição, basta copiar para o arquivo.

com.totvs.foundation.protocolmanager.message.v1_1_0.RequestProtocol.URI = http://gp.unimed.coop.br/solicitarProtocolo/webservices/V1_1_0
com.totvs.foundation.protocolmanager.message.v1_1_0.AnswerProtocol.URI = http://gp.unimed.coop.br/respostaAtendimento/webservices/V1_1_0
com.totvs.foundation.protocolmanager.message.v1_1_0.CancelRequest.URI = http://gp.unimed.coop.br/cancelamento/webservices/V1_1_0
com.totvs.foundation.protocolmanager.message.v1_1_0.CompleteProtocol.URI = http://gp.unimed.coop.br/complementoProtocolo/webservices/V1_1_0
com.totvs.foundation.protocolmanager.message.v1_1_0.SearchBeneficiaryProtocolHistory.URI = http://gp.unimed.coop.br/consultaHistorico/webservices/V1_1_0
com.totvs.foundation.protocolmanager.message.v1_1_0.SearchProtocolStatus.URI = http://gp.unimed.coop.br/consultaStatusProtocolo/webservices/V1_1_0
com.totvs.foundation.protocolmanager.message.v1_1_0.ForwardPerformedSolicitation.URI = http://gp.unimed.coop.br/encaminharExecucao/webservices/V1_1_0

WSDL

Propriedades que definem os endereços dos arquivos "WSDL", no servidor local da operadora. Existe uma propriedade para cada serviço, que devem ser alteradas para corresponder ao endereço da aplicação "Foundation Saúde", e porta em que o "JBoss" foi carregado.

"http://<endereço>:<porta>/wsdl/v1_1_0/solicitarProtocolo_V1_1_0.wsdl"

com.totvs.foundation.protocolmanager.message.v1_1_0.RequestProtocol.WSDL = http://localhost/wsdl/gp/v1_1_0/solicitarProtocolo_V1_1_0.wsdl
com.totvs.foundation.protocolmanager.message.v1_1_0.CancelRequest.WSDL = http://localhost/wsdl/gp/v1_1_0/cancelamento_V1_1_0.wsdl
com.totvs.foundation.protocolmanager.message.v1_1_0.AnswerProtocol.WSDL = http://localhost/wsdl/gp/v1_1_0/respostaAtendimento_V1_1_0.wsdl
com.totvs.foundation.protocolmanager.message.v1_1_0.CompleteProtocol.WSDL = http://localhost/wsdl/gp/v1_1_0/complementarProtocolo_V1_1_0.wsdl
com.totvs.foundation.protocolmanager.message.v1_1_0.SearchBeneficiaryProtocolHistory.WSDL = http://localhost/wsdl/gp/v1_1_0/consultaHistorico_V1_1_0.wsdl
com.totvs.foundation.protocolmanager.message.v1_1_0.SearchProtocolStatus.WSDL = http://localhost/wsdl/gp/v1_1_0/consultaStatusProtocolo_V1_1_0.wsdl
com.totvs.foundation.protocolmanager.message.v1_1_0.ForwardPerformedSolicitation.WSDL = http://localhost/wsdl/gp/v1_1_0/encaminharExecucao_V1_1_0.wsdl

Timeout

Configurar a propriedade de "protocolmanager.webservices.timeout" para definir o tempo máximo, em milissegundos, que o "Foundation Saúde" irá esperar por uma resposta da Unimed do Brasil, até que encerre a comunicação e devolva uma inconsistência. Os valores possíveis variam de -1 ao infinito. Abaixo segue alguns exemplos de utilização.

• "protocolmanager.webservices.timeout = -1":
  • O valor -1 indica tempo infinito de espera, isto é, o Foundation Saúde irá aguardar por uma resposta da Unimed do Brasil indefinidamente;
• "protocolmanager.webservices.timeout = 9000":
  • Nesse caso o Foundation Saúde irá aguardar 9 segundos por uma resposta da Unimed do Brasil, após esse tempo irá encerrar a comunicação e devolver um erro inconsistência de Time Out.

Endpoints para receber mensagens

A seguir a lista com os nomes dos endpoints disponibilizados pelo Foundation Saúde para receber as mensagens do GPU. Para consultar o endereço real, acesse a página /jbossws/services do Foundation Saúde. Esses endereços devem ser informados à Unimed do Brasil para realizar o registro e geração do certificado.

• Solicitar Protocolo: RequestProtocol_v1_1_0WS
  • Exemplo: https://fndsauhml.totvs.com.br:443/htz-foundation/RequestProtocol_v1_1_0WS?wsdl
• Responder Protocolo: AnswerProtocolRequest_v1_1_0WS
  • Exemplo: https://fndsauhml.totvs.com.br:443/htz-foundation/AnswerProtocolRequest_v1_1_0WS?wsdl
• Consultar Protocolo: SearchProtocolStatus_v1_1_0WS
  • Exemplo: https://fndsauhml.totvs.com.br:443/htz-foundation/SearchProtocolStatus_v1_1_0WS?wsdl
• Consultar histórico do Beneficiário: SearchBeneficiaryProtocolHistory_v1_1_0WS
  • Exemplo: https://fndsauhml.totvs.com.br:443/htz-foundation/SearchBeneficiaryProtocolHistory_v1_1_0WS?wsdl
• Cancelar Protocolo: CancelRequestedProtocol_v1_1_0WS
  • Exemplo: https://fndsauhml.totvs.com.br:443/htz-foundation/CancelRequestedProtocol_v1_1_0WS?wsdl
• Encaminhar Execução: ForwardPerformedSolicitation_v1_1_0WS
  • Exemplo: https://fndsauhml.totvs.com.br:443/htz-foundation/ForwardPerformedSolicitation_v1_1_0WS?wsdl
• Complementar Protocolo: CompleteProtocolInfo_v1_1_0WS
  • Exemplo: https://fndsauhml.totvs.com.br:443/htz-foundation/CompleteProtocolInfo_v1_1_0WS?wsdl

CONFIGURAÇÃO DE PARÂMETROS NO GESTÃO DE PLANOS DE SAÚDE

Foi criado desenvolvido um novo serviço, que integra o GPS ao Foundation Saúde, para comunicar com a Unimed do Brasil na versão 1_1_0. Para utilizar esse serviço, deve ser efetuada a configuração a seguir.

Parâmetros Globais Sistema (PR1410P)

1. Altere o parâmetro "Integração RN395/Intercambio", para: "2 - Online";
2. Informe a URL de comunicação com o "Foundation Saúde", que é o endereço para o serviço "WsdProtocolManagerWS_v1_1_0":
   
   1. Exemplo: "http://fndsauhml.totvs.com.br:28080/htz-foundation/WsdProtocolManagerWS_v1_1_0?wsdl".
3. Informe o "Namespace", de comunicação com o "Foundation Saúde":
   1. Valor fixo igual a ""http://v1_1_0.ws.protocolmanager.foundation.totvs.com/".

Importante:
O Foundation Saúde possui as versões 1_00_00 e 1_1_0 funcionando paralelamente, para receber e enviar mensagens, no entanto é essa configuração que define qual versão será utilizada para enviar mensagens para a Unimed do Brasil. Desse modo, deve ser observada a data de ativação da nova versão divulgada pela Unimed do Brasil para a configuração do serviço.

Procedimento para Utilização

Os procedimentos para utilização dos novos web services não foram afetados e funcionam conforme descrito no documento disponível em TUROPV_DT_Web_Services_RN_395.