Á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

 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

 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. 

 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

.


  1. 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.
  2. 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:

Image Removed

Image Added

Figura 1 - Quadro de Idade de Saldos de Contas a Receber


 Image Added

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:

 

Image Removed

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.

 

  • Criar novo arquivo fonte para definição do relatório, sugestão: PLSRDIR (PLS - Plano de Saúde   R - Relatório  D - Diops   I - Idade e Saldos R - Receber).
  • Criar query para buscar as informações do relatório. Essa query deverá ser montada utilizando os seguintes passos:
    1. Mensalidade/Coparticipação
      1. 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.
      2. 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.
      3. 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.
    2. Reciprocidade Assumida
      1. 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

     

     

     Image Removed

     

     

     

     

     

     

    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:

    1. 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. 
    2. Os títulos a receber já deverão estar contabilizados no sistema.
    3. 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.
    4. Criar query para localizar os registros de títulos a receber, da seguinte maneira:
      1. 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.
      2. Com o resultado da query na CT2, localizar na tabela CV3 - Rastreamento Lançamento, se a origem desse lançamento é a tabela BM1. Logo:
        1. 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.  
        2. 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.
        3. 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.
      3. 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.
        1. 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.
    5. 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. 

      1. 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.
      2. 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.
      3. 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.
    6. 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.

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

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

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

        2. 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.
        3. 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.
    8. Armazenar estas informações num array, para que seja possível sua utilização no relatório ou em outras rotinas do PLS.
      1. 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.
    9. 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:

    1. Localizar na tabela CT2 - Lançamentos Contábeis - pela coluna CT2_CREDIT os lançamentos que se encaixam nas contas definidas em PPSC.
    2. Com o resultado da query na CT2, localizar na tabela CV3 - Rastreamento Lançamento, se a origem desse lançamento é a tabela BM1. Logo:
      1. 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.  
      2. 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.
      3. 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.
    3. 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).
    4. 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.
    5. 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 

     Image Added

     

    (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

    [6] 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.