PTU ONLINE 7.0

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Saúde

Módulo:

Plano de Saúde

Rotina:

Rotina

Nome Técnico

PLPTUONWEB

Comunicação PTU Online

País(es):

Brasil

Banco(s) de Dados:

Todos

Sistema(s) Operacional(is):

Todos

Descrição

Implementada melhoria atualizando o sistema para a versão 7.0 do PTU Online.

Os WebServices atualizados:

  • pedidoAutorizacao (00600) - PTOnPedAut.APW
  • pedidoComplementoAutorizacao (00605) - PTOnComAut.APW
  • pedidoInsistencia (00302) - PTOnPedIns.APW
  • respostaAuditoria (00404) - PTOnResAud.APW
  • cancelamento (00311) - PTOnCancel.APW
  • consultaDadosBeneficiario (00412) - PTOnDadBen.APW
  • consultaDadosPrestador (00418) - PTOnDadPre.APW
  • statusTransacao (00360) - PTOnStaTra.APW 
  • comunicacaoDecursoPrazo (00700) - PTOnDecPra.APW
  • ordemServico (00806) - PTOnOrdSer.APW
  • autorizacaoOrdemServico (00804) - PTOnAutOS.APW
  • contagemBeneficiariosWS (00430) - PTOnConBen.APW

Os WebServices criados:

  • comunicacaoInternacaoAltaWS (00750) - PTOnComInt.APW


Estes WebServices vão utilizar o endereço e porta de seu Portal do Plano de Saúde. Assim a URL para acessar um WebService será: http://[endereçoportal]:[porta]/portal/[nome do webservice].APW
Exemplos: 
http://127.0.0.1:433/portal/PTOnPedAut.APW 
http://127.0.0.1:443/portal/PTOnComAut..APW
Estes endereços serão seus EndPoints que deverão ser informados para a Unimed do Brasil.

Importante: a porta parametrizada deve ser a 443 (definição da Unimed do Brasil).


Para viabilizar essa melhoria, é necessário aplicar o pacote de atualizações (Patch) deste chamado.

A partir da versão 6.0 não é mais necessário a aplicação dos layouts DE0, DE1, DE3 e DE9.


Importante


Antes de executar o compatibilizador informe o UPDPTON7 é imprescindível:

  • Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (diretório \PROTHEUS11_DATA\SYSTEM).
  • Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
  • Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
  • Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
  • O compatibilizador deve ser executado com a Integridade Referencial desativada*.


Atenção

O procedimento a seguir deve ser realizado por um profissional   qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

A ativação indevida da Integridade Referencial pode alterar   drasticamente o relacionamento entre tabelas no banco de dados. Portanto,   antes de utilizá-la, observe atentamente os procedimentos a seguir:

  1. No   Configurador (SIGACFG), veja se a empresa utiliza Integridade   Referencial, selecionando a opção Integridade/Verificação   (APCFG60A).
  2. Se não   há Integridade Referencial ativa,   são relacionadas em uma nova janela todas as empresas e filiais cadastradas   para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário   qualquer outro procedimento de ativação   ou desativação de integridade, basta finalizar a verificação e aplicar   normalmente o compatibilizador, conforme instruções.
  3.  Se há Integridade Referencial ativa   em todas as empresas e filiais, é   exibida uma mensagem na janela Verificação   de relacionamento entre tabelas. Confirme a mensagem para que a   verificação seja concluída, ou;
  4.  Se   há Integridade Referencial ativa   em uma ou mais empresas, que não   na sua totalidade, são relacionadas em uma nova janela todas as empresas e   filiais cadastradas para o sistema e, somente, a(s) que possui(em)   integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou   filial(is) possui(em) a integridade ativada e reserve esta anotação para   posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework   para informações quanto a um arquivo que contém essa informação).
  5. Nestes   casos descritos nos itens “iii” ou   “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
  6.  Quando desativada a Integridade Referencial,   execute o compatibilizador, conforme instruções.
  7. Aplicado o compatibilizador, a Integridade   Referencial deve ser reativada, SE E   SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as   informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da   integridade, selecione-a(s) novamente e confirme a ativação.


