Histórico da Página
Transferência de beneficiário de contrato e/ou subcontrato
Características do Requisito
Linha de Produto: | Microsiga Protheus | ||||
Segmento: | Saúde | ||||
Módulo: | Plano de Saúde | ||||
Rotina: |
| ||||
País(es): | Brasil | ||||
Banco(s) de Dados: | Todos relacionais | ||||
Tabelas Utilizadas: | BQQ, BQT | ||||
Sistema(s) Operacional(is): | Windows/Linux® |
Descrição
Implementada nova funcionalidade na rotina de transferência de beneficiários, onde será possível transferir os beneficiários de determinada família para outro contrato e/ou subcontrato. Está funcionalidade depende da alteração do campo "Atu. Con/Sub" (BQQ_CONSUB) para o valor "1=Sim", desta forma a tela da de rotina de transferência terá um novo comportamento para atender a esse tipo de transferência.
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:
- No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A).
- 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.
- 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;
- 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).
- Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
- Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
- 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!
- 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 ___/___/____.
- 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.
Também criamos uma rotina de histórico onde poderá ser visualizado as informações de transferência.
Atualizações do Dicionário
1. Criação de tabela no arquivo SX2– Tabelas:
Chave | Nome | Modo | PYME |
BQT (X2_CHAVE) | Hist. Transf. ontrato/Subcont (X2_NOME) | C (X2_MODO) | N (X2_PYME) |
2. Criação/Alteração de Campos no arquivo SX3 – Campos:
- Tabela BQT - Hist. Transf. Contrato/Subcont:
Campo | BQT_FILIAL |
Tipo | Carácter |
Tamanho | 8 |
Formato | @! |
Título | Filial |
Descrição | Filial |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help |
Campo | BQT_MATVID |
Tipo | Carácter |
Tamanho | 8 |
Título | Matric. Vida |
Descrição | Matrícula da vida |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Visual |
Contexto | Real |
Help | Matrícula da vida do beneficiário transferido. |
Campo | BQT_MATRIC |
Tipo | Carácter |
Tamanho | 17 |
Título | Matrícula |
Descrição | Matrícula do beneficiário |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Help | Matrícula do beneficiário transferido. |
Campo | BQT_NOME |
Tipo | Carácter |
Tamanho | 50 |
Título | nome Benef. |
Descrição | Nome do beneficiário |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Visual |
Contexto | Visual |
Relação | POSICIONE( "BA1", 2, XFILIAL("BA1") + BQT_MATRIC, "BA1_NOMUSR" ) |
Ini. Browser | POSICIONE( "BA1", 2, XFILIAL("BA1") + BQT_MATRIC, "BA1_NOMUSR" ) |
Help | Nome do beneficiário transferido. |
Campo | BQT_CONORI |
Tipo | Carácter |
Tamanho | 12 |
Título | Cont. Origem |
Descrição | Contrato origem |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Help | Contrato de origem. |
Campo | BQT_CONDES |
Tipo | Carácter |
Tamanho | 12 |
Título | Con. Destino |
Descrição | Contrato destino |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Help | Contrato de destino. |
Campo | BQT_VCOORI |
Tipo | Carácter |
Tamanho | 3 |
Título | Ver.Con.Orig |
Descrição | Versão contrato origem |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Help | Versão do contrato de origem. |
Campo | BQT_VCODES |
Tipo | Carácter |
Tamanho | 3 |
Título | Ver.Con.Dest |
Descrição | Versão contrato destino |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Help | Versão do contrato de destino. |
Campo | BQT_SUBORI |
Tipo | Carácter |
Tamanho | 9 |
Título | SubCon. Orig |
Descrição | Subcontrato origem |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Help | Subcontrato de origem. |
Campo | BQT_SUBDES |
Tipo | Carácter |
Tamanho | 9 |
Título | Sub. Destino |
Descrição | Subcontrato destino |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Help | Subcontrato de destino. |
Campo | BQT_VRSORI |
Tipo | Carácter |
Tamanho | 3 |
Título | Ver. Sb. ori |
Descrição | versão subcontrato |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Help | Versão do subcontrato de origem. |
Campo | BQT_VRSDES |
Tipo | Carácter |
Tamanho | 3 |
Título | Ver. Sb. Des |
Descrição | Vesão subcon. destino |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Help | Versão do subcontrato de destino. |
Campo | BQT_DTRANS |
Tipo | Data |
Tamanho | 8 |
Título | Dat. Tansfe. |
Descrição | Data de transferência |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Help | Data da transferência do beneficiário. |
Campo | BQT_HORA |
Tipo | Carácter |
Tamanho | 5 |
Título | Hora transf. |
Descrição | Hora da transferência |
Formato | 99:99 |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Help | Hora da transferência do beneficiário. |
Campo | BQT_CDOPER |
Tipo | Carácter |
Tamanho | 6 |
Título | Cd. Operador |
Descrição | código do operador |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Help | Código do usuário do sistema que realizou a transferência. |
Campo | BQT_NOMUSU |
Tipo | Carácter |
Tamanho | 50 |
Título | Nme. Oper. |
Descrição | Nome do operador |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Visual |
Contexto | Visual |
Relação | UsrRetName( BQT->BQT_CDOPER ) |
Ini. Browser | UsrRetName( BQT->BQT_CDOPER ) |
Help | Nome do usuário do sistema que realizou a transferência. |
- TabelaBQQ - Lote de transferência de beneficiário
Campo | BQQ_CONSUB |
Tipo | Carácter |
Tamanho | 1 |
Título | Atu. Con/Sub |
Descrição | Atualiza Contrato/SUbcont |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Visual | Altera |
Contexto | Real |
Relação | 0=Não;1=Sim |
Help | Com o valor "1=Sim" o sistema irá alterar apenas o contrato e/ou subcontrato da família. Não vai gerar uma nova família e nem bloquear a família atual. |
Campo | BQQ_VCOORI |
Visual | Visual |
Campo | BQQ_VCODES |
Visual | Visual |
Campo | BQQ_VRSORI |
Visual | Visual |
Campo | BQQ_VRSDES |
Visual | Visual |
Campo | BQQ_EMPDES |
When | M->BQQ_CONSUB != "1" |
Campo | BQQ_FAMDES |
When | M->BQQ_CONSUB != "1" |
Campo | BQQ_TODOS |
When | (EMPTY(M->BQQ_FAMDES) .AND. M->BQQ_CONSUB != "1") |
Campo | BQQ_CARENC |
When | M->BQQ_CONSUB != "1" |
Campo | BQQ_CPTORI |
When | M->BQQ_CONSUB != "1" |
Campo | BQQ_INCORI |
When | M->BQQ_CONSUB != "1" |
Campo | BQQ_DATINC |
When | M->BQQ_INCORI = '0' .AND. M->BQQ_CONSUB != "1" |
Campo | BQQ_DATEXC |
When | M->BQQ_CONSUB != "1" |
Campo | BQQ_MOTBLO |
When | M->BQQ_CONSUB != "1" |
Campo | BQQ_CODPRO |
When | M->BQQ_CONSUB != "1" |
Campo | BQQ_VRSPRO |
When | M->BQQ_CONSUB != "1" |
Campo | BQQ_PROORI |
When | M->BQQ_CONSUB != "1" |
Campo | BQQ_GRPCOB |
When | M->BQQ_CONSUB != "1" |
Campo | BQQ_CODCCO |
When | M->BQQ_CONSUB != "1" |
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.
53. Criação ou Alteração de de Consulta Padrão no arquivo SXB – Consulta Padrão:
- Pesquisa B05PLSBQCPLS (inclusão de linha):
Alias | (XB_ALIAS)BQCPLS |
Tipo | (XB_TIPO)5 |
Sequência | (XB_SEQ)02 |
Coluna | 02 |
Contém | (XB_COLUNA) |
Descrição | (XB_DESCRI) |
Contém | (XB_CONTEM) |
BQC->BQC_VERSUB |
- Pesquisa BQRPLS (inclusão de linha):
Alias | BQRPLS |
Tipo | 5 |
Sequência | 02 |
Coluna | 02 |
Contém | BQC->BQC_VERSUB |
4. Criação 6. Criação ou Alteração de Índices no arquivo SIX – Índices:
Índice | AA1BQT |
Ordem | 61 |
Chave | AA1BQT_FILIAL + AA1BQT_CODVENMATVID |
DescriçãoCod. Vendedor | Filial + Matrícula da vida |
Proprietário | S |
7. Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:
Índice | BQT |
Ordem | 2 |
Chave | BQT_FILIAL + BQT_MATRIC |
Descrição | Filial + Matrícula do beneficiário |
Proprietário | S |
5. Criação
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édicasBQQ – Lote de transferência de beneficiário:
Campo | Informe o conteúdo do (X7_CAMPO)BQQ_EMPORI |
Sequência | Informe o conteúdo do (X7_SEQUENC)002 |
Campo Domínio | Informe o conteúdo do (X7_CDOMIN)BQQ_EMPDES |
Tipo | Informe o conteúdo do (X7_TIPO)P |
RegraInforme o conteúdo do (X7_REGRA) | M->BQQ_EMPORI |
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
N | |
Condição | M->BQQ_CONSUB == "1" |
Campo | BQQ_EMPORI |
Sequência | 003 |
Campo Domínio | BQQ_DEMDES |
Tipo | P |
Regra | BG9->BG9_DESCRI |
Posiciona? | S |
Chave | xFilial("BG9")+M->BQQ_CODINT+M->BQQ_EMPORI |
Condição | M->BQQ_CONSUB == "1" |
Campo | BQQ_FAMORI |
Sequência | 002 |
Campo Domínio | BQQ_FAMDES |
Tipo | P |
Regra | M->BQQ_FAMORI |
Posiciona? | N |
Condição | M->BQQ_CONSUB == "1" |
Campo | BQQ_CONSUB |
Sequência | 001 |
Campo Domínio | BQQ_FAMDES |
Tipo | P |
Regra | M->BQQ_FAMORI |
Posiciona? | N |
Condição | M->BQQ_CONSUB == "1" |
Procedimento para Utilização
- Transferindo um beneficiário de subcontrato dentro do mesmo contrato
- Acesse Atualizações > Contrato/Família > Transferências.
- Clique no botão Incluir.
- Altere o campo "Atu. Con/Sub" (BQQ_CONSUB) para "1=Sim".
- Preencha os campos habilitados para edição.
- Após preencher as informações clique em Salvar.
- Histórico de transferência de contrato/Subcontrato
- Acesse Atualizações > Contrato/Família > Grupo familiar / Beneficiários
- Efetue o filtro (Pessoa jurídica, pessoa física ou pesquisar).
- Posicione no beneficiário que deseja visualizar o histórico.
- Clique em Outras Ações > Hist. Transf. Cont. e Subcon.
- Serão exibidos os detalhes das transferências realizadas de todos os beneficiários da família.
- Clicando em visualizar.
Importante
Apenas uma família é transferida por lote de transferência.
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.
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