ServicePTU

3.2.0.0

Requisitos de
Implantação
João Pessoa, Novembro de 2017.
 Este documento foi desenvolvido pela equipe da Infomed, é um
guia para orientação ao usuário sobre a implantação do ServicePTU.

É proibida a sua reprodução parcial ou total sem prévia autorização

da Unimed NNE - Unidade de Tecnologia.

Infomed 2017© Todos os direitos reservados.

Gestão de Planos de Saúde

Unimed NNE
Unidade de Tecnologia

Av. Josefa Taveira, nº 53 – Mangabeira

CEP 58055-000 – João Pessoa – PB.
Fone: (83) 3048-2570
www.Infomed.inf.br
Sumário
1. Introdução ..................................................... 4
2. Servidor Web .................................................. 5
2.1. Configuração Mínima .............................................. 5
2.2. Configuração Recomendada ..................................... 5

3. Recomendações ............................................... 6
4. Instalação do ServicePTU ................................... 7
4.1. Permissões .......................................................... 7
4.2. Configuração IIS .................................................... 7
4.2.1. Restrições ISAPI e CGI ...................................................... 7
4.2.2. Mapeamentos de Manipulador ............................................ 8
4.3. Habilitando HTTPS no IIS ........................................ 10
4.4. Instalação ou Atualização via WebWizard.................... 13
4.5. Página de Teste ................................................... 17

5. Resumo das Transações e Respectivas URL’s ......... 19

6. Cadastro dos Endpoints da Unimed Brasil ............. 20
7. Certificado ................................................... 21
1. Introdução
Este documento visa o apoio aos usuários do ServicePTU na atividade de instalação
do produto, de modo que os detalhes correspondentes e os requisitos de T.I. serão
abordados ao longo das próximas seções.

4
2. Servidor Web
Para que a instalação do produto seja realizada com sucesso, é necessário um
servidor de aplicação Web com as configurações indicadas abaixo.

2.1. Configuração Mínima

Os requisitos mínimos são voltados para operadoras de pequeno porte, com um
baixo fluxo de transação por minuto. Para aquelas com alto fluxo, será necessário
um servidor mais robusto e uma infraestrutura de rede adequada para o volume de
dados transmitidos.

 Windows Server 2008 R2 SP1 64 bits

 20 GB de Espaço em Disco
 4 GB de memória RAM
 IIS instalado e habilitado o recurso de desenvolvimento de aplicativos ASP.NET
 Processador categoria servidor (Intel Xeon, por exemplo)
 Cliente Oracle 11g 64 bits
 .Net 4.0 SP1
 Firefox 20+ ou Chrome 25+ Instalado (para teste de acesso)

2.2. Configuração Recomendada

Para operadoras de médio e grande porte, recomendamos a configuração abaixo.
Para os itens não listados, permanece a configuração mínima acima.

 Windows Server 2012 R2 SP1 64 bits

 16 GB de RAM

5
3. Recomendações
Antes de instalar o ServicePTU, é necessário verificar suas dependências, ou seja,
a versão mínima do Infomed GPS. Caso não sejam respeitadas as interdependências,
a aplicação pode não funcionar adequadamente.
Importante:
As aplicações Web estão homologadas para utilização em sistemas operacionais
cujo idioma seja Português do Brasil (pt-br). Portanto, seu uso em ambientes com
idioma em inglês poderá provocar comportamentos e resultados inesperados.

6
4. Instalação do ServicePTU

4.1. Permissões
No servidor Web, o diretório: “C:\TempImageFiles” deve ter sido criado, inclusive
com permissão de escrita para o usuário IIS_IUSRS.

4.2. Configuração IIS

O funcionamento apropriado do ServicePTU requer o alinhamento do ISS através
de duas tarefas: a verificação das Restrições ISAPI/CGI e dos Mapeamentos de
Manipulador. Os detalhes quanto à execução de cada uma encontram-se a seguir.

4.2.1. Restrições ISAPI e CGI

Na página inicial do IIS, clique no ícone Restrições ISAPI e CGI – Figura 1. Em

seguida, observando a interface ilustrada na Figura 2, verifique se já existem
restrições para a versão 4.0 do framework .NET; não havendo, deverão ser
adicionadas duas novas restrições: uma para 32 bits, e outra para 64 bits. Para
adicionar uma restrição, clique no botão Adicionar... do painel de Ações (à direita
na Figura 1).
Na interface para Adicionar Restrição ISAPI ou CGI (Figura 2), preencha os campos
da seguinte forma:

Caminho ISAPI ou CGI – indique o caminho para a DLL isapi do framework 4.0.
Exemplo:

 32 bits – C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_ isapi.dll

 64 bits - C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_ isapi.
