Protocolo de Transações Unimed - PTU
O sistema Foundation Saúde, esta em conformidade com o Protocolo de Transações Unimed on-line (PTU) versão 6.0 e oferece suporte a comunicação por meio de WebServices com segurança (certificado digital), exigidos pela Unimed do Brasil.
Configurações
A Unimed Brasil somente realiza comunicação com os WebServices publicados na porta 80 e 443 utilizando o certificado digital fornecido por eles. Após ter recebido o certificado e a senha, os mesmos devem ser configurados conforme detalhado nas configurações de certificados digitais.
O arquivo foundation-exchange.properties é onde são configuradas as propriedades de funcionamento do PTU. Ali se define os serviços disponibilizados pela Unimed do Brasil, integrações do PTU com ERP entre outras configurações. Este arquivo deve ser gravado obrigatoriamente no diretório jboss-4.2.3.GA/server/default/conf.
Independente da versão do PTU e do ERP, configure nesse arquivo a seguinte propriedade:
- Propriedade: providerCode
- Descrição: Código da Unimed onde o Foundation se encontra instalado. Ex: 0032
PTU Online versão 6.0
A seguir são apresentadas as configurações e implementações referentes ao PTU Online versão 6.0.
Mensagens Contempladas
Serviços suportados pelo Foundation Saúde para receber requisições.
Transação - PTU 6.0 | WebService |
---|---|
Autorização de Ordem de Serviço | PtuServiceOrderAuthorizationWSv6000 |
Consulta de Dados do Beneficiário | PtuInsuranceUserQueryWSv6000 |
Cancelamento | PtuCancellationWSv6000 |
Resposta de Auditoria | PtuAuditoryWSv6000 |
Status da Transação | PtuTransactionStatusWSv6000 |
Pedido de Complemento de Autorização | PtuAuthorizationComplementWSv6000 |
Consulta transações Respondidas pelo WSD | PtuConsultA1100WSv6000 |
Pedido de Insistência | PtuInsistenceWSv6000 |
Pedido de Autorização | PtuAuthorizationWSv6000 |
Consulta de Prestadores | PtuProviderQueryWSv6000 |
Requisição de Contagem de Beneficiários | PtuActiveInsuranceUsersQueryWSv6000 |
Comunicação de Decurso de Prazo | PtuCommunicationProcessTermWSv6000 |
Ordem de Serviço | PtuServiceOrderWSv6000 |
Configuração dos WebServices
No arquivo JBOSS_HOME/server/default/conf/foundation-exchange.properties devem ser configuradas as propriedades referentes ao PTU Online v6.0.
Adicionar a propriedade do conector externo com o valor fixo:
- connector.External.Foundation.6000 = com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector
- connector.External.Foundation.6000 = com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector
Adicionar as propriedades das URI's, namespaces do schema PTU, com os valores fixos:
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.RespostaAuditoria.namespace.URI = http://ptu.unimed.coop.br/respostaauditoria/webservices/V60_00
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.PedidoAutorizacao.namespace.URI = http://ptu.unimed.coop.br/pedidoautorizacao/webservices/V60_00
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.PedidoComplementoAutorizacao.namespace.URI = http://ptu.unimed.coop.br/pedidocomplementoautorizacao/webservices/V60_00
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.OrdemServico.namespace.URI = http://ptu.unimed.coop.br/ordemservico/webservices/V60_00
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.ConsultaDadosPrestador.namespace.URI = http://ptu.unimed.coop.br/consultadadosprestador/webservices/V60_00
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.Cancelamento.namespace.URI = http://ptu.unimed.coop.br/cancelamento/webservices/V60_00
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.PedidoInsistencia.namespace.URI = http://ptu.unimed.coop.br/pedidoinsistencia/webservices/V60_00
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.ConsultaDadosBeneficiario.namespace.URI = http://ptu.unimed.coop.br/consultadadosbeneficiario/webservices/V60_00
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.RequisicaoContagemBeneficiarios.namespace.URI = http://ptu.unimed.coop.br/requisicaocontagembeneficiarios/webservices/V60_00
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.StatusTransacao.namespace.URI = http://ptu.unimed.coop.br/statustransacao/webservices/V60_00
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.comunicacaoDecursoPrazo.namespace.URI = http://ptu.unimed.coop.br/comunicacaoDecursoPrazo/webservices/V60_00
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.autorizacaoOrdemServico.namespace.URI = http://ptu.unimed.coop.br/autorizacaoordemservico/webservices/V60_00
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.ConsultaA1100.namespace.URI = http://ptu.unimed.coop.br/ConsultaA1100/webservices/V60_00
Adicionar as propriedades referentes aos WSDL's (pode ocorrer variação da porta http). Os últimos WSDLs disponíveis podem ser obtidos no arquivo "wsdl.war" existente dentro do "htzfoundation.ear", ou então diretamente com a Unimed do Brasil.
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.RespostaAuditoria.WSDL = http://localhost/wsdl/ptu/v6000/respostaAuditoria_V60_00.wsdl
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.PedidoAutorizacao.WSDL = http://localhost/wsdl/ptu/v6000/pedidoAutorizacao_V60_00.wsdl
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.PedidoComplementoAutorizacao.WSDL = http://localhost/wsdl/ptu/v6000/pedidoComplementoAutorizacao_V60_00.wsdl
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.OrdemServico.WSDL = http://localhost/wsdl/ptu/v6000/ordemServico_V60_00.wsdl
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.ConsultaDadosPrestador.WSDL = http://localhost/wsdl/ptu/v6000/consultaDadosPrestador_V60_00.wsdl
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.Cancelamento.WSDL = http://localhost/wsdl/ptu/v6000/cancelamento_V60_00.wsdl
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.PedidoInsistencia.WSDL = http://localhost/wsdl/ptu/v6000/pedidoInsistencia_V60_00.wsdl
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.ConsultaDadosBeneficiario.WSDL = http://localhost/wsdl/ptu/v6000/consultaDadosBeneficiario_V60_00.wsdl
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.RequisicaoContagemBeneficiarios.WSDL = http://localhost/wsdl/ptu/v6000/requisicaoContagemBeneficiarios_V60_00.wsdl
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.StatusTransacao.WSDL = http://localhost/wsdl/ptu/v6000/statusTransacao_V60_00.wsdl
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.comunicacaoDecursoPrazo.WSDL = http://localhost/wsdl/ptu/v6000/comunicacaoDecursoPrazo_V60_00.wsdl
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.autorizacaoOrdemServico.WSDL = http://localhost/wsdl/ptu/v6000/autorizacaoOrdemServico_V60_00.wsdl
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.ConsultaA1100.WSDL = http://localhost/wsdl/ptu/v6000/consultaA1100_V60_00.wsdl
Adicionar as propreidades referetnes aos novos endpoints para comunicação com o WSD da Unimed do Brasil.
Importante: Os endereços abaixo são os endpoints do WSD de Homologação e servem apenas como exemplo. Os Endpoints oficiais, de Produção e Protótipo, devem ser solicitados junto à Unimed do Brasil.
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.RespostaAuditoria.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/RespostaAuditoria
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.PedidoAutorizacao.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/PedidoAutorizacao
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.PedidoComplementoAutorizacao.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/PedidoComplementoAutorizacao
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.OrdemServico.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/OrdemServico
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.ConsultaDadosPrestador.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/ConsultaDadosPrestador
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.Cancelamento.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/Cancelamento
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.PedidoInsistencia.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/PedidoInsistencia
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.ConsultaDadosBeneficiario.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/ConsultaDadosBeneficiario
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.RequisicaoContagemBeneficiarios.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/RequisicaoContagemBeneficiarios
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.StatusTransacao.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/StatusTransacao
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.comunicacaoDecursoPrazo.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/ComunicacaoDecursoPrazo
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.autorizacaoOrdemServico.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/autorizacaoOrdemServico
- com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.ConsultaA1100.ENDPOINT = https://wsd.homologacao.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/ConsultaA1100
Configurações para integração com o Gestão de Planos
Essas configurações são válidas apenas para instalações do Foundation Saúde que sejam integradas com o ERP Gestão de Planos.
Deve-se adicionar os novos conectores internos para o Progress com os valores fixos conforme abaixo:
- connector.Internal.PtuXml.6000.AuditoryResponse = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.AuditoryInternalConnector
- connector.Internal.PtuXml.6000.AuthorizationComplementRequest = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.AuthorizationComplementInternalConnector
- connector.Internal.PtuXml.6000.AuthorizationRequest = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.AuthorizationInternalConnector
- connector.Internal.PtuXml.6000.CancellationRequest = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.CancellationInternalConnector
- connector.Internal.PtuXml.6000.InsistenceRequest = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.InsistenceInternalConnector
- connector.Internal.PtuXml.6000.InsuranceUserQueryRequest = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.InsuranceUserInternalConnector
- connector.Internal.PtuXml.6000.ProviderQueryRequest = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.ProviderQueryInternalConnector
- connector.Internal.PtuXml.6000.ServiceOrderRequest = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.ServiceOrderInternalConnector
- connector.Internal.PtuXml.6000.ActiveInsuranceUsersQueryRequest = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.ActiviyInsuranceUserQueryInternalConnector
- connector.Internal.PtuXml.6000.TransactionStatusRequest = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.TransactionStatusInternalConnector
- connector.Internal.PtuXml.6000.CommunicationProcessTerm = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.CommunicationProcessTermInternalConnector
- connector.Internal.PtuXml.6000.AuthorizationServiceOrder = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.ServiceOrderAuthorizationInternalConnector
- connector.Internal.PtuXml.6000.ConsultA1100InternalConnector = com.totvs.foundation.exchange.connector.foundation.implementation.v6000.gp.ConsultA1100InternalConnector