ER_TTKZ13_Livro_Auxiliar_Evento_Pago

Informações Gerais

Objetivo

Esse projeto tem como objetivo alterar o programa da emissão do livro auxiliar de Registro de Eventos Pagos.  Foram realizadas as seguintes alterações:

1. 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 dtvw36aa.w (RPW) referente ao Livro Auxiliar Evento Pago foi excluído.
2. Foi 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 (af0210e.p) e Contas Contábeis - PEONA (af0210f.p).
3. Foi incluído novos totalizadores no final do arquivo, eles exibirão os valores de crédito e débito dos movimentos, facilitando assim, a conferência dos valores com os outros relatórios da contabilidade.
4. Foi alterado a impressão do arquivo, que será em "PDF", visto que o mesmo é utilizado pela ANS para fins fiscais. Além disso, foi implementado a funcionalidade para separar o arquivo gerado em excel, em arquivos menores, ou seja, cada arquivo conterá no máximo 65.000 linhas, foi realizada essa alteração para facilitar a abertura do excel. 

Definição da Regra de Negócio

 Requisito 1: Padronizar a tela do Livro Aux. ANS/RN290 RN/314 RN/322 - Registro Eventos Pagos (af0510t.p) e incluir os campos por filtro de contas.

Alterar a tela do programa Registro de Eventos Pagos (af0510t.p) para atender o novo padrão das telas do sistema. 

Hoje existem dois programas onde são emitidos os livros auxiliares o af0510t e o dtvw36aa (RPW), conforme conversado com Leonardo Leitzke e Jaqueline Formigheri para atender o novo padrão vamos unificar esses programas em apenas um. Sendo assim existirá apenas um menu “Livro Aux. ANS/RN290 RN/314 RN/322 - Registro Eventos Pagos” correspondente ao programa af0510t.p, onde os livros serão emitidos.

Como teremos apenas um programa devemos retirar a mensagem inicial que hoje é exibida ao executar o af0510t.p

Seguir o novo padrão de tela conforme setor de inovação para facilitar a conversão para o HTML. A tela deve ter duas abas: Aba de Parametros e Aba de Selecao.

Aba de Parâmetros: Nessa aba serão exibidos todos os campos utilizados como parâmetros para emissão do livro.

• Mês/Ano Limite: Nesse campo o usuário informará o período que serão buscados os movimentos. Campo obrigatório. Deve ser um período válido. Regras conforme o programa já faz atualmente.
• Termo de Abertura: Retirar esse campo da tela, pois ele sempre será buscado pela tabela livro_fisc.
•  Termo de Encerramento: Retirar esse campo da tela, pois ele sempre será buscado pela tabela livro_fisc.
• Planos Assistenciais: Campo check com as opções SIM/NAO. Sendo o default SIM (campo marcado). Regras conforme o programa já faz atualmente.
• Responsável pelas informações: Nesse campo o usuário definirá o nome do responsável pelas informações a ser emitido no final do livro. Regras conforme o programa já faz atualmente.
• Impressão: Incluir esse novo campo no programa, que terá as opções: On-Line ou Batch. Se o usuário selecionar a opção “On-line” deve seguir o processo feito hoje pelo programa af0510t.p e emitir o livro no mesmo momento. Caso o usuário selecione a opção “Batch” deve seguir o processo feito hoje pelo programa dtvw36aa.w, dando a possibilidade de agendamento desse processo, conforme o padrão dos RPW. Além disso, deve exibir na tela o campo Servidor RPW para o usuário selecionar o servidor que deseja utilizar.
• 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 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 deve existir um botão, onde o usuário informará o diretório que deseja salvar. Esse campo será obrigatório. Caso a opção do campo Impressão seja “Online”, o usuário deve informar um valor nesse campo, se não informar nada deve lançar mensagem: “Campo Obrigatório”, caso o usuário informar um diretório que não existe deve lançar mensagem: “Diretório Invalido”. Utilizar a imagem da lupa para busca dos diretórios, verificar o padrão utilizado pelo setor de inovação. Caso a opção do campo Impressão seja “Batch” esse campo trará apenas para visualização o valor do campo Diretório Spool do cadastro Servidor de Execucao.
• 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: “ARQUIVO-EVENTO-PAGO-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. Caso o usuario informe a extensão do arquivo deve lançar mensagem: “Não informar a extensão do arquivo”.  Ao clicar em Executar exibir o seguinte aviso para o usuário: “O Livro de Eventos Pagos em PDF e o arquivo CSV, serao impressos no diretorio informado no campo "Diretorio dos Relatorios".”
• Relatório Complementar: Esse campo será somente para visualização e deve ser preenchido como valor “ARQUIVO-EVENTO-PAGO-ANOMES-MOV-EXTRA” conforme fazia na tela antiga. IMPORTANTE: Esse campo sera exibido somente se a opção “Emitir dados em arquivo CSV” estiver marcada.
• Emitir Dados em arquivo CSV: O usuário definirá nesse campo se deseja ou não emitir o relatório em CSV também. Conforme conversado com as contadoras esse relatório serve para auxiliar na conferência dos dados. Sendo assim, o default desse campo será, "SIM". Se o usuario não quiser emitir esse relatório deve desmarcar essa opção.

