Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin
TUROPV_WEB_SERVICES_RN_

Web services RN 395

Características do Requisito

Linha de Produto:

Informe a linha de produto.Datasul

Segmento:

Informe o segmento.Saúde

Módulo:

Informe o módulo.Gestão de Planos de Saúde

Rotina:

Rotina

Nome Técnico

Informe a rotina.

Informe o nome técnico da rotina.

Rotina(s) envolvida(s)

Nome Técnico

Informe a(s) rotina(s) envolvidas.

Informe o nome técnico da(s) rotina(s) envolvidas.

 

 

Cadastros Iniciais:

Relacione os cadastros necessários que precisam ser preenchidos antes da utilização desse requisito.

Parâmetro(s):

Informe os parâmetros utilizados.

Ponto de Entrada:

Informe o ponto de entrada relacionado (link).

Chamados Relacionados

Informe o(s) chamado(s) relacionado(s).

Requisito (ISSUE): Informe o requisito relacionado (Issue).

País(es):

Informe o(s) Pais(es).

Banco(s) de Dados:

Informe o(s) Banco(s) de Dados utilizado(s).

Tabelas Utilizadas:

Informe as tabelas utilizadas.

Sistema(s) Operacional(is):

Informe o(s) sistema(s) operacional(is) utilizados.

Descrição

Escreva aqui a descrição da nova implementação ou melhoria.

 

Importante

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

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

 

Atenção

O procedimento a seguir deve ser realizado por um profissional   qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

A ativação indevida da Integridade Referencial pode alterar   drasticamente o relacionamento entre tabelas no banco de dados. Portanto,   antes de utilizá-la, observe atentamente os procedimentos a seguir:

  1. No   Configurador (SIGACFG), veja se a empresa utiliza Integridade   Referencial, selecionando a opção Integridade/Verificação   (APCFG60A).
  2. Se não   há Integridade Referencial ativa,   são relacionadas em uma nova janela todas as empresas e filiais cadastradas   para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário   qualquer outro procedimento de ativação   ou desativação de integridade, basta finalizar a verificação e aplicar   normalmente o compatibilizador, conforme instruções.
  3.  Se há Integridade Referencial ativa   em todas as empresas e filiais, é   exibida uma mensagem na janela Verificação   de relacionamento entre tabelas. Confirme a mensagem para que a   verificação seja concluída, ou;
  4.  Se   há Integridade Referencial ativa   em uma ou mais empresas, que não   na sua totalidade, são relacionadas em uma nova janela todas as empresas e   filiais cadastradas para o sistema e, somente, a(s) que possui(em)   integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou   filial(is) possui(em) a integridade ativada e reserve esta anotação para   posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework   para informações quanto a um arquivo que contém essa informação).
  5. Nestes   casos descritos nos itens “iii” ou   “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
  6.  Quando desativada a Integridade Referencial,   execute o compatibilizador, conforme instruções.
  7. Aplicado o compatibilizador, a Integridade   Referencial deve ser reativada, SE E   SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as   informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da   integridade, selecione-a(s) novamente e confirme a ativação.

 

Contate o Help Desk Framework EM CASO DE DÚVIDAS!

 

  1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador 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 ___/___/____.
  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().
  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.

  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:

Nome da Variável:

Informe o Nome da Variável

Tipo:

Informe o Tipo

Descrição:

Informe a Descrição

Valor Padrão:

Informe o Valor Padrão

 

 

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:

Pergunte

(X1_PERGUNT)

Nome

 

Grupo

(X1_GRUPO)

Ordem

(X1_ORDEM)

Tipo

(X1_TIPO)

Tamanho

(X1_TAMANHO)

 

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

Chave

Nome

Modo

PYME

B04

(X2_CHAVE)

Dente/Região

(X2_NOME)

C

(X2_MODO)

N

(X2_PYME)

 

3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

Chave

Ex.: AR

Descrição

Ex.: Tabela de IR de Aplicações Financeiras

 

4.  Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

  • Tabela BGD - Prod x Cob x Proc x Co-Part:

 

Campo

(X3_CAMPO)

Tipo