Contate o Help Desk Framework EM CASO DE DÚVIDAS!


  1. Em Microsiga Protheus TOTVS Smart Client, digite o U_UPDPTON7 no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 11/09/2017.
  2. Clique em OK para continuar.
  3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
  4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
    1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
    2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
    3. Clique em Gravar para salvar o histórico (log) apresentado.
    4. Clique em OK para encerrar o processamento.

Procedimento para Implantação

TISS

  1. No Plano de Saúde (SIGAPLS), acesse Atualizações\Operadora\Versões Tiss
  2. Selecione a versão utilizada pela sua operadora e clique em (re)carregar versão para atualizar os campos do portal do prestador.

Schemas

  1. Baixe a última versão dos schemas disponibilizados através dos Boletins Mais Informações Tecnologia da Unimed do Brasil.
  2. Em seu rootpath, crie a estrutura de pastas \ptuonweb\schemas\.
  3. Copie os schemas disponibilizados pela Unimed do Brasil para o diretório \ptuonweb\schemas\.

Certificado

  1. Solicite para a Unimed do Brasil, um certificado para sua operadora. 
  2. Renomeie o arquivo de certificado .p12 para certificado.p12.
  3. Em seu rootpath, crie a estrutura de pastas \ptuonweb\certificados\. Copie o arquivo certificado.p12 para este diretório.
  4. Ao utilizar a comunicação PTU pela primeira vez, o sistema criará os arquivos para comunicação ca.pem, cert.pem e key.pem.
  5. Importante: informe no parâmetro MV_PTONSEN a senha do certificado disponibilizado pela Unimed do Brasil.


Binário

  1. Para a utilização dos novos recursos do PTU Online 7.0 com troca de informações via Web Service é necessário a atualização do binário para a Build 7.00.131227A
  2. Consulte a documentação: PSIGABD0053 - Procedimento para atualizar o binário do Protheus.
  3. Entre em contato com o suporte técnico para solicitar o arquivo appserver_http11.zip com os arquivos do binário específicos para a funcionalidade do PTU Online.
  4. Baixe o arquivo appserver_http11.zip e atualize no binário os arquivos: AppServer.exe, apwin32.dll e apwinnt.dll.

Atualizações do Compatibilizador


1.  Criação de Campos no arquivo SX3 – Campos:

  • Tabela BE1

Campo

BE1_TOKEDI

Tipo

Caracter

Tamanho

6

Título

Token

Help

Token Atendimento


  • Tabela BEA

Campo

BEA_TOKEDI

Tipo

Caracter

Tamanho

6

Título

Token

Help

Token Atendimento


  • Tabela BE4

Campo

BE4_TOKEDI

Tipo

Caracter

Tamanho

6

Título

Token

Help

Token Atendimento


  • Tabela BQV

Campo

BQV_TOKEDI

Tipo

Caracter

Tamanho

6

Título

Token

Help

Token Atendimento


2.  Criação de Parâmetros no arquivo SX6 – Parâmetros:


Nome da Variável

MV_PTOPEAU

Tipo

Caracter

Descrição

Informe a URL do WSDL da Unimed do Brasil para utilização do WebService pedidoAutorizacao

Procedimento para Configuração

 

CONFIGURAÇÃO DE PARÂMETROS

 

  1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:

    Nome:

    MV_PTUVEON

    Tipo:

    Caracter

    Cont. Por.:

    70

    Descrição:

    Versão da Transação PTU Online



    Nome:

    MV_PT60LOG

    Tipo:

    Caracter

    Cont. Por.:

    0

    Descrição:

    Exibe no log de PTU Online, o Soap de envio e recebimento. (0=Não exibe/1=Exibe)



    Nome da Variável

    MV_PTONXSD

    Tipo

    Caracter

    Descrição

    Nome do arquivo .xsd das transações PTU

    Valor Padrão

    ptu_Transacoes-V70_00.xsd



    Nome da Variável

    MV_PTONVER

    Tipo

    Caracter

    Descrição

    Versão do PTU Online Web Service

    Valor Padrão

    V70_00



    Nome da Variável

    MV_PTONNAM

    Tipo

    Caracter

    Descrição

    Informe o NameSpace das tags Ptu Online

    Valor Padrão

    v70



    Nome da Variável

    MV_PTOINTE

    Tipo

    Caracter

    Descrição

    Informe a URL do WSDL da Unimed do Brasil para utilização do WebService comunicacaoInternacaoAlta