dll
Descrição – insira uma descrição que identifique a versão do framework e do
sistema. Exemplo:

 32 bits - ASP.NET v4.0 32 bits

 64 bits - ASP.NET v4.0 64 bits
Marque a opção Permitir que o caminho da extensão seja executado.

7
 Figura 1: Gerenciador de Serviços de Informações da Internet – Pagina Inicial VIAGEM-PC

Figura 2: Gerenciador de Serviços de Informações da Internet – Restrição ISAPI ou CGI

4.2.2. Mapeamentos de Manipulador

Na página inicial do IIS, clique em Mapeamentos de Manipulador e, nesse ambiente
(ilustrado na Figura 3), verifique se existem os seguintes mapeamentos:

 PageHandlerFactory-ISAPI-4.0_64bit
 PageHandlerFactory-ISAPI-4.0_32bit
 PageHandlerFactory-Integrated-4.0
 svc-Integrated-4.0
 svc-ISAPI-4.0_32bit

8
  svc-ISAPI-4.0_64bit
Caso algum desses esteja faltando, será necessário adicioná-lo.

Figura 3: Gerenciador de Serviços de Informações da Internet – Mapeamentos de Manipulação

Para adicionar um novo mapeamento, você deve clicar no botão Adicionar

Mapeamento de Script... (disposto no painel de Ações - Figura 3). Na interface
correspondente (Figura 4), os campos devem ser preenchidos da seguinte forma:

 Caminho da solicitação – indique a extensão que será adicionada. Exemplo:

 *.aspx - para os mapeamentos iniciados com PageHandlerFactory

 *.svc – para os mapeamentos iniciados com svc

 Executável – indique o caminho para a DLL isapi do framework 4.0. Exemplo:

 32 bits - C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll
 64 bits - C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.
dll
 Nome – insira o nome do mapeamento
 Clique no botão Restrições da Solicitação...
 Certifique-se de que todos os verbos estarão selecionados na aba respectiva
Certifique-se de que a opção Script estará selecionada na aba Acesso.

9
 Figura 4: Gerenciador de Serviços de Informações da Internet – Adicionar Manipulação de Script

4.3. Habilitando HTTPS no IIS

O ServicePTU dependem da ativação do protocolo HTTPS, ainda que a operadora
não possua um certificado emitido oficialmente. Para habilitar o HTTPS, o usuário
deve acessar o IIS e, através do item Default Website, clicar em Associações (no
painel de Ações). Uma vez exibida a interface de Associações do Site (Figura 5), o
usuário deve clicar no botão Adicionar.

Figura 5: Associações de Site

10
 Em seguida, é necessário definir dois elementos, ambos ilustrados na Figura 6: a
opção ‘https’ no campo Tipo, e o certificado a ser utilizado; caso a operadora não
possua um, poderá solicitar ao IIS um certificado Autoassinado.

Figura 6:Adicionar Associações de Site

A geração de um certificado Autoassinado requer os seguintes passos:

primeiramente, é preciso escolher o servidor apropriado a partir do painel de
Conexões e, em seguida, aplicar um duplo clique sobre o recurso Certificados de
Servidor, apresentado de forma selecionada na Figura 7.

Figura 7: Gerenciamento do Serviço de Informações de Internet – Pagina Inicial

11
 Na interface de Certificados, o usuário deve clicar na opção Criar Certificado
Autoassinado (no painel de Ações - à direita na Figura 8), a qual solicitará a atribuição
de um nome e escolha de um repositório, segundo caracteriza a Figura 9.

Figura 8: Gerenciamento do Serviço de Informações de Internet – Certificados de Servidor

Figura 9: Criar Certificado Autoassinado

12
 A última etapa do procedimento consiste em selecionar o novo certificado gerado
a partir da interface de ativação de HTTPS.

4.4. Instalação ou Atualização via WebWizard

No intuito de auxiliar no processo de instalação ou atualização dos seus produtos
Web, o Infomed fornece a aplicação chamada Infomed GPS WebWizard, cuja
inicialização encontra-se ilustrada na Figura 10. Contudo, o arquivo executável
correspondente apenas deverá ser acionado quando realizadas por completo as
configurações do IIS (instalação do .Net 4 e Mapeamentos de Manipulador).

Figura 10: Instalador de SERVICEPTU – Pré-requisito

O WebWizard permite as seguintes ações:

 Remoção de versões anteriores da aplicação

 Atualização de versões anteriores para a atual
 Instalação de novas versões