(X3_TIPO)

Tamanho

(X3_TAMANHO)

Decimal

(X3_DECIMAL)

Formato

(X3_PICTURE)

Título

(X3_TITULO)

Descrição

(X3_DESCRIC)

Nível

(X3_NÍVEL)

Usado

(X3_USADO) Informe Sim ou Não

Obrigatório

(X3_OBRIGAT) Informe Sim ou Não

Browse

(X3_BROWSE) Informe Sim ou Não

Opções

(X3_CBOX)

When

(X3_WHEN)

Relação

(X3_RELACAO)

Val. Sistema

(X3_VALID)

Help

Descreva o conteúdo informado para Help de Campo no ATUSX

 

Importante:

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

 

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

  • Pesquisa B05PLS:

Alias

(XB_ALIAS)

Tipo

(XB_TIPO)

Sequência

(XB_SEQ)

Coluna

(XB_COLUNA)

Descrição

(XB_DESCRI)

Contém

(XB_CONTEM)

 

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

Índice

AA1

Ordem

6

Chave

AA1_FILIAL+AA1_CODVEN

Descrição

Cod. Vendedor

Proprietário

S

 

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

Nome da Variável

(X6_VAR)

Tipo

(X6_TIPO)

Descrição

(X6_DESCRIC + X6_DESC1 + X6_DESC2)

Valor Padrão

(X6_CONTEUD)

 

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

  • Tabela BD5 – Contas Médicas:

Campo

Informe o conteúdo do (X7_CAMPO)

Sequência

Informe o conteúdo do (X7_SEQUENC)

Campo Domínio

Informe o conteúdo do (X7_CDOMIN)

Tipo

Informe o conteúdo do (X7_TIPO)

Regra

Informe o conteúdo do (X7_REGRA)

Posiciona?

Informe o conteúdo do (X7_SEEK)

Chave

Informe o conteúdo do (X7_CHAVE)

Condição

Informe o conteúdo do (X7_CONDIC)

Proprietário

Informe o conteúdo do (X7_PROPRI)

 

 

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)

Itens/Pastas

Descrição

Nome:

 

Tipo:

Informe o Tipo do parâmetro

Cont. Por.:

Informe o Conteúdo padrão

Descrição:

 

 

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:

Menu

Informe o Menu em que estará localizada a rotina

Submenu

Informe o Submenu em que estará localizada a rotina

Nome da Rotina

Informe o Título da rotina

Programa

Informe o Fonte da rotina

Módulo

Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”

Tipo

Informe a Função

 

 

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.

 

Título do Vídeo:

Disponibilizado pelo Marketing.

Introdução:

Disponibilizado pelo Marketing.

Passo a Passo:

Capturar diretamente do sistema.

Finalização:

Disponibilizado pelo Marketing.

 

 

Parametros Globais Sistema

pr1410p

Manter Parâmetros Marketing ReceptivohmrParametersView
Manter Categorias de AtendimentoCallCategoryView
Manter Configuração de AtendimentoConfigAttentionView
Manutenção Autorização Guiasat0110z
Manter Chamados de AtendimentoCallview

Chamados Relacionados

TUROPV

País(es):

Brasil

Banco(s) de Dados:

Oracle® / Progress® / SQL Server®

 


Descrição

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

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, que 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

Configurar a propriedade de "protocolmanager.webservices.timeout" para definir o tempo máximo, em milissegundos, que o "Foundation Saúde" irá esperar por uma resposta da Unimed do Brasil, até que encerre a comunicação e devolva uma inconsistência. Os valores possíveis variam de -1 ao infinito. Abaixo segue alguns exemplos de utilização.

  • "protocolmanager.webservices.timeout = -1":
    • O valor -1 indica tempo infinito de espera, isto é, o Foundation Saúde irá aguardar por uma resposta da Unimed do Brasil indefinidamente;
  • "protocolmanager.webservices.timeout = 9000":
    • Nesse caso o Foundation Saúde irá aguardar 9 segundos por uma resposta da Unimed do Brasil, após esse tempo irá encerrar a comunicação e devolver um erro de Time Out.

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

