WebServices RNº 395 - Cooperativas Médicas

Características do Requisito

Microsiga Protheus 

Saúde

Plano de Saúde

PLSA773

Protocolo de Atendimento

Liberação

Brasil

Todos relacionais

B00 - Protocolo de Atendimento

B4I - Repostas RN 395

B4J - Control Trans Web RN395

Descrição

Implementada melhoria no processo da RNº 395 para Operadoras Cooperativas Médicas Unimed. Foram criados WebServices, para gerenciamento de protocolos de atendimento de beneficiários de intercâmbio. 

Os WebServices criados são:

• Solicitar Protocolo - P395SolPro.APW
• Complementar Protocolo - P395ComPro P395ComPro.APW
• Responder Protocolo - P395ResAte.APW
• Consulta Status Protocolo - P395ConSta.APW
• Consulta Histórico - P395ConHis.APW
• Cancelamento - P395CanAte.APW
• Encaminhar Execução - P395EncExe.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:83/portal/P395SolPro.APW 

http://127.0.0.1:83/portal/P395ComPro.APW

Estes endereços serão seus EndPoints que deverão ser informados para a Unimed do Brasil.

A solicitação do protocolo será realizada via WebService e será acionada em todas as rotinas que já são utilizadas para a geração do protocolo. Nas rotinas do Atendimento de Guias, Liberação (PLSA094B),   Autorização SADT (PLSA094A) e e Internação (PLSA092) o protocolo vai ser integrado com o número da transação de intercâmbio PTU Online.

Assim, o fluxo de transações atendidas pelo SIGAPLS é esse:

Image Modified

Importante

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

Antes de executar o compatibilizador informe o UPDPLSHI é UPDPLSHN é 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*.

1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o U_UPDPLSHIUPDPLSHN 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 04/08/2016.
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.

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

Procedimento para Implantação

O sistema

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

1. Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
2. No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

Schemas

1. Baixe a ultima 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 \pl395web\schemas.
3. Copie os schemas disponibilizados pela Unimed do Brasil para o diretório \pl395web\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 \pl395web\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  cert.pem e key.pem.
   
   

Atualizações do Compatibilizador

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

1

Atualizações do Compatibilizador

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

1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

2.    Criação de tabela no arquivo SX2– Tabelas:

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

• Tabela B00 - Protocolo de Atendimento:

Relação

Val. Sistema

Help

Indica o tipo da manifestação.

• Tabela B4I - Repostas RN 395:

• Tabela B4I - Repostas RN 395:

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

5.  Criação ou Alteração 3.  Criação de Consulta Padrão no arquivo SXB – Consulta Padrão:

• Pesquisa B05PLSB00ANT:

6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

7.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

• Tabela BD5 – Contas Médicas:

Procedimento para Configuração