A aplicação detectará a existência de alguma versão previamente instalada,
exibindo-a na lista de Aplicações Instaladas (ilustrada na Figura 11). Diante de tais
situações, o usuário poderá optar pela Atualização ou por um Novo Aplicativo, que
representa uma nova instalação (ambas as opções são visualizadas também na Figura
11).

Se o usuário escolher uma nova instalação, deve selecionar a opção respectiva e,

em seguida, preencher os Dados da Aplicação (observados na imagem abaixo):

 Alias, indicando como será chamada a aplicação dentro do IIS

13
  Diretório Destino onde será instalada a aplicação
Importante:
O Diretório Destino deve ser previamente cadastrado.

 Pool de aplicação a ser utilizado pela Aplicação Web. É oportuno destacar

que, para a criação de um novo pool, conforme a conveniência do usuário,
este deve recorrer ao botão + (disposto ao lado do campo em questão) e
especificar as informações ilustradas na Figura 12

Figura 11: Instalador de SERVICEPTU – Configuração do Servidor

Figura 12: Adicionar Pool de Aplicação

É facultado ao usuário Remover a Aplicação através da opção respectiva

(visualizada na Figura 13), disponibilizada a partir de um clique com o botão direito
do mouse sobre o item da lista de Aplicações Instaladas. Contudo, o acesso a tal

14
opção (com o botão esquerdo do mouse) não implicará a imediata remoção, pois o
Webwizard emitirá uma mensagem (Figura 14) para que o usuário confirme o
interesse nesta ação.

Figura 13: Instalador de SERVICEPTU – Configuração do Servidor

Figura 14: Mensagem de Confirmação

Depois de estabelecidos os parâmetros relativos ao Servidor, o assistente iniciará

a etapa de Configuração da Aplicação (Webconfig), constatada na Figura 15. A
interface permite a configuração dos dados de forma rápida e prática, sobretudo por
apresentar dicas de significado do item à medida que selecionado (observar campo
Edição de Parâmetro), além do seu valor recomendado.

15
 Figura 15: Instalador de SERVICEPTU – Configuração de Aplicação

Há uma ressalva em relação a determinados campos, na medida em que alguns

destes possuem um caráter restritivo quanto à inserção de um valor pré-definido.
Portanto, serão exibidos pelo sistema exclusivamente os valores presentes dentro da
faixa de aceitáveis; não havendo qualquer bloqueio para os demais campos.

A Figura 15 denota ainda a possibilidade de atribuir um Proxy para que seja

