Árvore de páginas

Livro Auxiliar de Eventos Ressarcidos ou Recuperados

Características do Requisito

Linha de Produto:

Datasul

Segmento:

Saúde

Módulo:

Gestão de Planos de Saúde

Rotina:

Rotina

Nome Técnico

Livros Aux ANS/RN290 RN/314 RN/322 - Registro de Eventos Ressarcidos Recuperados.

AF0510U

Chamados Relacionados

TTVGLI; TRZOBO; TS6229; TS8122; TSFYPF.

País(es):

Brasil.

Banco(s) de Dados:

Oracle® / Progress® / SQL Server®.

Tabelas Utilizadas:

fatura

Descrição

Foram efetuadas as seguintes melhorias no processo da emissão do livro auxiliar de Registro de Eventos Ressarcidos ou Recuperados (af0510u):

  1. Foi alterada a leitura das faturas de coparticipação para considerar também as faturas avulsas e eventos programados, conforme a parametrização de contas, como o PEONA faz atualmente.
  2. Foi alterada a tela de emissão do livro, para atender os novos padrões de tela "HTML". Nesse programa o usuário poderá escolher se deseja emitir o livro "Online" ou em "Batch", através da aba Parâmetro, no campo "Impressão". Sendo assim, o programa dtvw37aa.w (RPW) referente ao Livro Auxiliar Evento Ressarcido ou Recuperado foi excluído. Foram retirados os campos Termo de Abertura e Termo de Encerramento da tela, pois eles sempre serão buscados do cadastro de “Manutenção de Livros Fiscais”.
  3. Implementada a funcionalidade de filtro por Grupo de Contas, onde o usuário poderá selecionar as contas que serão consideradas na impressão dos registros. Essa funcionalidade é similar a existente no relatório do PEONA (pp0310b.p). As contas e grupos a serem utilizadas nesse relatório devem ser cadastradas nos programas Grupo de Contas - PEONA e Livros Auxiliares (af0210e.p) e Contas Contábeis - PEONA e Livros Auxiliares (af0210f.p).
  4. Incluída uma nova opção para o usuário selecionar se deseja emitir o relatório em PDF ou LST.
  5. Implementado a funcionalidade para separar o arquivo gerado em excel, em arquivos menores, pois no caso de muitos registros o arquivo não estava abrindo corretamente. Assim, o usuário vai definir a versão do excel que irá utilizar. Versões inferiores a 2007 suportam no máximo 65.000 linhas, versões superiores suportam até 1.000.000 de linhas.

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

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.

 

Procedimento para Configuração

Foi implementado a funcionalidade de filtro por Grupo de Contas nos livros auxiliares, como faz hoje no Peona (PP0310B). Os grupos de contas são parametrizados nos cadastros: Grupo de Contas - Peona e Livros Auxiliares (AF0210E) e Contas Contábeis - Peona e Livros Auxiliares (AF0210F). Observação: Para desconsiderar esse filtro deve desmarcar as opções "Filtrar por Grupo Contas” e “Filtrar por Contas”, nesse caso serão impressos todas as faturas independente das contas. 

Serão realizados os seguintes testes por filtro de contas:

  1. Se o usuário selecionou “Filtrar por Conta”, é verificado se a conta da fatura está dentro do intervalo informado nos campos conta inicial e final, caso não esteja, os campos relacionados a conta testada são limpos. 
  2. Se o usuário selecionou “Filtrar por Grupo de Conta” é verificado os grupos de contas selecionados pelo usuário e se a data de emissão da fatura está dentro da data de inicio e fim do grupo selecionado, além disso é verificado também se a conta dessa fatura existe dentro do grupo selecionado, caso não esteja os campos relacionados a conta testada são limpos.

Caso a conta não esteja parametrizada, essa fatura não será impressa no relatório.

Seleção por Grupo de Contas

Situação

Filtro por Grupo Contas

Filtro por Contas

Resultado

Situação 1

Sim

Sim

Verificar se a conta da fatura está dentro do intervalo de contas informado pelo usuário. Verificar se a data da emissão da fatura está dentro da data do grupo selecionado e se a conta da fatura pertence ao grupo selecionado.