Exemplo de tela:

Aba de Seleção:  Nessa aba serão exibidos os filtros que o usuário pode selecionar para emitir o livro.

• Grupo de Prestadores: Nesse campo o usuário selecionará o grupo de prestadores pelos quais o relatório será filtrado. Trazer todos os grupos de prestadores selecionados como default, e obrigar selecionar pelo menos um. Essa tabela terá as colunas: Seleção, Grupo (gruppres.cd-grupo-prestador) e Descrição (gruppres.ds-grupo-prestador). Os dados devem ser buscados na tabela gruppres. Assim como já é feito atualmente. Nessa tabela vamos ter também três botões: Marca/Desmarca, Marca Todos e Desmarca Todos.

• Filtrar por Grupo de Contas: Nesse campo o usuário selecionará se deseja realizar o filtro por grupo de contas conforme é feito no PEONA atualmente. Caso o campo esteja marcado como SIM, deve 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, deve esconder a tabela do grupo de contas. Por default trazer esse campo marcado.

• Tabela do Grupo de Contas: Incluir essa nova tabela onde o usuário selecionará o grupo de contas pelos quais o relatório será filtrado. Trazer todos os grupos de contas selecionados como default, e obrigar selecionar pelo menos uma. Essa tabela terá as colunas: Seleção, Grupo (grp-ctas-peona.num-grupo), Descriçao (grp-ctas-peona.des-grupo), Inicio (grp-ctas-peona.dat-inic) e Fim (grp-ctas-peona.dat-fim). Os dados devem ser buscados na tabela grp-ctas-peona. Nessa tabela vamos ter também três botões: Marca/Desmarca, Marca Todos e Desmarca Todos.

• Filtrar por Contas: Nesse campo o usuário deve marcar se deseja selecionar por conta ou não. Caso o usuário marque esse campo, deve habilitar os campos Conta e Subconta para o usuário informar o intervalo de contas a ser selecionada. Não foi feito como no filtro acima, pois podem existir várias contas e carregar elas todas em um mesmo tabela poderia tornar o processo muito lento. Caso o usuário, marque NÃO nessa opção deve desabilitar os campos Conta e SubConta, e trazer por default os campos inicial “” e final ZZZ. Esse campo deve vir desmarcado como default.

• Conta Inicial e Final: Esse campo deve trazer o default das contas Inicial “” e Final “ZZZ” verificar como faz o PEONA, e deve ser habilitado somente quando o usuário marcar SIM no campo Filtro por Contas. Fazer a validação para o usuario não informar a conta inicial menor que a final. Default do campo será desabilitado com os valores “” e ZZZZ. Importante: Se o usuário tiver marcado Filtrar por Grupo de Contas e Filtrar po Conta, deve verificar se as contas informadas nesse campo estão dentro dos grupos selecionados na tabela do grupo de contas do PEONA ctas-peona. Essa mensagem deve ser apenas um alerta para o usuário prosseguir com o processo se desejar.