Âncora
configGPS
configGPS

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/".

Image Added

Âncora
parametrosMR
parametrosMR

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 por meio da digitação da guia no "AT";
  2. Usuário responsável pelo Web Service:
    1. Campo opcional para indicar qual será o usuário que é responsável pelos chamados que chegarem pela "Solicitação de Protocolo do Web Service", ou por meio da digitação da guia no "AT". Na ausência desse parâmetro, o chamado é criado com "Nenhum Responsável", e todos os atendentes do grupo podem visualizar a solicitação até que um usuário assuma.

Image Added

Âncora
configCategMR
configCategMR

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 por meio de uma "Solicitação de Protocolo", recebida pelo web service, seja efetuada corretamente.

Image Added


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", onde a criação de um chamado, por meio de uma "Solicitação de Protocolo", recebida pelo web service, seja efetuada corretamente. Esses "Motivos de Atendimento", devem estar associados ao "Grupo de Atendimento", cadastrado para receber chamados do web service.

Image Added

 

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 cria um chamado no "MR" se:

  • O usuário do sistema, que estiver digitando a guia, esta vinculado a algum grupo de SAC no "MR";
  • O grupo de SAC, da regra anterior, deve ter uma regra vigente para o tipo da guia.

Image Added

A funções de "Adicionar" e "Alterar", permitem 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", o sistema irá procurar, nos grupos de atendimento que o usuário pertence, por uma regra vigente cujo "Tipo de Guia", seja igual entre regra e guia digitada;
  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 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 esta ativa, esses campos são considerados para identificar se a parametrização está válida.

Image Added

Procedimento para Utilização

Os serviços do web service foram implementados da seguinte maneira:

  • Manutenção Autorização Guias - AT:
    • Solicitar protocolo durante a inclusão de uma guia, ou após a inclusão;
    • Complementar protocolo após a inclusão de uma guia;
    • Possibilidade de incluir chamados no "MR" automaticamente, na inclusão de uma guia;
  • Manter Chamados de Atendimento - MR:
    • Solicitar Protocolo na criação de chamados;
    • Responder Atendimentos na resposta ou solução de chamados;
    • Cancelar Atendimentos no cancelamento de chamados;
    • Consultar Histórico, Consultar Status e Encaminhar execução como funções extras;
    • Receber as mensagens do web service.

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:

  1. Beneficiários da base:
    1. o sistema considera o parâmetro "Numero Protocolo", do cadastro de tipos de guia (at0110a), para decidir se o campo do número do protocolo: 
      1. 0 - Não trata: ignora a informação na tela;
      2. 1 - Pede: solicita que o usuário informe o número do protocolo na tela;
      3. 2 - Obriga: solicita e obriga que o usuário informe o número do protocolo na tela;
      4. 3 - Automático: o sistema gera o número do protocolo e cria o chamado no "MR", caso exista parametrização de integração válida;
  2. Beneficiários em intercâmbio:
    1. o sistema considera o parâmetro "Integracao RN 395/Intercambio", dos parâmetros globais do sistema (pr1410p), para decidir se:
      1. 0 - Offline: o sistema ignora a informação do número do protocolo;
      2. 1 - Contingência: solicita que o usuário informe o número do protocolo na tela;
      3. 2 - Online: conecta com o "Foundation Saúde", para invocar o serviço de "Solicitar Protocolo de Atendimento", da Unimed do Brasil, conforme definido nos "Procedimentos de Configuração". Nessa opção o sistema irá criar o chamado no "MR", caso exista parametrização de integração válida;


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", é exigida pelo serviço de "Solicitar Protocolo". 

Image Added

