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

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 é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

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.    Criação de tabela no arquivo SX2– Tabelas:

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

• Tabela B00 - Protocolo de Atendimento:

• Tabela B4I - Repostas RN 395:

• Tabela B4I - Repostas RN 395:

Importante:

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

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

• Pesquisa B00ANT:

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

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 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)

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:
   
   
3. Preencha os dados da solicitação e confirme. O sistema solicita 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 origem do beneficiário através da transação 00501 - Resposta Pedido Autorização, o sistema automaticamente realiza a transação complementoProtocolo 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 esta atendimento, clique em Ações Relacionadas/Cons. status protoc. O sistema exibe as informações da solicitação e respostas, e atualiza o Status do protocolo de acordo com a resposta recebida:
   
   
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 apresenta o histórico de protocolos do beneficiário pesquisado:
   
   
8. Por padrão, quando solicitamos 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 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 respostaAtendimento. 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:
   
   
9. Se cancelarmos esta guia na rotina de Atendimento correspondente, automaticamente o sistema vai 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.
   
4. Ao selecionar o Incluir é apresentada uma tela pra informar os dados básicos para solicitação do protocolo.
   
5. Ao confirmar, o sistema solicita o número do protocolo através do WebService solicitarProtocolo.
6. Ao finalizar o atendimento, o sistema realiza 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 que vamos digitar a 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 apresenta 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 apresenta a nova tela para solicitação de protocolo através de WebServices:
   
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 meu beneficiário solicita um número de protocolo. Ao receber esta solicitação os 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 Executora 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.