• Subconta Inicial e Final: Campo somente para visualização.

Sendo assim o usuário terá as seguintes possibilidades de filtro:

Abaixo segue o exemplo da tela:

Essa tela deverá ter dois botões: Sair que irá fechar o programa e Executar que vai chamar a api-eventos-Pagos e emitir o relatório.

Requisito 2: Reestruturar as leituras realizadas no programa do Livro Aux. ANS/RN290 RN/314 RN/322 - Registro Eventos Pagos (af0510t.p).

O Registro de Eventos Pagos tem como objetivo exibir todos os registros pagos pela operadora.  É realizada uma busca por todos movimentos pagos e contabilizados, que sejam de títulos normais ou extras e que pertençam a beneficiário da base. O processo filtra pelo período informado pelo usuário em tela que será mensal, por Segmento Assistencial onde tipo de medicina da modalidade for igual a parametrizada nos parâmetros globais do sistema, por Grupo de Prestador e por Grupo de Contas. Ainda é informado o nome do Responsável pelas informações e os arquivos que serão gerados: PDF e CSV. Sendo que o arquivo PDF será utilizado para prestação de contas com a Receita e o arquivo CSV será utilizado apenas para conferência dos valores pelo contador. 

Foi realizado uma reestruturação nesse programa para tornar as  buscas mais rápidas e para que seguir o padrão de leitura de outros programas da contabilidade.

Criar a procedure p-executa-livro-pago que será a procedure principal do programa. Nessa procedure será montado a tabela temporária de filtros de grupo de prestador, grupo de contas e a tabela temporária de datas (tmp-data), conforme o período informado em tela.

Criar a procedure p-seleciona-movtos onde serão buscados os movimentos pagos e contabilizados, através da tabela titupres, o título deve estar contabilizado e deve ser do tipo normal ou movimento extra (ou seja não considera títulos de impostos).  Busca no EMS pela data de baixa desse título para exibir no relatório.

Busca os procedimentos pagos através da procedure p-le-procedimento que vai percorrer a tabela movimen-proced-nota e buscar a moviproc relacionada a mesma.

Verificação dos filtros informados pelo usuário: Movimento deve pertencer a um beneficiário da base, filtrar por plano assistencial, caso seja marcada essa opção, o tipo de medicina da modalidade do movimento (modalid.cd-tipo-medicina) deve ser igual ao tipo de medicina tradicional parametrizado na paramecp (paramecp.cd-meditradi). Filtrar pelo grupo de prestador informado pelo usuário, buscar o prestador de pagamento do movimento (preserv), buscar o grupo desse prestador (gruppres) e verificar se esse grupo foi selecionado pelo usuário.

Buscar os dados referente ao movimento:

1. Buscar o codigo do procedimento na tabela ambproce.
2. Buscar as contas (Conta Provisão, Conta Custo e Conta Glosa) e os valores do procedimento: Valor Valorizado (revisão de contas), Valor Provisionado, Valor do Custo e Valor da Glosa. Para isso deve ser acessado a tabela de histórico do movimento (histor-movimen-proced).

Armazena o valor provisionado como crédito da provisão e débito no custo.

Realiza o filtro pelo grupo de contas. Verifica pelos campos provisão custo e glosa. Verificar esse novo processo no requisito 3.

Criar a tabela temporária de contratantes. Verifica se ainda não existe o registro com mesmo termo e modalidade do movimento, senão cria através da procedure p-cria-tmp-contratante. Busca o termo de adesão, pela modalidade e termo do movimento.  Busca a proposta pela modalidade e termo. Busca o registro de plano de saúde ANS pela proposta. Busca plano de saúde pela modalidade e plano. Busca tipo de plano pela modalidade, plano e tipo de plano. Busca o contratante através da proposta. Com esses dados cria a tabela de contratante com os campos: código da modalidade, descrição da modalidade, número do termo de adesão, número da proposta, data de início e fim do termo, código do contratante, nome do contratante, código do plano, nome do plano, código do tipo de plano, nome do tipo do plano, tipo de regulamentação e tipo da contratação.

