Histórico da Página
PTU ONLINE 6.0
Características do Requisito
Linha de Produto: | Datasul | ||||||||||||||||||||||||||||||||||||||||
Segmento: | Saúde | ||||||||||||||||||||||||||||||||||||||||
Módulo: | Gestão de Planos de Saúde | ||||||||||||||||||||||||||||||||||||||||
Rotina: |
| ||||||||||||||||||||||||||||||||||||||||
Chamados Relacionados | TVUOI5 | ||||||||||||||||||||||||||||||||||||||||
País(es): | Brasil | ||||||||||||||||||||||||||||||||||||||||
Banco(s) de Dados: | Oracle® / Progress® / SQL Server® | Versão/Release: | 12.1.14 |
Descrição
As implementações descritas neste documento correspondem as adequações efetuadas no "Gestão de Planos" para atender ao PTU Online 6.0.
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
Gestão de Planos de Saúde
- No "TOTVS12", acesse o programa "Importação Menu ByYou" e efetue a importação do arquivo "univdata/men_hat.d" para efetuar a atualização do menu do módulo de "Atendimento ao Público - HAT".
- No "TOTVS12", acesse o programa "Manutenção Parâmetros Globais Sistema - PR1410P".
a. Altere a "Versao do PTU" para "6.0".
b. Altere a URL de Comunicação com o Foundation de modo a apontar para o novo endpoint do PTU Online 6.0. Na versão 5.0, o endpoint utilizado era o "WsdPtuSenderWSv10150?wsdl". Agora, para trafegar solicitações do PTU Online 6.0, o endpoint do Foundation a ser parametrizado é o "WsdPtuSenderWSv6000?wsdl" (ex.: http://enderecoDoFoundation:porta//htz-foundation/WsdPtuSenderWSv6000?wsdl).
c. Altere o Namespace para "http://implementation.v6000.ws.exchange.foundation.totvs.com/".
d. Uma vez efetuada a alteração desses parâmetros, a Unimed do Brasil deve ser comunicada para que a Versão PTU utilizada pela operadora seja alterada na Ferramenta WSD. Os clientes que utilizam programas CPC no processo do PTU Online deverão atentar-se para as orientações abaixo:
deverá
a. Caso seja utilizada a CPC-ATAPI023.P contendo a definição da include de linha "atp/atapi023-ptu50.i", a mesmadeve ser alterada para passar a utilizar a nova include "atp/atapi023-ptu60.i".
deverá
b. Caso seja utilizada a CPC-API-SOLICITAFOUNDATION.P contendo a definição da include de linha "api/api-solicita-ptu50.i", a mesmadeve ser alterada para passar a utilizar a nova include "api/api-solicita-ptu60.i".
. Caso seja utilizada a CPC-API-RECEBE-PTU
c.
P
d.Caso seja utilizada alguma das CPCs: CPC-ATAPI023.P, CPC-API-SOLICITAFOUNDATION.P, CPC-API-RECEBE-PTU.P, CPC-AT0115C.P, CPC-AT0115C-IE.P, ou outra CPC que tenha ação no processo de envio ou recebimento de transações PTU, as mesmas deverão ser recompiladas de modo a enxergar as includes disponibilizadas através no diretórios "FONTES".
Foundation- Atualização do diretório "deploy":
a. atualizar a aplicação htzfoundation.ear
b. atualizar o Módulo Web que contém os wsdl's locais: wsdl.war Atualização do arquivo "foundation-exchange.properties" do diretório "conf": Atualização do Certificado Digital: (apenas se necessário)
a. alterar o arquivo properties-service.xml (......\deploy\properties-service.xml)
javax.net.ssl.keyStore=C:\\TOTVS\foundation-saude\\jboss-4.2.3.GA\\server\\default\\conf\\unimed.javaks
javax.net.ssl.keyStorePassword=uni$ 000
javax.net.ssl.trustStore=C:\\TOTVS\foundation-saude\\jboss-4.2.3.GA\\server\\default\\conf\\unimed.javaks
javax.net.ssl.trustStorePassword=uni$000
javax.net.debug=true
b.alterar o arquivo server.xml (...\deploy\jboss-web.deployer\server.xml)
<Connector port="443" protocol="HTTP/1.1" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true"
keystoreFile="C:\\TOTVS\foundation-saude\\jboss-4.2.3.GA\\server\\default\\conf\\unimed.javaks " keystorePass="uni$000"
clientAuth="want" sslProtocol="TLS" truststoreFile="C:\\TOTVS\foundation-saude\\jboss-4.2.3.GA\\server\\default\\conf\\unimed.javaks"
truststorePass="uni$000"/>
c. alterar o arquivo ...\conf\jboss-services.xml (...\conf\jboss-services.xml)
<mbean code="org.jboss.security.plugins.JaasSecurityDomain" name="jboss.web:service=SecurityDomain">
<constructor>
<arg type="java.lang.String" value="JBossWS-SSL" />
</constructor>
<attribute name="KeyStoreURL">C:\\TOTVS\foundation-saude\\jboss-4.2.3.GA\\server\\default\\conf\\unimed.javaks</attribute>
<attribute name="KeyStorePass">uni$000</attribute>
<attribute name="TrustStoreURL">C:\\TOTVS\foundation-saude\\jboss-4.2.3.GA\\server\\default\\conf\\unimed.javaks</attribute>
<attribute name="TrustStorePass">uni$000</attribute>
<depends>jboss.security:service=JaasSecurityManager</depends>
</mbean>
Esse arquivo de propriedades deve ter acrescido os novos parâmetros para possibilitar a comunicação do PTU Online 6.0. Um modelo deste arquivo pode ser encontrado através do link foundation-exchange-exemplo.properties (neste modelo tem-se apenas os parâmetros da versão 6.0) . Ressaltamos que este é apenas um modelo, e que o cliente deverá ter atenção para não sobrepôr os parâmetros de configuração atual, e somente acrescentar os novos parâmetros conforme abaixo:
a. adicionar os novos conectores do Gestão de Planos (fixos)
#Connectors internos versao 6000 - PTU 6.0 para GPS Progress | |
|---|---|
| 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 |
b. adicionar o novo conector externo (fixo)
#Conector externo PTU 6.0 (fixo) | |
|---|---|
| connector.External.Foundation.6000 | com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector |
c. adicionar as novas URLs (fixas)
| #Versão 6000 - PTU 6.0 - URI | |
|---|---|
| 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 |
d. adicionar os novos WSDLs (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.
| #Versão 6000 - PTU 6.0 - WSDL | |
|---|---|
| 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 |
e. adicionar os novos Endpoints para comunicação com o WSD da Unimed do Brasil (os endereços abaixos são os Endpoints do WSD de Homologação e servem apenas de exemplo. Os Endpoints oficiais, de Produção e Protótipo, devem ser solicitados junto à Unimed do Brasil)
| #Versão 6000 - PTU 6.0 - ENDPOINT | |
|---|---|
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.RespostaAuditoria.ENDPOINT | https://wsdpre.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/RespostaAuditoria |
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.PedidoAutorizacao.ENDPOINT | https://wsdpre.unimed.coop.br/wsdintercambio/intercambioservices/ptu_v60_00/PedidoAutorizacao |
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.PedidoComplementoAutorizacao.ENDPOINT | https://wsdpre.unimed.coop.br/htz-foundation/PtuAuthorizationComplementWSv6000 |
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.OrdemServico.ENDPOINT | https://wsdpre.unimed.coop.br/htz-foundation/PtuServiceOrderWSv6000 |
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.ConsultaDadosPrestador.ENDPOINT | https://wsdpre.unimed.coop.br/htz-foundation/PtuProviderQueryWSv6000 |
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.Cancelamento.ENDPOINT | https://wsdpre.unimed.coop.br/htz-foundation/PtuCancellationWSv6000 |
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.PedidoInsistencia.ENDPOINT | https://wsdpre.unimed.coop.br/htz-foundation/PtuInsistenceWSv6000 |
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.ConsultaDadosBeneficiario.ENDPOINT | https://wsdpre.unimed.coop.br/htz-foundation/PtuInsuranceUserQueryWSv6000 |
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.RequisicaoContagemBeneficiarios.ENDPOINT | https://wsdpre.unimed.coop.br/htz-foundation/PtuActiveInsuranceUsersQueryWSv6000 |
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.StatusTransacao.ENDPOINT | https://wsdpre.unimed.coop.br/htz-foundation/PtuTransactionStatusWSv6000 |
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.comunicacaoDecursoPrazo.ENDPOINT | https://wsdpre.unimed.coop.br/htz-foundation/PtuCommunicationProcessTermWSv6000 |
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.autorizacaoOrdemServico.ENDPOINT | https://wsdpre.unimed.coop.br/htz-foundation/PtuServiceOrderAuthorizationWSv6000 |
| com.totvs.foundation.exchange.connector.ptu.implementation.v6000.DefaultExternalConnector.ConsultaA1100.ENDPOINT | https://wsdpre.unimed.coop.br/htz-foundation/PtuConsultA1100WSv6000 |
Procedimento para Utilização
O principal objetivo da versão 6.0 do PTU Online é adequar o Protocolo de Transações Unimed às definições do Padrão TISS 3.03 instituído pela ANS. Dentre as alterações das transações de Pedido de Autorização (00600) e Pedido de Complemento de Autorização (00605) estão contempladas as novas definições para a solicitação dos anexos de Quimioterapia e Radioterapia. Maiores detalhes das implementações da TISS 3.03 que impactam no PTU Online 6.0 podem ser encontradas no Documento Técnico TVSAZI_DT_TISS_3.03.00_TISS_3.03.01.
Acesse a página: TVUOI5_DT_PTU_ONLINE_6_0_Foundation
Módulo HAT - Atendimento ao Público
- No "TOTVS12", acesse o programa "Manutenção Autorização Guias - AT0110Z", botões "Orçamento" ou "Autorização", e efetue a inclusão de uma Guia de Autorização.
- Informe se a Guia de Autorização possui uma "Liminar Judicial". O novo campo será solicitado na tela de preenchimento das informações TISS, de acordo com o tipo da Guia (Consulta, SADT, Internação), e será trafegado no PTU.
- No "TOTVS12", acesse o programa "Consulta Dados do Beneficiário - AT0110R", e efetue a consulta dos dados de um beneficiário de intercâmbio.
- Será solicitado o preenchimento dos novos campos CPF e CNS, com cunho opcional. Da mesma forma, ao receber uma requisição de "Consulta de Dados do Beneficiário (00412)", ambos os campos serão considerados na leitura dos beneficiários da base.
- No "TOTVS12", acesse o programa "Consulta Transações Respondidas pelo WSD - AT0110RAT0110X", e efetue a uma consulta de transações - nova mensagem do PTU Online 6.0.
- Informe a "Data de Consulta ao WSD". Neste momento será comunicada uma transação A1100 do PTU Online. O WSD por sua vez, irá retornar uma lista contendo as guias de autorização autorizadas pela ferramenta, de acordo com as regras de Baixo Risco.
- Consulte as informações retornadas pela Unimed do Brasil em tela, selecione os registros a serem atualizados, e acione a da função "F1-Atualiza/Cria Registros".
- Da mesma forma como no processo batch de importação do A1100, disponível através do programa "Importação de Guias - PTU A1100 - RC0710AA", será solicitado o preenchimento de parâmetros em tela. Preencha os campos e dê continuidade ao processo.
- Serão gerados os relatórios de acompanhamento (.LST) e de erros (.ERR) no mesmo layout do programa "Importação de Guias - PTU A1100 - RC0710AA", no diretório informado na tela de "Parâmetros".
Demais alterações
- Os módulos WAC-Automação de Consultórios Web e HAW-Autorizador Web, e os programas da Solicitação TISS/XML via WebServices também foram adequados para trafegar solicitações na versão 6.0 do PTU Online.
- As transações de Pedido de Autorização (00600), Pedido de Complemento de Autorização (00605), Resposta de Pedido de Autorização (00501), Resposta de Auditoria (00404), Ordem de Serviço (00501), Resposta de Ordem de Serviço (00807) e Resposta do Status da Transação (00361) foram alteradas para trafegar o novo campo PTU "sqItem".