Situação 2

Sim

Não

Verificar se a data de emissão da fatura está dentro da data do grupo selecionado e se a conta da fatura pertence ao grupo selecionado.

Situação 3

Não

Sim

Verificar se a conta da fatura está dentro do intervalo de contas informado pelo usuário.

Situação 4

Não

Não

Não deve realizar nenhuma validação, ou seja, vai listar todas faturas.

Abaixo segue explicação detalhada de como parametrizar as contas:

  1. No Gestão de Planos de Saúde, acesse o módulo HAF - Arquivos Fiscais e abra o cadastro Grupo de Contas - Peona e Livros Auxiliares (AF0210E). Configurar conforme exemplo:


2. No Gestão de Planos de Saúde, acesse o módulo HAF - Arquivos Fiscais e abra o cadastro Contas Contábeis - Peona e Livros Auxiliares (AF0210F). Relacionar a conta com os grupos criados.

 

Procedimento para Utilização

 As operadoras de planos de assistência a saúde devem manter a disposição da ANS, Controles Gerenciais que permitam, a qualquer tempo, a comprovação da fidedignidade dos dados registrados em sua escrita contábil. Um destes controles é o Registros de Eventos/Sinistros Ressarcidos ou Recuperados segregados por produto. Trata-se de um dos questionários pertencentes ao Relatório PPA (Procedimentos Previamente Acordados). Periodicamente e junto com o DIOPS ANS (Documento de Informações Periódicas das Operadoras de Planos de Assistência à Saúde), o PPA deve ser encaminhado eletronicamente e através da internet, contendo informações econômico-financeiras das operadoras de saúde.  O PPA também deverá ser arquivado em meio físico e mantido a disposição da ANS por 5 anos. Esse livro irá listar todas as faturas de coparticipação. Foram realizadas as seguintes alterações para o projeto do Livro Auxiliar de Eventos Ressarcidos e Recuperados.

  1. Alteração do Layout: Foi alterado o layout do programa Livros Aux. ANS/RN290 RN/314 RN/322 - Registro de Eventos Ressarcidos e recuperados(af0510u.p) para atender o novo layout padrão de telas HTML. Essa nova tela terá duas abas: Parâmetros e Seleção e dois botões Sair que fechará o programa e Executar que exibirá a mensagem: “O Livro de Eventos Ressarcidos e Recuperados em PDF e o arquivo CSV, serão impressos no diretório informado no campo Diretório dos Relatórios.”, caso o usuário clique em ok emitirá o relatório, 
      • A aba de Parâmetros contém os seguintes campos:
        • Mês/Ano Limite: Nesse campo o usuário informará o período que serão buscadas as faturas. O campo é obrigatório e verifica se o período informado é válido. 
        • Considerar Faturas: Campo do tipo “radio” que terá as opções “Contabilizadas” ou “Não Contabilizadas”, sendo o default “Contabilizadas”.
        • Selecionar faturas por: Campo do tipo “radio” que terá as opções “Data da Emissão” ou “Data do Vencimento”, sendo o default “Data da Emissão”.
        • Somente Planos Assistenciais: Campo check com as opções SIM/NAO. Sendo o default SIM (campo marcado).  Caso o usuário marque essa opção, serão emitidos apenas movimentos onde, a modalidade seja igual a parametrizada no cadastro de parâmetros globais do sistema (pr1410p) do campo tipo de medicina tradicional.
        • Responsável pelas informações: Nesse campo o usuário definirá o nome do responsável pelas informações que será emitido no final do livro. 
        • Formato do Relatório: O usuário poderá selecionar se deseja emitir o livro em formato PDF ou TXT.
        • Impressão: Este campo tem as opções: On-Line ou Batch. Se o usuário selecionar a opção “On-line” o relatório será emitido no mesmo momento, caso o usuário selecione a opção “Batch” deve seguir o processo de agendamento do processo, conforme o padrão dos RPW, nessa opção será exibido o novo campo “Servidor RPW” onde o usuário informará o servidor que será utilizado. Esses servidores devem estar previamente configurados no cadastro “Manutenção de Servidor de Execução”.
        • Servidor RPW: Esse campo será exibido somente se o usuário selecionar o campo Impressão como “Batch” e vai buscar as opções do cadastro Manutenção de Servidor de Execução.
        • Diretório dos Relatórios: Nesse campo o usuário informará o diretório onde serão gravados os relatórios. Ao lado desse campo é exibido um botão, onde poderá ser pesquisado o diretório desejado. Esse campo é obrigatório e somente permitirá diretórios válidos. Caso, o campo Impressão seja “Online” o usuário deve informar um valor para esse campo, caso a opção seja “Batch” esse campo será preenchido automaticamente e não poderá ser editado, o valor do mesmo será buscado no cadastro de “Manutenção de Servidor de Execução”  e se existir o campo "Subdiretório" do cadastro de Usuário.
        • Nome dos relatórios: Nesse campo o usuário selecionará onde serão salvos os arquivos pdf, de erros e csv. O nome seguirá o mesmo padrão de hoje: “EVENTOS-RESS-REC-ANOMES”. Importante: Esse nome será utilizado para o arquivo PDF, de erro e CSV (caso o usuário tenha selecionado emitir CSV). Esse campo será editável e obrigatório.
        • Emitir Dados em arquivo CSV: O usuário definirá nesse campo se deseja ou não emitir o relatório em CSV, sendo o default desse campo "Sim".
        • Versão do Excel 2007 ou superior: Definirá a versão do Excel que utilizará para abrir o arquivo. Isso foi utilizando dessa forma, pois no caso em que existiam muitos registros o Excel não estava abrindo corretamente, assim separamos esse arquivo em arquivos menores. No caso de versões inferiores a 2007 o número máximo de linhas do arquivo será de 65000, no caso de versões superiores o número máximo de linhas sera de 1.000.000.
      • aba de Seleção contém os seguintes campos:
        • Filtrar por Grupo de Contas: Nesse campo o usuário selecionará se deseja realizar o filtro por grupo de contas ou não, sendo por default "Sim". Caso o campo esteja marcado como "sim", vai exibir e habilitar a tabela do grupo de contas para o usuário selecionar os grupos desejados. Caso o campo esteja marcado como "não", vai esconder a tabela do grupo de contas. 
        • Tabela do Grupo de Contas: Nessa tabela o usuário selecionará o grupo de contas pelos quais o relatório será filtrado, por default virá com todos os grupos selecionados, e vai validar para o usuário selecionar pelo menos um grupo para emissão do relatório.
        • Filtrar por Contas: Nesse campo o usuário deve marcar se deseja filtrar as faturas por Conta ou não, sendo o default "não". Caso o usuário marque esse campo, habilita os campos da Conta para o usuário informar o intervalo de contas a ser selecionada. Caso o usuário, marque "não" nessa opção desabilita os campos da Conta. 
        • Conta Inicial e Final: Esse campo deve trazer o default das contas Inicial “” e Final “ZZZ” , e será habilitado somente quando o usuário marcar a opção "sim" no campo Filtrar por Contas. O default desse campo será desabilitado. Observação: Caso o usuário marcar Filtrar por Grupo de Contas e Filtrar por Conta, será verificado se as contas informadas nesse campo estão dentro dos grupos selecionados na tabela do grupo de contas do Peona.
        • Subconta Inicial e Final: Campo somente para visualização com as subcontas relacionadas as contas informadas pelo usuário.    

  2. Nova funcionalidade de Filtro por Grupo de Contas: O usuário poderá selecionar as contas que serão consideradas na impressão dos registros. Essa funcionalidade é similar a existente no relatório do Peona (pp0310b.p). As contas e grupos a serem utilizadas nesse relatório devem ser cadastradas nos programas Grupo de Contas - Peona e Livros Auxiliares (af0210e.p) e Contas Contábeis - Peona  e Livros Auxiliares(af0210f.p).
  3. Impressão do livro em PDF: Foi incluída uma nova opção para o usuário, permitindo ele informar se deseja emitir o livro em PDF ou LST.
  4.  Separação de Arquivo Excel: Implementado a funcionalidade para separar o arquivo gerado em excel, em arquivos menores, pois no caso de muitos registros o arquivo não estava abrindo corretamente. Assim, o usuário vai definir a versão do excel que utilizará. Versões inferiores a 2007 suportam no máximo 65.000 linhas, versões superiores suportam até 1.000.000 de linhas.
  5.  Exclusão dos campos Termo de Abertura e Termo de Encerramento: Os campos Termo de Abertura e Termo de Encerramento foram retirados da tela de Parâmetros, visto que os mesmos sempre serão buscados do cadastro de “Manutenção de Livros Fiscais” do EMS, através do código do estabelecimento, tipo de livro igual a “Diário Auxiliar” e módulo “ACR”.