utilizado pela Aplicação.
O procedimento para configurá-lo consiste, primeiramente, em marcar a opção
Utilizar Proxy e, em seguida, na composição de dois elementos a partir do ambiente
de Edição das Configurações (acompanhar a Figura 16): as Exceções e um Endereço;
quanto a este último, vale reforçar que a porta de acesso também deve ser designada
(por exemplo, https://proxy.infomed.inf.br:3128).

Figura 16: Configuração de Proxy

16
 Quando finalizado o processo (etapa caracterizada na Figura 17), será apresentada
de forma automática pelo assistente a página de teste, independentemente do
formato da operação escolhido pelo usuário, ou seja, instalação ou atualização;
inclusive, durante a configuração desta última, caso ocorra alguma falha, o
assistente recuperará uma cópia de segurança, gerada no decorrer de todo o
procedimento.

Figura 17: Instalador de SERVICEPTU - Finalizado

4.5. Página de Teste

A página de validação da instalação e configuração do sistema pode ser acessada
através da URL:

 https://localhost/ServicePTU/Webtest/PTUTeste.aspx
ou
 http://localhost/ServicePTU/Webtest/PTUTeste.aspx
Importante:
A página de teste que será exibida pode iniciar com http ou https, isso será
determinado pela configuração do SSL da aplicação.

Será exibida a interface ilustrada na Figura 18. Após o preenchimento dos campos
indicados abaixo, o usuário deve apenas clicar no botão Iniciar Teste e aguardar a
execução dos testes de operação da aplicação.

 Código da Unimed
 Nome do Prestador

17
  Url do Serviço (por exemplo, https://localhost/ServicePTU/consultaprestador
.svc)
O campo Resultado Processamento apresentará o Status de cada elemento
avaliado.

Figura 18: Página de Teste SERVICEPTU

18
5. Resumo das Transações e Respectivas URL’s
É possível que a Unimed Brasil solicite as informações dos endpoints da Operadora.
Neste caso, informar:

TRANSAÇÃO URL
Pedido de Autorização https://nome_do_dominio/serviceptu/PedidoAutorizacao.
svc
Pedido de Complemento https://nome_do_dominio/serviceptu/ComplementoAutor
izacao.svc
Pedido de Cancelamento https://nome_do_dominio/serviceptu/CancelamentoAutor
izacao.svc
Pedido de Insistência https://nome_do_dominio/serviceptu/PedidoInsistencia.s
vc
Ordem de Serviço https://nome_do_dominio/serviceptu/OrdemServico.svc
Resposta de Auditoria https://nome_do_dominio/serviceptu/RespostaAuditoria.s
vc
Consulta Dados do Prestador https://nome_do_dominio/serviceptu/ConsultaPrestador.
svc
Consulta Dados do Beneficiário https://nome_do_dominio/serviceptu/ConsultaBeneficiari
o.svc
Contagem de Beneficiários https://nome_do_dominio/serviceptu/ContagemBeneficia
rios.svc
Status da Transação https://nome_do_dominio/serviceptu/StatusTransacao.sv
c
Autorização da Ordem de Serviço https://nome_do_dominio/serviceptu/AutorizacaoOrdemS
ervico.svc
Comunicação de Decurso de https://nome_do_dominio/serviceptu/ComunicacaoDecur
Prazo soPrazo.svc
Comunicação de Internação/Alta https://nome_do_dominio/serviceptu/ComunicacaoIntern
açãoAlta.svc
Tabela 1: Lista de transações

Onde, nome_do_dominio é de conhecimento da equipe de infraestrutura da

Operadora.

19
6. Cadastro dos Endpoints da Unimed Brasil
Interface:
 Produção Médica / Apoio / Parâmetros do Autorizador

Na edição dos parâmetros, aba EndPoints, informar os endpoints de homologação

da Unimed Brasil para o PTU Online versão 7.0.

DESCRIÇÃO URL's PARA OS ENDPOINTS DE HOMOLOGAÇÃO

Autorização de Ordem de Serviço
Cancelamento
Comunicação de Decurso de
Prazo
Consulta A1100
Consulta dados do Beneficiário
Consulta dados do Prestador
Ordem de Serviço
Pedido de Autorização
Complemento
Pedido de Insistência
Contagem de Beneficiários
Resposta de Auditoria
Status da Transação
Tabela 2: Lista de endpoints
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_v70_00/AutorizacaoOrdemSer
vico
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_V70_00/Cancelamento
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_V70_00/ComunicacaoDecurso
Prazo
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_V70_00/ConsultaA1100
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_V70_00/ConsultaDadosBenefic
iario
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_V70_00/ConsultaDadosPrestad
or
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_V70_00/OrdemServico
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_V70_00/PedidoAutorizacao
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_V70_00/PedidoComplementoA
utorizacao
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_V70_00/PedidoInsistencia
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_V70_00/RequisicaoContagemB
eneficiarios
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_V70_00/RespostaAuditoria
https://wsd.homologacao.unimed.coop.br/wsdintercambi
o/intercambioservices/ptu_V70_00/StatusTransacao

Para configurar os endpoints de produção é necessário trocar o domínio

wsd.homologacao.unimed.coop.br por wsd.unimed.coop.br

20
7. Certificado
Caso a Unimed Brasil indique necessidade de emissão de novo certificado, após
obtenção, executar as ações indicadas a seguir:
1. Com o certificado enviado pela Unimed Brasil para o PTU, copie para a pasta de
certificados do BRIX:
C:\brix\bin\GPS\Certificados\PTU
2. Configure o GPS para utilizar o PTU:
Interface:
 Produção Médica / Apoio / Parâmetros do Autorizador / Editar / PTU Eletrônico

Na edição dos parâmetros, aba PTU Eletrônico informar os seguintes campos:

- Certificado digital (informe o nome completo do arquivo do certificado)

- Senha do certificado (informe a senha)

3. No servidor aplicação WEB, caso utilize o ServiceInfomed, copie o certificado para

pasta
C:\inetpub\wwwroot\serviceinfomed\GPS\Certificados\PTU.
Importante:
Dependendo da opção da operadora, a pasta acima pode mudar para
<pasta_base_aplicação_serviceinfomed> \ serviceinfomed \ GPS \ Certificados \ PTU,
onde <pasta_base_aplicação_serviceinfomed> é definida pela equipe de TI da
operadora.

21
 Infomed GPS
Gestão de Planos de Saúde

Requisitos de Implantação
ServicePTU
3ª Edição

Contato | Informações | Dúvidas

Unimed NNE - Unidade de Tecnologia

CH – Coordenação de Homologação

Av. Josefa Taveira, nº 53 – Mangabeira

CEP 58055-000 – João Pessoa – PB.
Fone: (83) 3048-2500
www.Infomed.inf.br