Observação 2: Caso ocorra alguma inconsistência na solicitação do protocolo via web service, o sistema permite 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 por intermédio do web service, para os beneficiários de intercâmbio. Tal criação será efetuada de acordo com as seguintes regras:

  1. O usuário logado no sistema deve possuir um papel de SAC no "MR" (HDA ou HDS), e estar configurado como atendente ou supervisor em algum grupo de atendimento de SAC;
  2. O sistema irá procurar pelo primeiro grupo de atendimento de SAC, que o usuário pertença, e que contenha alguma regra de integração "AT x MR", vigente para o tipo da guia. O cadastro das regras foi descrito na seção de configurações do GPS;
  3. O chamado é criado no grupo encontrado e seu responsável será o usuário que incluiu a guia. Outras informações do chamado serão criadas como descrito a seguir:
    1. Motivo de Atendimento: oriundo da regra de integração encontrada;
    2. Prioridade: oriundo da regra de integração encontrada;
    3. Título e Descrição: texto fixo;
    4. Solicitante: beneficiário da guia incluída;

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:

Image Added

 

Ao informar o ano e número da guia, o sistema permitirá:

  • Caso a guia ainda não tenha número de protocolo, informar um número de protocolo, de acordo com a mesma regra da solicitação descrita acima;
  • Caso ainda não tenha sido enviado o complemento do protocolo com sucesso, enviar a mensagem de "Complementar Protocolo de Atendimento". Essa mensagem permite a associação do número de protocolo com a transação de intercâmbio do beneficiário.


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 

Âncora
chamadoExterno
chamadoExterno
chamado externo, quando o chamado for criado por meio de uma "Solicitação de Protocolo", recebida ou enviada, pois se entende que as movimentações desse atendimento podem ser enviadas e consultadas por intermédio 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".

Image Added

 

Âncora
solicitarProtocolo
solicitarProtocolo

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 exibe a mensagem de "Carregando", até que o chamado seja criado com sucesso e 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".

Image Added

 

Selecione a opção "Outros", em seguida a opção "Beneficiário de Intercâmbio". A tela abaixo será exibida.

 

Image Added

 

Informar o número da "Unidade" do beneficiário e sua "Carteira". Caso o beneficiário já possua cadastro na unidade, a tela exibe as suas informações, caso contrário permite que o cadastro seja efetuado. Após 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", é exigida pelo serviço de "Solicitar Protocolo".

Image Added

Após definir o solicitante do chamado, continue o fluxo da criação do chamado normalmente até a etapa abaixo.

Image Added

Configurar o restante das informações e clicar no botão "Salvar". O sistema carrega o serviço de "Solicitar Protocolo", e com o número retornado, salve 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 alguma inconsistência na solicitação do protocolo, o sistema permite que o usuário informe manualmente o número do protocolo.

Image Added

Âncora
recebeSolicProtoc
recebeSolicProtoc

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 cria de um novo chamado no MR e retorna o seu número do protocolo. Caso contrário, retorna uma inconsistência para o solicitante. 

A criação do chamado depende das parametrizações descritas na configuração dos parâmetros do MR, onde o chamado é 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 configura 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, por meio 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 invoca este serviço e informa o texto da resposta. Somente é 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 grava a movimentação de resposta no chamado referente ao protocolo informado.

Observação: Ao solucionar um chamado externo, o sistema invoca este serviço e informa o campo "ID Resposta"como "3 - Finalizado", também só grava 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 invoca este serviço e informa o texto do cancelamento. Somente é 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 cancela 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 invoca o respectivo serviço, caso o beneficiário solicitante do chamado, possuir 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 grava uma sequência de "Resposta" no chamado, e não permite outro envio.

Importante: Essa ação "não", gera 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 valida se o beneficiário da mensagem está repassado para a unidade e, caso esteja, gera 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, automaticamente, disparar uma consulta para a Unimed solicitante do protocolo e exibe 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 abre a tela de consulta, permite que o usuário informe o período desejado e dispare uma consulta para a Unimed solicitante do protocolo, após exibe os resultados em tela.

Ao receber uma solicitação de consulta, o sistema retorna os dados dos chamados referentes ao beneficiário solicitado.

Ponto de Entrada

Descrição:

Informe o Menu em que estará localizada a rotina

Localização:

Informe o Submenu em que estará localizada a rotina

Eventos:

Informe o Título da rotina

Programa Fonte:

Informe o Fonte da rotina

Função:

Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”

Retorno:

Nome

Tipo

Descrição

Obrigatório

 

 

 

 

 

 

 

 

 

 

 

 

 

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

Return aCab