As faturas de coparticipação são verificadas através do tipo de nota, que deve ser 2 (Participação cobrança de fator moderador) ou 7 (Participação com antecipação), porém existem faturas de coparticipação que tem outros tipos de notas cadastradas e que também são de participação, isso acontece no caso de faturas avulsas e eventos programados. Para solucionar essa questão, vamos ter a possibilidade de considerar a separação dessas faturas por conta também, conforme faz hoje o programa do PEONA. 

  1. Pesquisa de Faturas com Notas do Tipo 2 ou 7
  • Busca apenas Notas do tipo 2 ou 7 (participação), levando em consideração os seguintes filtros:
    • A seleção não será por Conta, ou seja, os campos Filtrar por grupo de contas deve ser igual a Não e o campo Filtrar por Contas deve ser igual a Não.
    • Verifica se foi selecionado o filtro pelo plano assistencial, então o tipo de medicina da modalidade deve ser igual ao tipo de medicina cadastrada no Manutenção de Parâmetros Globais do Sistema.
    • Busca eventos do faturamento e verifica se a classe do evento é diferente de D (evento contador) ou F (evento de imposto).
    • Busca os movimentos da nota e cria os registros.
    • Busca os Eventos Programas que estejam cadastrados no mês e ano informado pelo usuário e que possua uma fatura relacionada. Verifica o filtro pelo plano assistencial, caso necessário. Busca eventos do faturamento e verifica se a classe do evento é diferente de D (evento contador) ou F (evento de imposto). Busca os eventos programados dos seguintes cadastros:
      • Manutenção Associativa Eventos Programados X Valor (FP0110C).
      • Manutenção Associativa Eventos Programados X Percentual (FP0110D).
      • Manutenção Associativa Eventos Programados X Percentual Sem evento (FP0110E).
  • EXEMPLO:
  1. Acesse o menu Registro de Eventos Ressarcidos e Recuperados (AF0510U).
  2. Informe os filtros desejados na aba de "Parâmetros". Nesse caso vamos utilizar o mês/ano de 02/2016, para faturas “não contabilizados” e por “data da emissão”, assim serão buscados apenas as faturas que tenham data de emissão dentro do mês de fevereiro. Além disso, vamos emitir o livro em PDF e em Excel.


  3. Selecione na aba de seleção os filtros desejados. Nesse caso, não vamos selecionar nenhum dos filtros de contas, assim considerará apenas notas do tipo 2 e 7.


    4. Clique em Executar.

    RESULTADO:

    Será gerado o arquivo em CSV e o arquivo em PDF. Abaixo, exemplo de alguns campos que poderão ser visualizados no relatório CSV como: fatura, contratante, conta e valor recuperado.


    Na emissão em PDF, podemos verificar os registros conforme tipo de contratação e segmento. Para cada um deles verifica se possui beneficiários, a fatura e os movimentos da fatura do mesmo. No final do livro vamos ter três totalizadores: Tipo Contratação X Segmento X Despesa; Tipo Contratação X Segmento X Despesa X Conta; Totalização por Conta.

    2. Pesquisa de Faturas Avulsas

    Busca as faturas avulsas, conforme o filtro de contas, levando em consideração os seguintes filtros:

    • Deve ter pelo menos um dos filtros de seleção por Contas informado: Filtrar por grupo de contas: Sim/Não - Filtrar por Contas: Sim/Não.
    • Caso selecionado o filtro por plano assistencial o tipo de medicina da modalidade deve ser igual ao tipo de medicina do Manutenção de Parâmetros Globais do Sistema.
    • Busca eventos do faturamento e verifica se a classe do evento é diferente de D (evento contador) ou F (evento de imposto).
    • Verifica se existem beneficiários relacionados a fatura avulsa.
    • Cria os registros.

    EXEMPLO:

  1. Acesse o menu Registro de Eventos Ressarcidos e Recuperados (AF0510U).
  2. Informe na aba de parâmetros os filtros desejados para emissão do livro. Nesse caso vamos utilizar o mês/ano de 01/2016, para faturas “não contabilizados” e por “data da emissão”, assim serão buscados apenas as faturas que tenham data de emissão dentro do mês de janeiro. Além disso, vamos emitir o livro em PDF e em Excel.


  3. Selecione na aba de seleção os filtros desejados. Nesse caso, vamos informar Filtrar por Grupo de Contas, se não selecionar nenhum grupo, deve lançar mensagem de erro: "Nenhum grupo selecionado" e não deve emitir.


  4. Caso selecione algum grupo deve emitir. Nesse caso, selecionamos o Grupo "13 - Contas de Participação", que deve ter sido previamente cadastrado.


  5. Clique em Executar.



    RESULTADO:
    Será gerado o arquivo em CSV e o arquivo em PDF. 
    Podemos verificar no arquivo CSV a fatura e contratante, como a conta e o valor recuperado da mesma. Temos alguns registros que não possui beneficiário, eles são categorizados como "Faturas Sem Beneficiario":


    No arquivo em PDF/LST, podemos verificar os registros pelo tipo de contratação/segmento. Para cada modalidade e termo será impresso um novo contratante.
    No caso da fatura não possuir beneficiário, não temos como categorizar, nesse caso elas serão exibidas todas no final no quadro "Faturas Sem Beneficiário".
    Nos dois primeiros totalizadores teremos apenas registros que estão dentro de um tipo de contratação e segmento assistencial.
    Já no último totalizador das contas, serão considerados todas as faturas impressas no livro.




    3. Pesquisa de Faturas por Conta de Participação
    • Busca as faturas de participação, através das contas parametrizadas, não importando o tipo de nota. Vai ser levado em consideração os seguintes filtros:
      • Deve ter pelo menos um dos filtros de conta informado. Filtrar por grupo de contas: Sim/Não ou Filtrar por Contas: Sim/Não.
      • Caso selecionado o filtro por plano assistencial o tipo de medicina da modalidade deve ser igual ao tipo de medicina cadastrada no Manutenção Parâmetros Globais do Sistema.
      • Busca eventos do faturamento e verifica se a classe do evento é diferente de D (evento contador) ou F (evento de imposto).
      • Busca os movimentos da nota e cria os registros. 
      • Verifica se a conta da fatura está dentro da seleção do usuário.
    EXEMPLO:
  1. Acesse o menu Registro de Eventos Ressarcidos e Recuperados (AF0510U).
  2. Informe na aba de parâmetros os filtros desejados para emissão do livro. Nesse caso vamos utilizar o mês/ano de 06/2015, para faturas “não contabilizados” e por “data da emissão”, assim serão buscados apenas as faturas que tenham data de emissão dentro do mês de junho.  Além disso, vamos emitir o livro em PDF e em Excel.
  3. Selecione na aba de seleção os filtros desejados. Nesse caso, vamos informar Filtrar por Grupo de Contas igual a 13 - Contas de Participação" e a conta igual a "4125111021106", esses registros devem ter sido previamente cadastrado. Obs: Pode-se pesquisar também somente por conta.


  4. Clique em Executar.

    RESULTADO:
    Será gerado o arquivo em CSV e o arquivo em PDF.
    No arquivo CSV podemos verificar alguns campos como a fatura, contratante,conta e valor recuperado.


    No arquivo em PDF/LST, podemos verificar os registros pelo tipo de contratação/segmento. 
    Para cada modalidade e termo será impresso um novo contratante. 
    Para cada beneficiário serão listados os movimentos do mesmo e o total recuperado.