Procedimento para Utilização


Melhorias da nova versão:

Novos campos Protocolo e Token - Pedido de Autorização 00600 - Remote

  1. No Plano de Saúde (SIGAPLS), acesse Atualizações/ Atendimento/ Liberação (PLSA094B), Autorização SADT (PLSA094A) ou Internação (PLSA092), clique em Incluir.
  2. Ao digitar uma matrícula de intercâmbio, informe o Protocolo de Atendimento, ou comunique com o WebService de Solicitação de Protocolo (se o mesmo estiver ativado) para solicitar o número.
  3. Na aba Outros, preencha o campo Token (BE1_TOKEDI ou BE4_TOKEDI).
  4. Ao realizar a comunicação PTU Online (clicando no Globo de Comunicação ou confirmando a guia, dependendo do parâmetro MV_PTGLOBO), o sistema gera o Pedido de Autorização (00600) com as novas tags protocolo e token, de acordo com os campos preenchidos acima.

 

Novos campos Protocolo e Token - Pedido de Autorização 00600 - Portal do Prestador

  1. No Portal do Prestador, acesse Principal/ Atendimento. Selecione um beneficiário de intercâmbio e indique o Tipo de Atendimento: Consulta, SADT ou Internação. Clique em Atendimento.
  2. Preencha os campos 000 - Protocolo (há a opção de solicitar o número via WebService) e 099 - Token. Ao confirmar a guia, o sistema gera o Pedido de Autorização (00600) com as novas tags protocolo e token, de acordo com os campos preenchidos.


Novos campos Protocolo e Token - Pedido de Complemento de Autorização 00605 - Remote

  1. No Plano de Saúde (SIGAPLS), acesse Atualizações/ Atendimento/Autorização SADT (PLSA094A) ou Internação (PLSA092).
  2. Na rotina Autorização SADT (PLSA094A) selecione a guia já comunicada e clique em Ações Relacionadas / Evolução Sadt. Na rotina Internação (PLSA092) selecione a guia já comunicada e clique em Ações Relacionadas / Prorrog. Interna.
  3. Informe o Protocolo de Atendimento, ou comunique com o WebService de Solicitação de Protocolo (se o mesmo estiver ativado) para solicitar o número.
  4. Preencha o campo Token (BQv_TOKEDI).
  5. Ao realizar a comunicação PTU Online (clicando no Globo de Comunicação ou confirmando a guia, dependendo do parâmetro MV_PTGLOBO), o sistema gera o Pedido de Complemento de Autorização (00605) com as novas tags protocolo e token, de acordo com os campos preenchidos acima.

Nova transação 00750 - Comunicação de Internação ou Alta do Beneficiário - Remote

  1. No Plano de Saúde (SIGAPLS), acesse Atualizações/ Atendimento/ Internação (PLSA092).
  2. Selecione uma guia de internação já comunicada e clique em Ações Relacionadas / Data Internação. Informe os dados e confirme, o sistema gera uma Comunicação de Internação ou Alta do Beneficiário (00750) com os dados do início da Internação.
  3. Selecione a guia de internação utilizada no passo 2 e clique em Ações Relacionadas / Data Alta. Informe os dados e confirme, o sistema gera uma Comunicação de Internação ou Alta do Beneficiário (00750) com os dados do alta da Internação.


Nova transação 00750 - Comunicação de Internação ou Alta do Beneficiário - Portal do Prestador

  1. Na Versão 11, o Portal do Prestador permite somente a inclusão de Data de Internação.
  2. No Portal do Prestador, acesse Principal/ Internação. Indique a guia de um beneficiário de intercâmbio internado e cliquem em Buscar. 
  3. Indique os dados do início da Internação e clique em Executar, o sistema gera uma Comunicação de Internação ou Alta do Beneficiário (00750) com os dados do início da Internação.