Cria a tabela temporária de beneficiários. Verifica se já existe um registro com a mesma modalidade, termo de adesão e beneficiário, senão cria através da procedure p-cria-tmp-beneficiario. Busca o usuário. Cria a tabela com os campos: código da modalidade, número do termo de adesão, código do usuário, nome do usuário, carteira do usuário, código do titular, nome do titular, cpf do titular, grau de parentesco, número da proposta, data de inclusão e exclusão do plano, segmento assistencial (usuario.in-segmento-assistencial) e tipo de contratação.

Cria a tabela temporária de movimento, com os dados do movimento buscado acima.

Incrementa o contador de movimentos “ct-mov-selec”.

Para os insumos criar a procedure p-le-insumo que vai percorrer a tabela movimen-insumo-nota. Vai realizar os mesmos filtros do procedimento utilizando a tabela de insumos: verificar se movimento é de beneficiário da base, filtro por plano assistencial e filtro por grupo de prestador.

Buscar os dados referente ao movimento:

Buscar o codigo do insumo na tabela insumos.

1. Busca as contas (Conta Provisão, Custo e Glosa ) e os valores do movimento: Valor valorizado (revisão de contas), Valor Provisionado e Valor do Custo.

Armazena o valor provisionado como crédito da provisão e débito no custo.

Realiza o filtro pelo grupo de contas. Verifica pelos campos provisão custo e glosa. Verificar esse novo processo no requisito 3.

Criar as tabelas temporária de contratantes, beneficiários e movimento da mesma forma que no procedimento. Incrementa o contador de movimentos “ct-mov-selec”.

Para os movimentos extras criar a procedure p-le-movimentos-extras que vai percorrer a tabela movipres através dos campos do título: referencia, unidade, unidade prestador, prestador, tipo de medicina, espécie, numero da nota e onde classe do evento for igual a E ou D. Busca o evento do pagamento na tabela evenfatu. Vai verificar os filtros por plano assistencial e por grupo de prestador. Verifica o tipo de movimento procedimento ou insumo e busca os dados do mesmo. Busca a conta contábil na tabela evencopp.

Caso exista algum movimento a ser impresso, ou seja, ct-mov-selec  for maior que zero vai realizar a impressão dos movimentos através da procedure p-imprime-relatorio. Limpa as tabelas dos totalizadores: tmp-total-contratacao, tmp-total-segmento, tmp-total-despesa e tmp-conta-cred-deb. Se foi selecionada a opção emitir CSV (tt-param.lg-arquivo-csv for true) cria o cabeçalho do CSV.

Para cada tipo de contratação e para cada segmento assistencial percorre a tabela temporária de beneficiários (tmp-beneficiario) e busca o contratante na tabela temporária de contratante (tmp-contratante). Imprime os dados do contratante: Modalidade, Termo, Data de Inicio e fim do terno, Contratante, Plano e Tipo de Plano. Imprime os dados do beneficiário: CPF titular, nome do titular, Beneficiario, Grau de Parentesco, Data de Inclusao e Exclusao do Plano. Le os módulos opcionais e obrigatórios do beneficiário. Percorre a tabela temporária de movimentos (tmp-movimentos) e imprime os dados do movimento. Acumula os valores de provisão, custo e valorizado desse movimento para imprimir ao final.

Cria a tabela de totalizadores finais, verificar esse novo processo no requisito 4.

Após imprimir todos os registros das tabelas, imprime a quantidade de movimentos do relatório e os totalizadores finais. Imprime termo de encerramento e responsável pelas informações.

Se existe movimentos impressos deve transformar o arquivo em PDF, verificar melhor esse processo no requisito 5 e lançar mensagem: “Relatorio Gerado”. Caso não exista movimentos selecionados deve lançar mensagem: “Nenhum movimento selecionado”.