(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.

4.  Criação de Índices no arquivo SIX – Índices:

Procedimento para Configuração

CONFIGURAÇÃO DE PARÂMETROS

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

Procedimento para Utilização

Pré-etapas:

1. No pasta de seu rootpath crie a pasta plsrn395web. Dentro, desta pasta, crie as pastas env, rec, schemas e certificados. 
2. Na pasta schemas copie os arquivos XSD disponibilizados pela Unimed do Brasil: gp_ComplexTypes-V1_00_00.xsd, gp_SimpleTypes-V1_00_00.xsd e gp_Transacoes-V1_00_00.xsd.
3. Renomeie seu arquivo de certificado .p12 para certificado.p12 (este arquivo é disponibilizado pela Unimed do Brasil). Copie este arquivo para a pasta certificados. Ao utilizar o WebService pela primeira vez, o sistema criará os arquivos auxiliares ca.pem, cert.pem e key.pem.
4. É imprescindível a criação/configuração dos parâmetros descritos acima nesta documentação.

Operações como Operadora Solicitante do Protocolo:

Atendimento de Solicitação de Guia:

1. No Plano de Saúde (SIGAPLS) acesse Atualizações / Atendimento / Liberação (PLSA094B) ou Autorização SADT (PLSA094A) ou Internação (PLSA092) ou Liberação Odonto (PLSA094D)ou Autorização Odont. (PLSA094C).
2. Selecione a opção Incluir. Ao informar a matrícula do beneficiário, caso o mesmo seja um beneficiário de intercâmbio e o parâmetro MV_PL395WS estiver ativado, o sistema apresenta a nova tela para solicitação de protocolo através de WebServices:
   
   Image Added
   
3. Preencha os dados da solicitação e confirme. O sistema solicitará o Protocolo para a Operadora Origem do Beneficiário através do WebService solicitarProtocolo.
4. Preencha os dados da guia e realize a comunicação PTU Online. Ao receber a resposta da Operadora de origem do beneficiário através da transação 00501 - Resposta Pedido Autorização, o sistema automaticamente realizará a transação complemento Protocolo para informar para a Operadora Origem o número da transação de Intercâmbio.
5. Caso precise enviar novamente o complemento do protocolo, acesse Atualizações / Atendimento / Protocolo Atendimento (PLSA773). Selecione o protocolo gerado para este atendimento, clique em Ações Relacionadas/Complementar Protocolo.
   
6. Para consultar o Status deste protocolo, em Atualizações / Atendimento / Protocolo Atendimento (PLSA773), selecione o protocolo gerado para este atendimento, clique em Ações Relacionadas/Cons. status protoc. O sistema irá exibir as informações das solicitação e respostas, e atualiza o Status do protocolo de acordo com a resposta recebida:
   
   Image Added
   
   
7. Para consultar o Histórico de Protocolos de um beneficiário, ainda em  Atualizações / Atendimento / Protocolo Atendimento (PLSA773), clique em Ações Relacionadas/Cons. histórico protoc. Preencha os parâmetros e confirme. Ao finalizar a comunicação, o sistema apresentará o histórico de protocolos do beneficiário pesquisado:
   
   Image Added
   
   
8. Por padrão, é solicitado um protocolo, o status de solução dele será Pendente ou Em Andamento (vai variar da resposta da Operadora Origem do beneficiário). Quando o status está Pendente ou Em Andamento, a Operadora de Origem do beneficiário, pode enviar interações deste protocolo para a nossa Operadora (solicitante do protocolo). Essas interações são enviadas através do WebService resposta Atendimento. Quando recebemos uma transação de resposta o sistema registra a interação e muda o Status do protocolo de acordo com a interação realizada. Esta interação pode ser visualizada ao acessar: Atualizações / Atendimento / Protocolo Atendimento (PLSA773) botão Visualizar:
   
   Image Added
9. Ao cancelar esta guia na rotina de Atendimento correspondente, automaticamente o sistema irá cancelar o protocolo utilizando o WebService cancelamento.

Atendimento no Portal do Prestador:

1. No Portal do Prestador, caso o pacote da ficha TVVELN esteja aplicado, o sistema vai utilizar o WebService solicitarProtocolo para definir o número de protocolo.
2. Acesse Principal / Atendimento. Selecione um beneficiário de intercâmbio e confirme o tipo de atendimento.
3. É apresentando uma nova aba Protocolo.
   
   Image Added
   
   
4. Ao selecionar o Incluir é apresentada uma tela pra informar os dados básicos para solicitação do protocolo.
   
   Image Added
5. Ao confirmar, o sistema solicitará o número do protocolo através do WebService solicitar Protocolo.
6. Ao finalizar o atendimento, o sistema realizará a comunicação PTU Online com a Operadora.

Atendimento de Call Center

1. No Call Center (SIGATMK) acesse Atualizações / Atendimento / Call Center (TMKA271). Clique no botão Chamadas.
2. Selecione o campo Contato (UC_CODCONT) e pressione F3. No quadro entidades selecione a opção 8 - Beneficiário de Plano de Saúde. No quadro Informações da entidade, informe o beneficiário da guia de atendimento. Confirme a rotina.
3. Preencha o campo Motivo.ANS (UC_MOTPLS). Se o motivo selecionado estiver com o campo Gera Protoc. (B3B_GERPRO), como =  Sim, o sistema apresentará uma tela para gerar um Protocolo de Atendimento no padrão ANS. Se o beneficiário selecionado for de intercâmbio e o parâmetro MV_PL395WS estiver ativado, o sistema apresentará a nova tela para solicitação de protocolo através de WebServices:
   
   Image Added
4. Como não há número de atendimento de intercâmbio, o sistema não envia o número do mesmo através do WebService complementoProtocolo. As demais transações seguem o mesmo padrão do processo Atendimento de Solicitação de Guia.

Operações como Operadora Origem do Beneficiário:

Atendimento de Solicitação de Guia:

1. Através do WebService solicitarProtocolo, a Operadora que está atendendo o beneficiário solicita um número de protocolo. Ao receber esta solicitação, o sistema processa e retorna um número de protocolo para a Operadora Solicitante. Com o número de protocolo em mãos, é realizada a solicitação do Atendimento através da transação 00600 - Pedido de Autorização do PTU Online. Concluída a solicitação do Atendimento, a Operadora Executante envia o número da transação de intercâmbio através do WebService complementoProtocolo.
2. Se o atendimento estiver encerrado (Autorizado, Negado ou Autorizado Parcialmente), o sistema envia uma transação respostaAtendimento para a Operadora Executora para finalizar o protocolo.
3. Caso o atendimento esteja em Auditoria, no Plano de Saúde (SIGAPLS) acesse Atualizações / Auditoria/ Procedimentos (PLSA790). Preencha os parâmetros e confirme. 
4. Dê duplo clique no Atendimento correspondente e realize a análise da Auditoria. Ao confirmar, o sistema realiza a transação PTU Online 00404 - Resposta de Pedido de Auditoria e a transação para responder o protocolo através do WebService respostaAtendimento.
5. As demais transações o sistema responde automaticamente quando recebidas: consultaStatusProtocolo, consultaHistorico e cancelamento.
6. Importante: quando recebida uma solicitação de protocolo (solicitarProcotocolo), a transação é encaminhada para a Operadora Origem através do WebService encaminharExecucao.
   

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