PTU ONLINE 7.0

Características do Requisito

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

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

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 PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão  11).
• 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*.

1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador 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 ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().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.

Descreva se há algum procedimento necessário após a aplicação do compatibilizador.

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.

Procedimento para Implantação

Schemas

1. Baixe a ultima ú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

• Tabela BEA

• Tabela BE4

• Tabela BQV

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

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)

1. 
   
   

   Nome da Variável

   MV_

1. PTONXSD
   Tipo	Caracter
   Descrição

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

1. Nome do arquivo .xsd das transações PTU
   Valor Padrão	ptu_Transacoes-V70_00.xsd

   
   
   

   Nome da Variável

   MV_

1. PTONVER
   Tipo	Caracter
   Descrição

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

1. Versão do PTU Online Web Service
   Valor Padrão	V70_00

1. 
   
   

   Nome da Variável

   MV_

1. PTONNAM
   Tipo	Caracter
   Descrição	Informe

1. o NameSpace das tags Ptu Online
   Valor Padrão	v70

1. 
   
   

   Nome da Variável

   MV_

1. PTOINTE
   Tipo	Caracter
   Descrição	Informe a URL do WSDL da Unimed do Brasil para utilização do

1. WebService comunicacaoInternacaoAlta

Procedimento para

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
   (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

CONFIGURAÇÃO DE MENUS

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Procedimento para Utilização

• Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
• Localização da rotina no menu;
• Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
• Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

Exemplo:

       1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

       2.            Posicione o cursor em um produto e clique em Alterar.

       3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

       4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

       5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                      Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

       6.            Confira os dados e confirme.

Vídeo

• Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

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.

Ponto de Entrada

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'NF' //Validações do usuário

EndIf