Histórico da Página
Controle de Validade na Solicitação de Exames já Realizados e/ou Solicitados
Características do Requisito
Linha de Produto: | Datasul | ||||||||||||||||||
Segmento: | Saúde | ||||||||||||||||||
Módulo: | Gestão de Planos de Saúde | ||||||||||||||||||
Rotina: |
| ||||||||||||||||||
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). | ||||||||||||||||||
Manutenção Validades de Procedimentos; Manutenção de Justificativas de Autorizacao de Procedimentos; Relatorio de Autorizações Mediante Justificativa; Manutenção Classe de Erro; Manutenção Glosa | |||||||||||||||||||
Configurações necessárias: | Para ativar o processo no Autorizador Web, é necessário incluir a seguinte propriedade com.totvs.saude.proceduresolicitation.examinationValityAlert como true. | ||||||||||||||||||
Chamados relacionados: | TTHSBN;TRFES0;TSEUGP;TSB164;TRMQA2 | Requisito (ISSUE): | Informe o requisito relacionado (Issue).|||||||||||||||||
País(es): | Informe o(s) Pais(es)Brasil. | ||||||||||||||||||
Banco(s) de Dados: | Informe o(s) Banco(s) de Dados utilizado(s)Progress® / Oracle®. | ||||||||||||||||||
Tabelas utilizadas: | Informe as tabelas utilizadas.VALID_PROCED; JUSTIF_AUTORIZ_PROCED | ||||||||||||||||||
Sistema(s) operacional(is): | Informe o(s) sistema(s) operacional(is) utilizadosTodos. | ||||||||||||||||||
Versões/Release: | Informe as versões.12.1.9 |
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:
Contate o Help Desk Framework EM CASO DE DÚVIDAS! |
---|
- Em Microsiga Protheus TOTVS Smart Client (se versão 10) ou ByYou Smart Client (se versão 11), digite informe 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 ___/___/____.
- Clique em OK para continuar.
- 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().
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - 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.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
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.
- Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
- 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)
- 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
- 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. |
Foram criados os seguintes controles:
- Controle de validade de procedimentos (exames), de modo a alertar e solicitar justificativa quando o usuário tentar Autorizar um procedimento que já tenha sido realizado pelo beneficiário da base (não se aplica para intercâmbio) dentro de um período de validade configurável.
- Controle de alerta e solicitação de justificativa quando o usuário tenta Autorizar um procedimento que já possua Autorização em aberto (Autorizada ou Pendente de Autorização pela Operadora), independente do período.
Procedimento para Implantação
A Implementação descrita no documento, será realizada a partir da atualização do pacote do cliente.
O pacote está disponível no portal (https://suporte.totvs.com/download).
Importante:
Antes de executar a atualização é recomendável realizar o backup do banco de dados bem como dos arquivos do Sistema (executáveis,
.dlls e arquivos de configuração).
Realizar a atualização antes no ambiente de homologação e posterior a devida validação, no ambiente de produção.
Atenção: o arquivo database/dados/claserro.d presente neste pacote deve ser importado através da opção de menu do TOTVS12 “Importação Classes Erro”.
Procedimento para Utilização
Parametrização inicial:
- Cadastrar validade dos procedimentos
- Acesse Manutenção Validades de Procedimentos (PR0410E).
- Configure os procedimentos para os quais é desejado realizar o controle de validade de utilização:
Campos do cadastro:
- Modalidade, Plano e Tipo de Plano: identificar a estrutura de produto para a qual o controle deve ser realizado. Esses campos podem ficar zerados, de modo a representar TODOS os Tipos de Planos, Planos e Modalidades, nessa ordem.
- Módulo: identificar para qual módulo o controle de validade deve ser realizado. Esse campo é de informação obrigatória. Com essa parametrização é possível, por exemplo, parametrizar o que deve ser controlado no módulo de Exames mas não deve ser controlado no módulo de Internações.
- Procedimento: informar o procedimento (exame) para o qual deve ser realizado o controle. Preenchimento obrigatório.
- Limite: data limite para aplicação da regra. Caso o usuário esteja tentando autorizar o procedimento após a data informada nesse campo, a regra de validação é ignorada.
- Dias de validade: informar o número de dias em que o controle deve ser realizado. Por exemplo, se estiver parametrizado 99 dias, o beneficiário já tenha realizado o mesmo procedimento há 90 dias e o usuário estiver solicitando autorização da realização do mesmo procedimento, então a regra será aplicada. Já se a realização anterior ocorreu há 100 dias, então a regra não será aplicada.
- Validade Ativa? Indicador para habilitar/desabilitar a regra. Caso esse indicador estiver desmarcado, então a regra não será aplicada, mesmo que a data Limite ainda esteja válida.
O programa possibilita também opção de geração de registros em lote, através do botão Gerar:
2. Cadastrar as Justificativas para Solicitação de Procedimentos
- Acesse Manutenção de Justificativas de Autorizacao de Procedimentos (PR0410F).
- Crie as justificativas que ficarão disponíveis na tela do usuário no momento que tentar autorizar procedimentos que entrarem na regra da opção Manutenção Validades de Procedimentos:
- Campos do cadastro:
- Código: código sequencial da mensagem. É gerado automaticamente pelo programa a cada mensagem criada.
- Descrição da mensagem que aparecerá no momento da autorização, em uma lista para seleção do usuário (processo explicado adiante).
- Possui Autorização em Aberto? Se no momento da solicitação for identificado que o beneficiário já possui uma Solicitação em Aberto (autorizada ou pendente de autorização, independente da data da sua solicitação), então mensagens com esse indicador ativo serão exibidas.
- Realizou Procedimento Dentro da Validade? Se no momento da solicitação for identificado que o beneficiário já realizou o mesmo procedimento (conforme regra da opção Manutenção Validades de Procedimentos), então mensagens com esse indicador ativo serão exibidas.
- Justificativa Ativa: somente mensagens com esse indicador ativo serão exibidas no momento da solicitação.
3. Configurar as novas classes de erro
Para esse novo processo foram criadas 2 novas classes de erro (Manutenção Classe de Erro):
- 147 – PROCED. ENCONTRADO EM OUTRA GUIA MESMO SOLICITANTE: será utilizada quando for identificado que o mesmo beneficiário já possui outra Guia de Autorização em aberto (Autorizada ou Pendente de Auditoria) e que tenha sido solicitada pelo mesmo Prestador Solicitante.
- 155 – PROCED. ENCONTRADO EM OUTRA GUIA DIF. SOLICITANTE: será utilizada quando for identificado que o mesmo beneficiário já possui outra Guia de Autorização em aberto (Autorizada ou Pendente de Auditoria) e que tenha sido solicitada por outro Prestador Solicitante.
Para ambas as Classes de Erro, o sistema somente sofrerá mudança de comportamento caso sejam configuradas as glosas correspondentes (Manutenção Glosa) e a Ação Esperada da Classe de Erro for diferente de Não Gera Glosa.
Processos:
Fluxo do Processo
- Processo 1 – tentativa de autorizar um procedimento através da opção Manutenção Autorização Guias do menu do TOTVS12, sendo que o beneficiário já possui guia em aberto para o mesmo procedimento:
- Caso a classe de erro correspondente tiver sua Ação Esperada configurada como Gera Glosa, então será apresentada a tela abaixo com a lista de justificativas correspondentes, previamente cadastradas através da opção Manutenção de Justificativas de Autorização de Procedimentos:
- Selecione uma justificativa, opcionalmente poderá preencher o campo de observações.
- Além de registrar a justificativa, o sistema registrará também a glosa correspondente.
- Caso a classe de erro tiver sua Ação Esperada configurada como Restringe Movimento, então a justificativa não será solicitada. Será apresentada mensagem de erro e não será possível continuar com a solicitação. Lembrando que as classes de erro que podem retornar desse processo são:
- 147 – PROCED. ENCONTRADO EM OUTRA GUIA MESMO SOLICITANTE: será utilizada quando for identificado que o mesmo beneficiário já possui outra Guia de Autorização em aberto (Autorizada ou Pendente de Auditoria) e que tenha sido solicitada pelo mesmo Prestador Solicitante.
- 155 – PROCED. ENCONTRADO EM OUTRA GUIA DIF. SOLICITANTE: será utilizada quando for identificado que o mesmo beneficiário já possui outra Guia de Autorização em aberto (Autorizada ou Pendente de Auditoria) e que tenha sido solicitada por outro Prestador Solicitante.
Importante: A regra somente será considerada caso essas classes de erro possuam glosa associada, na opção Manutenção Glosa.
- Processo 2 – tentativa de autorizar um procedimento através da opção Solicita Exames do menu do Autorizador Web, sendo que o beneficiário já possui guia em aberto para o mesmo procedimento (aplica-se a mesma regra explicada no processo 1):
Caso a classe de erro correspondente tiver sua Ação Esperada configurada como Gera Glosa, então será apresentada a tela abaixo com a lista de justificativas correspondentes, previamente cadastradas através da opção Manutenção de Justificativas de Autorização de Procedimentos:
- Selecione uma justificativa, opcionalmente poderá preencher o campo de observações.
- Além de registrar a justificativa, o sistema registrará também a glosa correspondente.
- Caso a classe de erro tiver sua Ação Esperada configurada como Restringe Movimento, então a justificativa não será solicitada. Será apresentada mensagem de erro e não será possível continuar com a solicitação. Lembrando que as classes de erro que podem retornar desse processo são:
- 147 – PROCED. ENCONTRADO EM OUTRA GUIA MESMO SOLICITANTE: será utilizada quando for identificado que o mesmo beneficiário já possui outra Guia de Autorização em aberto (Autorizada ou Pendente de Auditoria) e que tenha sido solicitada pelo mesmo Prestador Solicitante.
- 155 – PROCED. ENCONTRADO EM OUTRA GUIA DIF. SOLICITANTE: será utilizada quando for identificado que o mesmo beneficiário já possui outra Guia de Autorização em aberto (Autorizada ou Pendente de Auditoria) e que tenha sido solicitada por outro Prestador Solicitante.
Importante: A regra somente será considerada caso essas classes de erro possuam glosa associada, na opção Manutenção Glosa.
- Processo 3 – tentativa de autorizar um procedimento através da opção Manutenção Autorização Guias do menu do TOTVS12, sendo que o beneficiário já realizou esse mesmo procedimento dentro da validade parametrizada na opção Manutenção Validades de Procedimentos:
- Para esse caso não há classes de erros envolvidas. Não ocorrerão restrições, mas o usuário será obrigado a informar uma justificativa, que ficará registrada na guia.
- Será exibida uma tela informando que já existe realização anterior do mesmo procedimento:
- Se o usuário continuar, é exibida a tela a seguir para que o usuário informe a justificativa para estar solicitando nova realização de um procedimento que já foi realizado dentro da validade parametrizada. Opcionalmente pode ser informada uma observação:
- Após esse passo, o processo de criação da guia de autorização continua normalmente.
- Processo 4 – tentativa de autorizar um procedimento através da opção Solicita Exames do menu do Autorizador Web, sendo que o beneficiário já realizou esse mesmo procedimento dentro da validade parametrizada na opção Manutenção Validades de Procedimentos (aplica-se a mesma regra explicada no processo 3):
- Para esse caso não há classes de erros envolvidas. Não ocorrerão restrições, mas o usuário será obrigado a informar uma justificativa, que ficará registrada na guia.
- Será exibida uma tela solicitando que o usuário justifique o motivo de estar solicitando a realização desse procedimento sendo que o mesmo já foi realizado dentro da validade.
- A tela lista todos os procedimentos solicitados na guia, a coluna Status mostra os que estão Ok e os que precisam ser Justificados.
- Caso a coluna Doc. Ant. possuir o ícone, significa que existe Realização anterior do procedimento dentro da validade. Ao clicar nesse ícone são exibidos detalhes.
- Caso a coluna Guia Ant. possuir o ícone, então existe Guia em aberto solicitando a realização do mesmo procedimento (a guia pode estar já autorizada ou pendente de autorização pela operadora).
- A coluna Justificativa abre a lista de justificativas previamente cadastradas na opção Manutenção de Justificativas de Autorização de Procedimentos, sendo que seu preenchimento é obrigatório, e o ícone Obs. possibilita abrir uma tela para informar uma observação complementar da justificativa:
(tela aberta ao clicar no ícone Doc.Ant)
(tela aberta ao clicar no ícone Obs)
(mensagem exibida caso o usuário tente autorizar sem informar uma justificativa)
Após esse passo, o processo de criação da guia de autorização continua normalmente.
- Processo 5 – gerar relatório das autorizações realizadas mediante justificativa:
- Acesse o Relatório de Procedimentos Autorizados Mediante Justificativa.
- Seu objetivo é gerar um relatório com as Autorizações Solicitadas em que o sistema tenha aplicado as validações explicadas nos processos 1, 2, 3 e 4.
- Exemplo do relatório gerado, exibindo a solicitação anterior (previamente existente) e a atual com a justificativa e observações preenchidas pelo prestador.
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: |
|
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