Linha de Produto: | Datasul | ||||||||||||||
Segmento: | Saúde | ||||||||||||||
Módulo: | Gestão de Planos | ||||||||||||||
Rotina: |
| ||||||||||||||
Chamados Relacionados | TUROPV | ||||||||||||||
País(es): | Brasil | ||||||||||||||
Banco(s) de Dados: | Oracle® / Progress® / SQL Server® |
No Foundation Saúde foram implementados os web services para atender a RN 395 da ANS de acordo com os schemas definidos no sistema de Gestão de Protocolos pela Unimed do Brasil. Os novos serviços são integrados ao módulo MR, Marketing Receptivo, do Gestão de Planos, embora os serviços de Solicitar e Complementar Protocolo também estejam integrados com o módulo AT, atendimento ao público. Este projeto contempla a integração entre os módulos AT e MR.
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).
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)
Manter Parâmetros Marketing Receptivo (HMRParametersView)
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:
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.
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 vínculos entre o grupo de atendimento e Tipos de Guias do AT, com o objetivo de criar chamados automaticamente durante a digitação de guias (AT0110Z) do módulo AT. A digitação de guia no AT somente irá criar um chamado no MR se:
A função de Adicionar e Alterar permite configurar os seguintes atributos:
Os serviços do web service foram implementados da seguinte maneira:
A seguir os detalhes da utilização das novas funções.
Manutenção Autorização Guias (AT0110z)
Solicitar protocolo de atendimento
Ao autorizar uma nova guia, existem as seguintes possibilidades:
Observação 1: Foi incluído o campo DDD na tela de atualização de informações do beneficiário em intercâmbio. Essa informação, assim como o número do Telefone são exigidas pelo serviço de Solicitar Protocolo.
Observação 2: Caso ocorra algum erro na solicitação do protocolo via web service, o sistema permitirá que o usuário informe manualmente ou solicite posteriormente o número do protocolo.
A criação automática do chamado no MR ocorre somente na geração automática, para os beneficiários da base, ou com o protocolo recebido através do web service, para os beneficiários de intercâmbio. Tal criação será efetuada de acordo com as seguintes regras:
Complementar protocolo de atendimento
Nas funções da autorização de guias, foi adicionado o botão "Inf/Compl. Protocolo", que abre a seguinte tela:
Ao informar o ano e número da guia, o sistema permitirá:
Manter Chamados de Atendimento (callView)
Este programa foi integrado aos serviços do sistema de Gestão de Protocolos da Unimed do Brasil, sendo a principal ferramenta de trabalho para utilização desses serviços. Nesse sentido, os chamados do MR ganharam uma conotação de chamado externo, quando o chamado for criado através de uma Solicitação de Protocolo recebida ou enviada, pois se entende que as movimentações desse atendimento podem ser enviadas e consultadas através dos serviços do Gestão de Protocolos.
As seções a seguir descrevem o uso dos novos serviços bem como as adaptações necessárias.
Geração do número de protocolo
A partir desta implementação, o protocolo passa a ser gerado somente após a seleção do Solicitante do chamado, exceto quando o solicitante é um beneficiário em intercâmbio, mas este caso será detalhado na seção que detalha o serviço de solicitação de protocolo. Até que essa etapa não seja concluída, o cabeçalho exibirá o texto "Carregando".
Solicitar Protocolo de Atendimento
O serviço de Solicitar Protocolo de Atendimento será invocado automaticamente na finalização da criação do chamado somente quando o solicitante do chamado for um beneficiário em intercâmbio. Nesse caso, o cabeçalho irá exibir a mensagem de "Carregando" até que o chamado seja criado com sucesso com o número do protocolo resultante do serviço. Para executar essa operação, siga os passos abaixo:
Na tela principal do chamado, clique no botão Adicionar.
Selecione a opção Outros e em seguida a opção Beneficiário de Intercâmbio. A tela abaixo será exibida.
Informar o número da Unidade do beneficiário e sua Carteira. Se o beneficiário já possui cadastro na unidade, a tela irá exibir as suas informações, caso contrário permitirá que o cadastro seja efetuado. Após finalizar de inserir as informações clique em Salvar para gravar as informações e escolher o beneficiário em intercâmbio como solicitante do chamado.
Observação: Foi incluído o campo DDD na aba Endereço. Essa informação, assim como o número do Telefone são exigidas pelo serviço de Solicitar Protocolo.
Após definir o solicitante do chamado, continuar o fluxo da criação do chamado normalmente até a etapa abaixo.
Configurar o restante das informações e clicar no botão Salvar. O sistema irá carregar invocar o serviço de Solicitar Protocolo e, com o número retornado, gravar o chamado.
Observação 1: Nessa tela foi incluído o novo campo Sentimento do Cliente, que é referente ao campo homônimo opcional definido no serviço de Solicitar Protocolo. Além disso, as informações da Categoria de Atendimento e Motivo do Atendimento são utilizadas para enviar os dados do Tipo de Manifestação e Categoria da Manifestação, conforme as associativas descritas na seção da configuração. Tais informações são obrigatórias na mensagem de solicitação de protocolo.
Observação 2: Caso ocorra algum erro na solicitação do protocolo, o sistema permitirá que o usuário informe manualmente o número do protocolo.
Receber Solicitação de Protocolo
Ao receber uma nova solicitação de protocolo, o sistema identifica se o código do beneficiário recebido existe e se trata de um beneficiário ativo. Caso o código esteja correto, o sistema gera um número de protocolo, grava um novo chamado, com o mesmo número, e retorna o protocolo. Caso contrário, retorna um erro para o solicitante.
A criação do chamado depende das parametrizações descritas na configuração dos parâmetros do MR, onde o chamado será direcionado para o grupo configurado no campo Grupo de atendimento responsável pelo Web Service, e o usuário configurado no campo Usuário responsável pelo Web Service, se existir algum, será o responsável pelo novo chamado. O sistema irá configurar automaticamente no chamado a Categoria e o Motivo de Atendimento, de acordo com o Tipo de Manifestação e Categoria da Manifestação informados na solicitação, através das associativas descritas nesta seção da configuração.
Solicitar e Receber Resposta de Atendimento
O serviço de Responder foi incorporado à função Responder já existente no MR, de modo quando o usuário criar uma interação de resposta em um chamado externo, o sistema irá invocar este serviço informando o texto da resposta. Somente será gravado a resposta no chamado se o o retorno do serviço for uma confirmação do recebimento.
De forma análoga, ao receber a resposta de um atendimento, o sistema irá gravar a movimentação de resposta no chamado referente ao protocolo informado.
Observação: Ao solucionar um chamado externo, o sistema irá invocar este serviço informando o campo "ID Resposta"como "3 - Finalizado", e também só irá gravar a solução caso o retorno do serviço seja de confirmação.
Solicitar e Receber Cancelamento de Atendimento
O serviço de Cancelar foi incorporado à função Cancelar já existente no MR, de modo quando o usuário efetuar uma operação de cancelamento em um chamado externo, o sistema irá invocar este serviço informando o texto do cancelamento. Somente será gravado o cancelamento do chamado se o o retorno do serviço for uma confirmação do recebimento.
De forma análoga, ao receber o cancelamento de um atendimento, o sistema irá cancelar o chamado referente ao protocolo informado.
Solicitar Encaminhamento de Execução
Para encaminhar a execução de um chamado, deve-se clicar na opção WS - Gestão de Protocolos e em seguida em Encaminhar Execução. O sistema irá invocar o respectivo serviço caso o beneficiário solicitante do chamado tem um repasse ativo, utilizando a Unidade de Destino de Atendimento do beneficiário como o destino do solicitação. A confirmação dessa ação irá gravar uma sequência de Resposta no chamado e não permitirá que outro envio.
Importante: Essa ação não irá gerar nenhuma sequência de Encaminhamento no chamado, que só é criada quando o chamado é encaminhado para Grupos de Atendimento de Back-Office.
Receber Solicitação de Encaminhar Execução
Quando o sistema receber uma solicitação encaminhando a execução de um atendimento, o sistema irá validar se o beneficiário da mensagem está repassado para a unidade e, caso esteja, irá gerar um novo chamado no MR utilizando as mesmas regras que a criação de chamados da Solicitação de Protocolos.
Receber e Consultar Status do Protocolo
Para efetuar essa consulta, deve-se clicar na opção WS - Gestão de Protocolos e em seguida em Consultar Protocolo. Caso o chamado selecionado para a consulta seja externo, o sistema irá automaticamente disparar uma consulta para a Unimed solicitante do protocolo e exibirá os resultados em tela.
Ao receber uma solicitação de consulta, o sistema retorna os dados do chamado junto com as informações das sequências de Abertura, Respostas, Solução e Cancelamento. Outros tipos de sequência são ignorados.
Receber e Consultar Histórico do Protocolo
Para efetuar essa consulta, deve-se clicar na opção WS - Gestão de Protocolos e em seguida em Consultar Histórico. Caso o chamado selecionado para a consulta seja externo, o sistema irá abrir a tela de consulta, permitindo que o usuário informe o período desejado e dispare uma consulta para a Unimed solicitante do protocolo e exibirá os resultados em tela.
Ao receber uma solicitação de consulta, o sistema retorna os dados dos chamados referentes ao beneficiário solicitado.