Web services RN 395

Características do Requisito

Descrição

No Foundation Saúde foram implementados os web services para atender a RN 395 da ANS de acordo com os schemas definidos pela Unimed do Brasil. Os novos serviços são integrados ao módulo MR - Marketing Receptivo do Gestão de Planos. Este projeto contempla a integração entre os módulos AT e MR.

Procedimento para Implantação

A implementação descrita no documento estará disponível a partir da atualização do pacote no cliente.

O pacote está disponível no portal (https://suporte.totvs.com/download).

Procedimento para Configuração

CONFIGURAÇÃO DE PARÂMETROS NO FOUNDATION SAÚDE

No arquivo <JBoss>/server/<instancia>/conf/foundation-exchange.properties, foram criadas novas propriedades que devem ser configuradas para o funcionamento dos web services no Foundation Saúde.

Endpoints

Propriedades referentes aos endpoints dos serviços da Unimed do Brasil. Existe uma propriedade para cada web service, e no exemplo abaixo está configurado para o ambiente de homologação.

com.totvs.foundation.protocolmanager.message.v1_00_00.RequestProtocol.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/v1_00_00/SolicitarProtocolo
com.totvs.foundation.protocolmanager.message.v1_00_00.AnswerProtocol.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/v1_00_00/RespostaAtendimento
com.totvs.foundation.protocolmanager.message.v1_00_00.CancelRequest.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/v1_00_00/Cancelamento
com.totvs.foundation.protocolmanager.message.v1_00_00.CompleteProtocol.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/v1_00_00/ComplementoProtocolo
com.totvs.foundation.protocolmanager.message.v1_00_00.SearchBeneficiaryProtocolHistory.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/v1_00_00/ConsultaHistorico
com.totvs.foundation.protocolmanager.message.v1_00_00.SearchProtocolStatus.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/v1_00_00/ConsultaStatusProtocolo
com.totvs.foundation.protocolmanager.message.v1_00_00.ForwardPerformedSolicitation.ENDPOINT = https://gpuhml.unimed.coop.br/gpu/v1_00_00/EncaminharExecucao

URI

Propriedades que definem os namespaces dos web services definidos pelo schema. Existe uma propriedade para cada web service e não é necessário alterar a definição, basta copiar para o arquivo.

com.totvs.foundation.protocolmanager.message.v1_00_00.RequestProtocol.URI = http://gp.unimed.coop.br/solicitarProtocolo/webservices/V1_00_00
com.totvs.foundation.protocolmanager.message.v1_00_00.AnswerProtocol.URI = http://gp.unimed.coop.br/respostaAtendimento/webservices/V1_00_00
com.totvs.foundation.protocolmanager.message.v1_00_00.CancelRequest.URI = http://gp.unimed.coop.br/cancelamento/webservices/V1_00_00
com.totvs.foundation.protocolmanager.message.v1_00_00.CompleteProtocol.URI = http://gp.unimed.coop.br/complementoProtocolo/webservices/V1_00_00
com.totvs.foundation.protocolmanager.message.v1_00_00.SearchBeneficiaryProtocolHistory.URI = http://gp.unimed.coop.br/consultaHistorico/webservices/V1_00_00
com.totvs.foundation.protocolmanager.message.v1_00_00.SearchProtocolStatus.URI = http://gp.unimed.coop.br/consultaStatusProtocolo/webservices/V1_00_00
com.totvs.foundation.protocolmanager.message.v1_00_00.ForwardPerformedSolicitation.URI = http://gp.unimed.coop.br/encaminharExecucao/webservices/V1_00_00

WSDL

Propriedades que definem os endereços dos arquivos WSDL no servidor local da operadora. Existe uma propriedade para cada serviço e estas devem ser alteradas para corresponder ao endereço da aplicação Foundation Saúde e porta em que o JBoss foi carregado.

http://<endereço>:<porta>/wsdl/v1_00_00/solicitarProtocolo_V1_00_00.wsdl

com.totvs.foundation.protocolmanager.message.v1_00_00.RequestProtocol.WSDL = http://10.54.252.21:28080/wsdl/gp/v1_00_00/solicitarProtocolo_V1_00_00.wsdl
com.totvs.foundation.protocolmanager.message.v1_00_00.AnswerProtocol.WSDL = http://10.54.252.21:28080/wsdl/gp/v1_00_00/respostaAtendimento_V1_00_00.wsdl
com.totvs.foundation.protocolmanager.message.v1_00_00.CancelRequest.WSDL = http://10.54.252.21:28080/wsdl/gp/v1_00_00/cancelamento_V1_00_00.wsdl
com.totvs.foundation.protocolmanager.message.v1_00_00.CompleteProtocol.WSDL = http://10.54.252.21:28080/wsdl/gp/v1_00_00/complementarProtocolo_V1_00_00.wsdl
com.totvs.foundation.protocolmanager.message.v1_00_00.SearchBeneficiaryProtocolHistory.WSDL = http://10.54.252.21:28080/wsdl/gp/v1_00_00/consultaHistorico_V1_00_00.wsdl
com.totvs.foundation.protocolmanager.message.v1_00_00.SearchProtocolStatus.WSDL = http://10.54.252.21:28080/wsdl/gp/v1_00_00/consultaStatusProtocolo_V1_00_00.wsdl
com.totvs.foundation.protocolmanager.message.v1_00_00.ForwardPerformedSolicitation.WSDL = http://10.54.252.21:28080/wsdl/gp/v1_00_00/encaminharExecucao_V1_00_00.wsdl

Timeout

Opcionalmente pode ser configurado a propriedade de timeout para os serviços do gerenciamento de protocolos. Essa propriedade define o tempo máximo que o Foundation Saúde irá esperar por uma resposta da Unimed do Brasil até que o encerre a comunicação e devolva um erro. O valor dessa propriedade é definida em milissegundos e o exemplo abaixo está configurado para 9 segundos.

protocolmanager.webservices.timeout = 9000

Schemas e WSDL's

É necessário copiar todos os arquivos XSD e WSDL referentes ao Gestão de Protocolos disponibilizados pela Unimed do Brasil para a pasta <JBoss>/server/<instancia>/deploy/wsdl.war/gp/v1_00_00.

CONFIGURAÇÃO DE PARÂMETROS NO GESTÃO DE PLANOS DE SAÚDE

Parâmetros Globais Sistema (pr1410p)

1. Alterar o parâmetro Integração RN395/Intercambio para: 2 - Online;
2. Informar a URL de comunicação com o Foundation Saúde, que é o endereço para o serviço WsdProtocolManager:
   
   1. Exemplo: http://fndsauhml.totvs.com.br:28080/htz-foundation/WsdProtocolManagerWS?wsdl
3. Informar o Namespace de comunicação com o Foundation Saúde:
   1. Valor fixo igual a "http://v1_00_00.ws.protocolmanager.foundation.totvs.com/"

Manter Parâmetros Marketing Receptivo (HMRParametersView)

1. Grupo de atendimento responsável pelo Web Service:
   1. Define o grupo de atendimento para o qual serão criados os chamados recebidos pelo serviço de Solicitar Protocolo ou através da digitação da guia no AT;
2. Usuario responsável pelo Web Service:
   1. Campo opcional para indicar qual será o usuário que será o responsável pelos chamados que chegarem pela Solicitação de Protocolo do Web Service ou através da digitação da guia no AT. Na ausência desse parâmetro, o chamado será criado com Nenhum Responsável, e todos os atendentes do grupo poderão visualizar a solicitação até que um usuário assuma.

Manter Categorias de Atendimento(CallCategoryView)

Na manutenção de um registro, foi criado o campo Tipo Manifestação para relacionar essa informação com a Categoria de Atendimento do Gestão de Planos. As opções de preenchimento, listadas abaixo, são oriundas do domínio da Unimed do Brasil:

1. Elogio;
2. Reclamação;
3. Denúncia;
4. Sugestão;
5. Dúvida;
6. Solicitação.

Deve ser criado uma Categoria de Atendimento para cada Tipo de Manifestação para que a criação de um chamado através de uma Solicitação de Protocolo recebida pelo web service seja efetuada corretamente.

Manter Motivos de Atendimento (CallMotiveView)

Na manutenção de um registro, foi criado o campo Categoria da Manifestação para relacionar essa informação com o Motivo de Atendimento do Gestão de Planos. As opções de preenchimento, listadas abaixo, são oriundas do domínio da Unimed do Brasil e dependentes do preenchimento do campo Categoria de Atendimento, pois varia conforme o Tipo de Manifestação.

1. Se Tipo da Manifestação = 1, 2, 3, 4:
   1. 1. Médicos Cooperados;
   2. 2. Hospitais/Clínicas Credenciadas;
   3. 3. Hospitais/ Clínicas Unimed;
   4. 4. Operadora.
2. Se Tipo da Manifestação = 5: 
   1. 5. Coberturas;
   2. 6. Carência;
   3. 7. Fatura.
3. Se Tipo da Manifestação = 6: 
   1. 8. Cancelamento de Plano;
   2. 9. Compra de Plano;
   3. 10. Alterações Cadastrais;
   4. 11. Estorno;
   5. 12. Posição de Pagamento;
   6. 13. IRPF;
   7. 14. Parcerias/Doações;
   8. 15. 2ª via de boleto;
   9. 16. Envio de Cartão;
   10. 17. Documentos;
   11. 18. Guia Médico;
   12. 19. Procedimento Médico.

Deve ser criado um Motivo de Atendimento para cada Categoria de Manifestação para que a criação de um chamado através de uma Solicitação de Protocolo recebida pelo web service seja efetuada corretamente. Esses Motivos de Atendimento deve estar associados ao Grupo de Atendimento cadastrado para receber chamados do web service.

Manter Configuração de Atendimento (ConfigAttentionView)

Implementada a nova aba "Integração AT" que define as parametrizações para criar chamados automaticamente através da digitação de guias (AT0110Z) no módulo AT. Somente serão criados chamados no MR através do AT se existir uma parametrização válida para algum grupo de atendimento. No exemplo da imagem abaixo, para uma guia digitada no AT com o Tipo de Guia "31 - CONSULTA WAC", será criado um chamado no MR com o Motivo de Atendimento "Autorizacao de Exames", Categoria de Atendimento "Autorizacao - Solicitação" e Prioridade Alta. O grupo desse chamado é definido no programa Parâmetros Marketing Receptivo.

A função de Adicionar e Alterar permite configurar os seguintes atributos:

1. Tipo de Guia:
   1. Definir para qual Tipo de Guia essa regra vale, isto é, ao digitar uma guia no AT e o existir uma parametrização válida com o mesmo Tipo de Guia, o sistema irá criar o chamado no MR para esse Grupo com o restante das configurações;
2. Motivo de Atendimento:
   1. Definir qual o motivo de atendimento do MR deve ser usado para criar o chamado. Somente são permitidos os Motivos de Atendimento cadastrados para o Grupo de Atendimento que está em sendo manutenido;
3. Categoria:
   1. Campo meramente informativo para ilustrar a categoria associada ao motivo de atendimento selecionado;
4. Prioridade:
   1. Definir a prioridade com a qual o chamado será aberto;
5. Vigência:
   1. Período em que essa regra estará ativa, esses campos são considerados para identificar se a parametrização está válida.

Procedimento para Utilização

Os serviços de Solicitar Protocolo e Complementar Protocolo são os únicos que funcionam sem a integração entre os módulos AT e MR, os outros serviços somente funcionam através do MR.