Histórico da Página
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|
Informações Gerais
Especificação | |||
Produto | Microsiga Protheus | Módulo | SIGAPLS |
Segmento Executor | Saúde | ||
Chamado | TUTGMQ | ||
País | ( X ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. |
Objetivo
O DIOPS é o Documento de Informações Periódicas das Operadoras de Planos de Saúde, que devem ser enviados trimestralmente à ANS. As informações que compõem este documento são: quadros cadastrais, quadros financeiros, quadros gerenciais e informações gerais. O documento tem por objetivo fornecer condições para que a DIOPS (ANS) possa efetuar o controle, o monitoramento e o acompanhamento das operadoras.
A ANS verifica e valida o conteúdo desses arquivos através do seu site, no entanto, algumas ferramentas alguns softwares de terceiros estão disponíveis para execução dessa tarefa dessas tarefas de validação antes do envio , como o DIOPS X-Press. Com esta ferramenta, não é necessário submeter o XML ao site da ANS, permitindo que erros sejam corrigidos antes do envio à ANS.do XML para a ANS, permitindo redução de custos e tempos envolvidos no processo
Essa especificação contempla todas as informações necessárias para o desenvolvimento do relatório para preenchimento do quadro do quadro financeiro - Idade de Saldos - Receber no DIOPS X-Press, conforme estabelecido pela ANS.
Definição da Regra de Negócio
Premissa : para emissão do arquivo, as configurações contábeis devem estar configuradas. E o rastro da tabela CTL para gravar na CV3 cadastrado de acordo com os lançamentos padrões que serão utilizados.
Lançamentos Utilizados para Tabela BM1: 9A0 e 9A1. Deverá ser cadastrado no arquivo CTBA090 o rastreamento para esses lançamentos.
Lançamentos Utilizados para Reciprocidade assumida: 9CN e 9CM. Os rastreamentos já foram configurados na especificação:
TUTGB8_ER_DIOPS_INTERCÂMBIO_EVENTUAL
Para criação dos perguntes deverá ser considerada a especificação abaixo, caso já tenha sido criado o pergunte, deverá ser utilizado o mesmo PLSRDIPR:
TUTGPU_ER_DIOPS_IDADE_SALDOS_PAGAR.
- Criar Pergunte com o campo Data de Referência, para que seja possível localizar os títulos a partir desta data para trás, rastreando os títulos em abertos para sua classificação. O nome do Pergunte deve ser PLSRDIPR.
- Criar o menu de acesso ao relatório no ATUSX da seguinte maneira: Plano de Saúde / Miscelânea / ANS / DIOPS / Idade de Saldos a Receber, para que fique disponível no sigapls.xnu.
O relatório de Idade de Saldos deverá ser gerado em PDF seguindo o modelo abaixo:
Figura 1 - Quadro de Idade de Saldos de Contas a Receber
Figura 2 - Contas que compõem cada coluna e linha do relatório, ou seja, cruzamento das informações.
Para confecção desse relatório deverá ser utilizado o componente TReport, em , utilizar o componente FWMSPRINTER ou equivalente, por causa da facilidade em diagramar as colunas, linhas e demais itens conforme necessidade. Criar o relatório em fonte diferente da lógica de negócio, com o nome PLSRDIRELT. Em caso de dúvidas sobre a utilização desse componente pode ser utilizado como exemplo o relatório PLSR954.
Para esse relatório, cada coluna irá corresponder à uma ordem de uma visão gerencial, exemplo:
Observação: A ordem das colunas deverá seguir rigidamente a ordem das visões indicadas acima.
A visão criada deverá ser vinculada a um livro, que será utilizado para geração do relatório.
- Mensalidade/Coparticipação
- Verificar todos os registros na CV3 (Rastreamento Lançamentos) que possuem o campo CV3_TABORI igual a BM1 para encontrar as guias que foram contabilizadas no período informado pela data de referência no pergunte.
- Cada registro na tabela CV3 (Vínculo pelo campo CV3_RECDES) possui um registro na tabela CT2 (Lançamentos contábeis - Vínculo pelo RECNO), assim, encontraremos as contas relacionadas a cada registro, entretanto deverão ser consideradas apenas as contas que estão vinculadas à visão gerencial que, por sua vez, está vinculada a configuração de livro passada por parâmetro, para o filtro da conta deverá ser utilizado o campo CT2_DEBITO ou CTA_CREDITO de acordo com a configuração da conta.
- A partir da CV3(CV3_KEY) poderemos chegar até a tabela de Composição da Cobrança BM1. Após chegar na tabela CV3 deverá ser encontrado o título correspondente a cada registro na tabela SE1, caso o título esteja baixado na data de referência, o mesmo deverá ser desconsiderado. Se o título estiver aberto deverá ser verificado qual a data de vencimento do título E1_VENCTO para classificação do mesmo.
- Reciprocidade Assumida
- O processo será idêntico ao processo documentado na especificação, TUTGB8_ER_DIOPS_INTERCÂMBIO_EVENTUAL, contudo, para classificação
- O processo será idêntico ao processo documentado na especificação, TUTGB8_ER_DIOPS_INTERCÂMBIO_EVENTUAL, contudo, para classificação
Rotina | Tipo de Operação | Opção de Menu | Regras de Negócio |
[ACAA040 – Parâmetros] | [Alteração] | [Atualizações -> Acadêmico-> Tesouraria] | - |
[ACAA050 – Negociação Financeira] | [Envolvida] | [Atualizações -> Acadêmico-> Tesouraria] | - |
[ACAA060 – Cadastro de Pedidos] | [Criação] | [Atualizações -> Acadêmico-> Cadastros] | - |
Exemplo de Aplicação:
- Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
- Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades como a referência mínima para calcular o débito total do aluno.
- Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
- O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.
Tabelas Utilizadas
- SE2 – Cadastro de Contas a Pagar
- FI9 – Controle de Emissão de DARF>.
Opcional
Protótipo de Tela
<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.
Protótipo 01
Opcional
Fluxo do Processo
<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>.
Opcional
Dicionário de Dados
Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/
Índice | Chave |
01 | <FI9_FILIAL+FI9_IDDARF+FI9_STATUS> |
02 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF> |
03 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO> |
Campo | <AAA_PERESP> |
Tipo | <N> |
Tamanho | <6> |
Valor Inicial | <Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. |
Mandatório | Sim ( ) Não ( ) |
Descrição | <Referência Mínima para Cálculo> |
Título | <Ref.Calc.> |
Picture | <@E999.99> |
Help de Campo | <Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação> |
(Opcional)
Grupo de Perguntas
<Informações utilizadas na linha Protheus>.
Nome: FINSRF2
X1_ORDEM | 01 |
X1_PERGUNT | Emissão De |
X1_TIPO | D |
X1_TAMANHO | 8 |
X1_GSC | G |
X1_VAR01 | MV_PAR01 |
X1_DEF01 | Comum |
X1_CNT01 | '01/01/08' |
X1_HELP | Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório |
(Opcional)
Consulta Padrão
<Informações utilizadas na linha Protheus>
Consulta: AMB
Descrição | Configurações de Planejamento |
Tipo | Consulta Padrão |
Tabela | “AMB” |
Índice | “Código” |
Campo | “Código”; ”Descrição” |
Retorno | AMB->AMB_CODIGO |
, utilizar como exemplos os relatórios PLSR998, PLS956, PLSGUIBCO e outros.
Regras:
- Os lançamentos Padrões - LP's do sistema - mencionadas acima deverão estar corretamente configuradas e com as informações de conta de crédito conforme Plano de Contas da ANS, para o correto rastreio.
- Os títulos a receber já deverão estar contabilizados no sistema.
- Como se trata de títulos a receber, todos os itens da cobrança deverão possuir sua fonte na tabela BM1 - Composição da Cobrança.
- Criar query para localizar os registros de títulos a receber, da seguinte maneira:
- Localizar na tabela CT2 - Lançamentos Contábeis - pela coluna CT2_CREDIT os lançamentos que se encaixam nas contas definidas em cada coluna conforme figuras 1 e 2 deste documento. Ou seja, se desejamos localizar os títulos referentes aos valores de mensalidades de Planos de pessoas físicas de Preço pré-estabelecido (Coluna A), devemos localizar os títulos que se encaixam nas contas 123111011 + 123121011, ou seja, pelo campo CT2_CREDIT localizar os títulos que possuem estas contas.
- Com o resultado da query na CT2, localizar na tabela CV3 - Rastreamento Lançamento, se a origem desse lançamento é a tabela BM1. Logo:
- Relacionar a tabela CT2 com a CV3 pelo campo de relacionamento CV3_RECDES, que armazena o valor do RECNO da tabela CT2. Ou seja, rastreamos a CT2 na CV3 pelo RECNO CT2 que fica armazenado no campo CV3_RECDES.
- Caso encontre o RECNO da CT2 na CV3, verificar se a tabela de origem - CV3_TABORI - é igual a BM1 e recuperar a informação do campo CV3_RECORI, pois fica armazenado o RECNO da BM1 relacionada.
- Filtrar na CV3 os registros que se encaixam também a partir da data de referência informada no pergunte PLSRDIPR, pelo campo CV3_DTSEQ. Logo, filtrar os registros a partir desta data para trás, de forma a retornar os registros passados.
- Em seguida, posicionar na BM1, para recuperar as informações do título gerado na tabela SE1 - Contas a Receber. Para localizar o título, necessitamos das informações dos seguintes campos: BM1_PREFIX,BM1_NUMTIT,BM1_PARCEL,BM1_TIPTIT e o campo BM1_VALOR.
- Lembre-se: podemos ter vários registros da BM1 relacionados a um único título, pois temos cobrança de mensalidade, de segunda via de carteira e outros lançamentos. Por isso, devemos recuperar o valor na BM1, pois o valor do título é o total daquela cobrança e precisamos apenas do valor referente a BM1 que se encaixa nas contas da ANS.
Antes de verificar na SE1, verificar se o número do título não está na tabela FI7 - Rastreamento CR, pelo número do título nos campos FI7_FILIAL+FI7_PRFORI+FI7_NUMORI+FI7_PARORI+FI7_TIPORI.
- Caso seja localizado o número do título nesta tabela, significa que o título original foi negociado e o original já foi baixado, sendo necessário então classificar a data de vencimento dos títulos pelos novos títulos gerados pela negociação.
- Como podemos parcelar um título em várias parcelas, verificar todas as ocorrências do título original na tabela FI7, por meio de um While, para encontrar os títulos filhos gerados.
- Logo, se localizarmos o título na FI7, para localizar os novos títulos filhos gerados dessa negociação na SE1, usar os valores dos campos FI7_PRFDES + FI7_NUMDES + FI7_PARDES + FI7_TIPDES.
Com a informação do título, localizar na SE1 o título e recuperar a informação do campo E1_VENCREA, campo que armazena o vencimento real do título, considerando dias úteis, feriados e outros.
- Atenção: Os títulos deverão estar em aberto. Por isso, para fazer essa checagem devemos:
- Utilizar a função SaldoTit (fonte FINXFIN), responsável por verificar e retornar se na data de referência informada no Pergunte se os títulos estavam em aberto, pesquisando pela tabela SE5 - Movimentações Bancárias.
- Desta forma, usar função Saldotit para todos os títulos encontrados, passando as informações do título em questão e a data de referência informada no Pergunte para a função, para que retorne se o título estava em aberto ou não. Caso o título esteja baixado, a função retornará 0. Caso esteja em aberto, irá retornar o saldo restante do título.
- Importante: a função utiliza procedures. Ao realizar os testes no ambiente, verificar se as procedures envolvidas estão instaladas no sistema.
- Utilizar a função SaldoTit (fonte FINXFIN), responsável por verificar e retornar se na data de referência informada no Pergunte se os títulos estavam em aberto, pesquisando pela tabela SE5 - Movimentações Bancárias.
Desta forma, classificar os títulos conforme quadro de Idade de Saldos pela data de vencimento do campo E1_VENCREA, sendo o valor a ser considerado conforme BM1_VALOR.
Importante: Caso o título original tenha sido negociado e tenha gerado títulos filhos, será necessário além de verificar a data de vencimento, o proporcional do registro da BM1 nestes novos títulos, utilizando a função PLRETVLRBM1, que está no fonte PLSCTB.
Exemplo: o Título original tinha o valor de 500,00 e o valor considerado encontrado na BM1 era de 100,00, sendo negociado em 5 vezes - cinco títulos filhos. Logo, devemos saber o proporcional desse valor da BM1 em cada um dos títulos renegociados, através da função PLRETVLRBM1, onde no nosso exemplo, retornaria 20,00 em cada um dos títulos renegociados.
- Além disso, para que a função funcione de forma correta, é necessário que a BM1 de origem esteja posicionada, caso contrário, irá ocorrer erros de valoração. Desta forma, antes de utilizar a função PLRETVLRBM1, posicionar na BM1 correspondente.
- Devido as movimentações de ponteiro nos alias durante as funções de posicionamento com DbSeek(), MsSeek() ou DbGoTo(), guardar os dados das áreas com a função GetArea e restaurar com RestArea.
- Armazenar estas informações num array, para que seja possível sua utilização no relatório ou em outras rotinas do PLS.
- Sugestão: criar arrays para cada grupo (equivalente a cada coluna no relatório), com seis posições, onde da 1ª posição para a 5ª seriam os valores de acordo com a classificação dos vencimentos e a 6ª posição seria o total deste grupo, de modo a facilitar a transposição para o relatório ou outros usos sistêmicos.
- O relatório deve exibir as informações conforme quadro, sendo a orientação em papel A4 e no sentido horizontal - paisagem.
Títulos PPSC
Títulos em PPSC - Provisão para Perdas Sobre Créditos são os títulos considerados como duvidosos no Protheus. Existem rotinas especificas no Contábil para a provisão destes títulos, com lançamentos padrões e demais rotinas de apoio para a contabilização destes itens.
Desta forma, será necessário encontrar esses títulos provisionados, para que sejam exibidos no relatório, conforme contas definidas pela ANS. Para o correto funcionamento, é necessário que toda a rotina de Provisão de PDD esteja corretamente configurada, como os lançamentos padrões envolvidos para a correta contabilização destas informações. Até o presente momento, para a contabilização da BM1 para títulos PDD considerar a especificação ER_PCREQ-5942_Provisao_PDD, que está em fase de testes. Apesar disto, o funcionamento será similar ao existente, onde teremos a informação da conta na CT2 e podemos recuperar se o PDD é proveniente de uma BM1 pelo campo CV3_TABORI.
Desenvolver query para retornar os dados, conforme abaixo:
- Localizar na tabela CT2 - Lançamentos Contábeis - pela coluna CT2_CREDIT os lançamentos que se encaixam nas contas definidas em PPSC.
- Com o resultado da query na CT2, localizar na tabela CV3 - Rastreamento Lançamento, se a origem desse lançamento é a tabela BM1. Logo:
- Relacionar a tabela CT2 com a CV3 pelo campo de relacionamento CV3_RECDES, que armazena o valor do RECNO da tabela CT2. Ou seja, rastreamos a CT2 na CV3 pelo RECNO CT2 que fica armazenado no campo CV3_RECDES.
- Caso encontre o RECNO da CT2 na CV3, verificar se a tabela de origem - CV3_TABORI - é igual a BM1 e recuperar a informação do campo CV3_RECORI, pois fica armazenado o RECNO da BM1 relacionada.
- Filtrar na CV3 os registros que se encaixam também a partir da data de referência informada no pergunte PLSRDIPR, pelo campo CV3_DTSEQ. Logo, filtrar os registros a partir desta data para trás, de forma a retornar os registros passados.
- Como não precisamos da informação de vencimento do título, pegar o valor equivalente da BM1 no campo CT2_VALOR, de forma que podemos simplificar a query, encontrando os lançamentos que se encaixam nas contas de PPSC (CT2) e verificar se a origem é BM1 (CV3).
- Para facilitar o desenvolvimento da query, pode-se localizar no CT2_CREDIT todas as contas envolvidas no PPSC e após, utilizar o comando GROUP BY para classificar os resultados de forma ordenada e os valores somados conforme conta, facilitando o trabalho de classificação posterior, para que fique agrupada em cada coluna do relatório.
- No relatório, na linha Saldo, devemos realizar a subtração do subtotal de cada coluna com o PPSC equivalente a coluna, para temos a informação.
Rotina | Tipo de Operação | Opção de Menu | Regras de Negócio |
PLSRDIR | Inclusão | Miscelânea -> DIOPS -> Idade e Saldos | 1 a 2 |
Protótipo de Relatório
Formato do Relatório que deve ser gerado ao acessar a rotina
(Opcional)
Estrutura de Menu
<Informações utilizadas na linha Datasul>.
Procedimentos
Procedimento |
|
|
|
Descrição | (Max 40 posições) | (Max 40 posições) | (Max 40 posições) |
Módulo |
|
|
|
Programa base |
|
|
|
Nome Menu | (Max 32 posições) | (Max 32 posições) | (Max 32 posições) |
Interface | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex |
Registro padrão | Sim | Sim | Sim |
Visualiza Menu | Sim/Não | Sim/Não | Sim/Não |
Release de Liberação |
|
|
|
Programas
Programa |
|
|
|
Descrição | (Max 40 posições) | (Max 40 posições) | (Max 40 posições) |
Nome Externo |
|
|
|
Nome Menu/Programa | (Max 32 posições) | (Max 32 posições) | (Max 32 posições) |
Nome Verbalizado[1] | (Max 254 posições) | (Max 254 posições) | (Max 254 posições) |
Procedimento |
|
|
|
Template | (Verificar lista de opções no man01211) | (Verificar lista de opções no man01211) | (Verificar lista de opções no man01211) |
Tipo[2] | Consulta/Manutenção/ Relatório/Tarefas | Consulta/Manutenção/ Relatório/Tarefas | Consulta/Manutenção/ Relatório/Tarefas |
Interface | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex |
Categoria[3] |
|
|
|
Executa via RPC | Sim/Não | Sim/Não | Sim/Não |
Registro padrão | Sim | Sim | Sim |
Outro Produto | Não | Não | Não |
Visualiza Menu | Sim/Não | Sim/Não | Sim/Não |
Query on-line | Sim/Não | Sim/Não | Sim/Não |
Log Exec. | Sim/Não | Sim/Não | Sim/Não |
Rotina (EMS) |
|
|
|
Sub-Rotina (EMS) |
|
|
|
Localização dentro da Sub Rotina (EMS) |
|
|
|
Compact[4] | Sim/Não | Sim/Não | Sim/Não |
Home[5] | Sim/Não | Sim/Não | Sim/Não |
Posição do Portlet[6] | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right |
Informar os papeis com os quais o programa deve ser vinculado |
|
|
|
Cadastro de Papéis
<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.
<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.
Código Papel | (máx 3 posições) |
Descrição em Português* |
|
Descrição em Inglês* |
|
[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.
[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante
[3] Categorias são obrigatórias para os programas FLEX.
[4] Obrigatório quando o projeto for FLEX
[5] Obrigatório quando o projeto for FLEX
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|