Verificar a tabela temporária “tmp-erros”, caso tenha ocorrido algum erro deve imprimir os mesmos através da procedure “p-imprime-rel-erros” e lançar a mensagem: “Verifique Relatorio de Erros/Advertencias. Apos Verificado/Corrigido os Erros. Emitir Novamente para este periodo!”

Requisito 3: Implementar filtro por Grupo de Contas no programa Livro Aux. ANS/RN290 RN/314 RN/322 - Registro Eventos Pagos (af0510t.p), conforme o PEONA faz atualmente.

                É necessário implementar a regra do filtro por grupo de contas nos livros auxiliares, como faz hoje no PEONA. Os grupos de contas são parametrizados nos cadastros: Grupo de Contas - PEONA e Livros Auxiliares e Contas Contábeis – PEONA e Livros Auxiliares. Somente serão emitidos os movimentos que tenham as contas parametrizadas nesse cadastro, caso o usuário deseje desconsiderar esse filtro deve informar NÃO nos dois parâmetros de seleção “Filtro por Grupo Contas” e “Filtro por Contas”.

                Alterar o programa api-eventos-pagos.p antes das criações das tabelas temporárias e verificar se foi selecionada a opção por Filtro de Grupo ou Filtro de Conta, então realizar o processo abaixo:

                Deve ser verificado os três tipos de conta: Provisão (ct-codigo), Custo (char-6) e Glosa (cod-livre-3), conforme o PEONA também faz. Caso tenha valor informado nesses campos deve chamar a nova procedure p-verificar-filtro-contas, que vai receber por parâmetro a conta, subconta, data de realização e retornar o log-erro.

                Na procedure p-verificar-filtro-contas podemos separar em duas verificações:

1. Se o usuário selecionou “Filtro por Conta”, então verificar se a conta do movimento recebida por parâmetro está dentro do intervalo informado nos campos conta inicial e final, caso não esteja deve retornar erro. Se estiver verificar ainda se a conta do movimento está parametrizada na tabela ctas-peona, caso não esteja retornar o log de erro.
2. Se o usuário selecionou “Filtro por Grupo de Conta” percorrer a tabela dos grupos de contas selecionados e verificar se a data de realização desse movimento está dentro da data de inicio e fim dos grupos selecionados, caso sim verificar se a conta desse movimento existe dentro do grupo selecionado, através da tabela ctas-peona. Caso não, retornar o log de erro.

No retorno dessa procedure se ocorreu erro realizar o seguinte processo para cada tipo de conta:

• Para Conta de Provisão: Caso ocorra erro deve limpar os dados referentes a provisão: vl-provisionado-aux, vl-provisao-credito-aux, vl-provisao-debito-aux, ct-conta-provisao-aux, sc-conta-provisao-aux, e setar a variável lg-conta-selecionada-aux como falso.
• Para Conta de Custo: Caso ocorra erro deve limpar os dados referentes ao custo: vl-custo-aux, vl-custo-credito-aux, vl-custo-debito-aux, ct-conta-custo-aux, sc-conta-custo-aux, e setar a variável lg-conta-selecionada-aux como falso.
• Para Conta de Glosa: Caso ocorra erro deve limpar os dados referentes a glosa: vl-glosa-aux, ct-conta-glosa-aux, sc-conta-glosa-aux , e setar a variável lg-conta-selecionada-aux como falso.

Essa tratativa é feita dessa forma, pois pode ocorrer do movimento ter a conta de provisão parametrizada e a conta de custo não. Assim como os movimentos são exibidos por linha, temos que exibir esse movimento com os dados da provisão, porém como a conta de custo não está parametrizada, os dados referentes a mesma deverão ser exibidos em branco.

Agora no caso do movimento não ter nenhuma conta parametrizada, ele não deve ser exibido. Assim criamos a variável “lg-conta-selecionada-aux”, pois pode ocorrer ainda a situação do movimento não ter sido nem provisionado, assim todas contas estarão em branco, mas ele deve ser impresso. Agora no caso das contas estiverem em branco por causa do filtro, ai sim o movimento não deve ser exibido.

Resumo dos filtros que podem ocorrer:

Requisito 4: Alterar os totalizadores que são exibidos no programa do Livro Aux. ANS/RN290 RN/314 RN/322 - Registro Eventos Pagos (af0510t.p).

Conforme conversado com a contadora Marcia Giongo de Lageado/RS atualmente os totalizadores do livro estão confusos, pois não existe um identificador do que entrou como débito e do que entrou como crédito. Assim fica complicado de bater os valores dos relatórios. Como sugestão foi comentado de realizar um total por conta que sinalize se é débito ou se é crédito.

Assim vão ser exibidos 4 totalizadores nesse livro:

• Totalização por Tipo de Contratação X Segmento Assistencial X Despesa (Inclusões - Exclusões): Esse totalizador exibirá os valores por tipo de contratação, segmento assistencial e despesa. As colunas serão: valor valorizado, valor provisionado e valor de custo. Para preencher esses valores vamos considerar os movimentos incluídos menos os movimentos excluídos.
• Totalização por Tipo de Contratação X Segmento Assistencial X Despesa (Por Crédito e Débito): Esse totalizador exibirá os valores por tipo de contratação, segmento assistencial e despesa. As colunas serão: Provisão Crédito, Provisão Débito, Custo Crédito, Custo Débito e Valor Glosa.
• Totalização por Conta Contabil X Segmento Assistencial (Por Crédito e Débito): Esse totalizador exibirá os valores por Segmento assistencial e Conta. As colunas serão: Provisão Crédito, Provisão Débito, Custo Crédito, Custo Débito e Valor Glosa.
• Totalização por Conta Credito e Debito: Esse totalizador exibirá os valores de crédito e débito separados por conta. As colunas serão: Provisão Crédito, Provisão Débito, Custo Crédito, Custo Débito e Valor Glosa.

Para realizar essa alteração criar as tabelas temporárias: tmp-total-contratacao, tmp-total-segmento, tmp-total-despesa e  tmp-conta-cred-deb. Na procedute “p-imprime-relatorio” ao imprimir os movimentos, quando percorre a tabela temporária de movimento (tmp-movimentos), criar essas tabelas totalizando pelos valores de débito e crédito.

Após a impressão da quantidade de movimentos criar uma nova procedure “p-imprime-totalizadores”, dentro dessa procedure criar as procedures: p-imprime-contrat-seg-despesa-saldo, p-imprime-contrat-seg-despesa-cred-deb, p-imprime-conta-seg-cred-deb e p-imprime-conta-cred-deb que vai imprimir cada um dos totalizadores listados acima.

Requisito 5: Transformar o arquivo LST para PDF.

                Conforme conversado com o consultar Marcio Dal Agnol, os dados emitidos nesse livro serão enviados para a ANS fazer a conferência contábil das operadoras. Conforme visto com o escritório contábil para cada controle gerencial devem ser gerados dois arquivos eletrônicos, um em “.pdf”, que possibilita melhor leitura, outro em “.csv” ou “.xls”, que possibilite a tabulação dos dados. Sendo assim vamos transformar o arquivo hoje emitido em LST para PDF.

                Na procedure “api-eventos-pagos” após a chamada da procedure p-executa-livro-pago, verificar se foi impresso algum movimento, ou seja, se a variável ct-mov-selec é maior que zero, então transformar o arquivo LST em PDF. Verificar a possibilidade de utilizar o programa conversor_pdf utilizada no programa pp0610a. O layout do PDF impresso deve ser idêntico ao LST hoje disponibilizado.

Requisito 6: Separar os arquivos xls em arquivos menores.

                Conforme verificado se existem muitos registros a serem impressos o arquivo excel não abre corretamente, assim foi implementado uma função para ele dividir o arquivo em arquivos menores, ou seja, a cada 65000 registros ele cria um novo arquivo.