Geração

...

de Cobranças (hfp.

...

billetGeneration)

Visão Geral do Programa

Este processo tem por objetivo a geração de boletos de cobrança cobranças para faturas integradas (possuem título no EMS) do Gestão de Planos. Através Por meio deste programa, disponibilizamos foram disponibilizadas as opções de realizar um lote de geração em arquivos ".PDF", e também a possibilidade de um Arquivo de Remessa, no formato ".TXT", utilizado para a realização de impressão por sistemas terceiros. É disponibilizado duas formas de pagamento impressas no arquivo ".PDF":

• Boleto bancário(Código de Barras);
• Pix Cobrança(QR Code);

Para cada lote gerado no sistema, é criado um item na lista principal, permitindo ao usuário realize realizar o download deste item.

Image Removed

Campos da tela inicial

Image Added

Principais Campos e Parâmetros:

Campo:	Descrição
Lote	Indica qual é o lote em que a fatura foi processada.
Descrição	Ao clicar na descrição do registro, será possível consultar detalhes adicionais: Image Added Ação: Descrição Outras Ações Estão disponíveis as ações: Enviar E-mail - Realiza o envio de e-mail para as faturas em que o contratante possua configuração de envio de boletos por e-mail. Essa opção é apresentada quando selecionada a opção "Habilitar envio de E-mail" nos Parâmetros dos Boletos (hfp.billetParamConfigurations) e somente habilitada quando houver pelo menos um contratante no lote com a opção "Gerar boleto por E-mail" selecionada na Manutenção Contratante (hvp.guarantor); Quanto o status do lote for "Enviando e-mails" esta opção ficará desabilitada. Pesquisar - Possibilita pesquisar um registro específico. Sendo possível filtrar por Contratante Inicial, Contratante Final e Número da Fatura; Download Lote Possibilita a realização do Download do Lote de faturas. Voltar Retorna à tela inicial do programa. Carregar mais resultados Permite visualizar outros registros cadastrados. Campo: Descrição Contratante Código e descrição do contratante. Fatura Número da fatura. Pessoa Tipo de pessoa, podendo ser Física ou Jurídica. Status Indica qual é a situação da fatura a partir do processamento: Aviso - Ocorreram erros durante a geração que não foram erros do sistema, mas de inconsistências provenientes da configuração dos parâmetros de geração da fatura e/ou seu contratante. Erro - Ocorreram erros durante o processo, impedindo a geração desta fatura. Erro ao enviar e-mail - Fatura foi processada corretamente pelo sistema e ocorreram erros ao enviar por e-mail ao contratante. Sucesso - Fatura foi processada corretamente pelo sistema. Enviado por e-mail - Fatura foi processada corretamente pelo sistema e enviada por e-mail ao contratante. Título Visualização do número do título no financeiro, sua espécie e parcela. Valor Valor da fatura. Competência Mês/Ano da competência da fatura, apresentado quando geração de lote de Faturas Período Período/Ano do título do prestador, apresentado quando geração de lote de Líquido Negativo. Via Indica quantas vezes essa fatura foi processada pelo sistema. Ao ser gerada pela primeira vez, receberá o valor "1". Esta via será incrementada ao gerar novamente a fatura. Data Data e hora do sistema em que a fatura foi gerada. Ações Possui as opções: Download - Realiza o download da fatura; Pix Cobrança - Exibe o QR Code gerado; Enviar E-mail - Realiza o envio por e-mail da fatura, quando o contratante está configurado para o envio de boletos por e-mail. Somente estará habilitado em faturas com status "Sucesso", "Enviado por E-mail" ou "Erro ao enviar e-mail"; Regerar - Realiza nova geração da fatura ou criação de uma nova via. Esta ação estará desabilitada caso o status do boleto for "Enviado e-mail". Inconsistências - Possibilita a visualização das inconsistências da fatura, quando existirem;
Tipo de Processo	Indica qual foi o tipo de geração escolhido no momento da geração (Familiar, Empresarial ou Liquido Negativo).
Início Geração	Indica qual data e horário em que o processo de geração do lote iniciou.
Fim Geração	Indica qual data e horário em que o processo de geração foi finalizado.
Quantidade	Número de faturas/títulos processados pela geração

CampoDescriçãoCódigo GeraçãoPara cada geração finalizada, um número sequencial é criado pelo sistema, sendo utilizado para identificação deste lote em pesquisas futuras•

.
Status	Identifica a situação do lote após sua finalização

. Atualmente, possuímos as seguinte situações:

. Possui as seguintes opções: Image Added Enviando E-mails(s) - Indica que estão sendo enviados e-mails das faturas em que o contratante está configurado com o envio de boletos por e-mail. Somente são consideradas no envio, faturas com status "Sucesso" ou "Erro ao enviar e-mail"; Calculando - Indica que as faturas estão sendo processadas para geração do lote ou nova via de geração;

Sem Resultados - Indica que o filtro utilizado para a geração não encontrou nenhuma fatura a ser processada; Esse status será exibido nos seguintes casos:  Nenhum boleto gerado no lote ou lote com todos os boletos gerados com  avisos.

• Finalizado

Falha na Geração - Indica que ocorreu erro durante o processamento do lote; Inconsistências - Indica que ocorreram erros em algumas faturas processadas pelo lote; Esse status será exibido no seguinte caso:  O lote possui boletos gerados com sucesso e com erro. Gerado com Sucesso - Processo concluído resultando em uma ou mais faturas processadas. A partir deste status,

é habilitado o botão "Download" do lote.Início GeraçãoIndica qual o horário em que o processo de geração do lote iniciou.

são habilitados os botões Download do lote e Enviar E-mail (quando houverem contratantes configurados com o envio de boletos por e-mail); Esse status será exibido nos seguintes casos:  Todos os boletos gerados no lote estão com status de sucesso ou o lote possui apenas boletos com sucesso e avisos.  Enviado por E-mail - Indica que todas as faturas que possuem configuração no contratante para envio de boletos por e-mail, foram enviadas por e-mail com sucesso; Esse status será exibido no seguinte caso: Pelo menos um boleto do lote com status de enviado e-mail e sem nenhum erro no lote.   Caso seja executado o processo de envio de e-mail através do lote e acabe ocorrendo algum erro de envio em alguma das faturas, o status deverá ficar o mesmo anteriormente apresentado, ou seja, se estiver "Gerado com sucesso" e de erro de envio de e-mail o lote deverá ficar com este status, o mesmo serve para o status de "Inconsistências"

Fim GeraçãoIndica qual o horário em que o processo de geração foi finalizado

.
Usuário	Usuário do sistema o qual iniciou o processo.
Ações

DownloadBotão utilizado para realizar o download do lote selecionado. Está opção irá retornar um arquivo no formato .ZIP, onde em seu conteúdo será listado as faturas em formato PDF, ou o Arquivo de Remessa no formato TXT.

Para os lotes disponíveis na tela inicial, podemos filtrar os resultados com as seguintes opções:

Busca Avançada

Na tela inicial da aplicação, foram incluídas novas opções para filtro dos lotes. O botão "Busca Avançada" possui a funcionalidade para aplicação de um filtro composto, ou seja, a utilização de vários campos para a filtragem dos lotes.

Image Added
Principais Campos e Parâmetros:

Parametrização

Ao abrirmos a tela inicial de geração, podemos realizar o cadastro de alguns parâmetros utilizados pelo processo de geração de boletos, através da opção "Parâmetros da Geração".

Image Removed

Parâmetros Disponíveis:

Geração

Para iniciarmos uma nova geração, utilizamos a opção "Geração". Nesta nova tela, são disponibilizados os filtros para geração, e também a opção para selecionarmos o layout de parametrização.

Image Removed

Parâmetros da Geração

Nesta aba será informado os campos de filtro utilizado para a geração de lote:

Nova Geração

Este botão permite gerar um novo lote.
Image Added
Outras Ações/Ações Relacionadas:

Principais Campos e Parâmetros:

Através da tela inicial, é possível realizar o gerenciamento das regras, com as seguintes opções:

• Adicionar - Realiza o cadastramento de uma nova regra;

• Modificar - Realiza a modificação de uma regra, a partir do item selecionado na lista principal;

• Detalhar - Realiza o detalhamento de uma regra, a partir do item selecionado na lista principal;

• Remover - Realiza a remoção de uma ou mais regras, a partir dos itens selecionados na lista principal;

Para a pesquisa das regras na tela inicial, são disponibilizados os filtros abaixo:

• Código - Código único criado automaticamente a cada nova regra adicionada;

• Descrição - Realiza o filtro a partir do campo "Descrição";

• Regra Ativa - Realiza o filtro a partir de campo "Regra Ativa";

Ao realizar a manutenção das regras de mensagens, as informações a serem preenchidas são separadas em 4 abas principais:

• Parâmetros - Nesta aba, são informadas as parametrizações necessárias para a estrutura, informando a faixa de contratantes que se enquadrarão na regra criada.

Image Removed

...

Parar Geração

Este botão permite cancelar a geração de um ou mais lotes, dependendo de quantos registros estiverem selecionados no momento do cancelamento. Apenas lotes com status "Calculando" poderão ser selecionados para esse processo.

Image Added

Outras Ações/Ações Relacionadas:

Remover Geração

Este botão permite excluir um ou mais registros, dependendo de quantos estiverem selecionados no momento da exclusão.

Image Added
Outras Ações/Ações Relacionadas:

Conteúdos Relacionados

...

• Descrição - Utilizado como facilitador para a identificação da regra.

• Regra Ativa - Identifica se esta regra será considerada no momento da geração de boletos.

• Contratante Inicial / Final - Campos onde parametrizamos qual a faixa de contratante que contemplam esta regra.

• Cabeçalho - A partir dessa etapa, os textos para as mensagens impressas no boletos de cobrança serão preenchidas. Nesta aba, as informações aqui adicionadas serão impressas na parte superior da página "Mensagens Informativas", última página do boleto PDF.

Image Removed

• Mensagem Livre - O conteúdo para esta aba é de texto livre ao usuário.

Para as informações que poderão ser impressas nesta opção, estão disponíveis as seguintes tags:

[negrito] - Identifica o paragrafo a ser impresso com a fonte negrito;

Image Removed 

• Portabilidade - Responsável por gerar a mensagem de portabilidade de carências, caso o dia da geração da remessa esteja entre o primeiro dia do mês de aniversário do contrato e o último dia do terceiro mês subsequente.

Para as informações que poderão ser impressas nesta opção, estão disponíveis as seguintes tags:

[negrito] - Identifica o paragrafo a ser impresso com a fonte negrito;

[listaBeneficiarios] – Listagem dos nomes dos beneficiários que se enquadram na regra acima, junto com sua carteira;

[dataInicioPortabilidade] – Impressão do início da portabilidade de carências no formato mm/aaaa;

[dataFimPortabilidade] – Impressão do fim da portabilidade de carências no formato mm/aaaa;

Image Removed

•  Reajuste de Contratos: Responsável por gerar a mensagem, caso a competência (mês) da fatura que está sendo impressa possua reajuste definido pela ANS em seus respectivos contratos.

Para as informações que poderão ser impressas nesta opção, estão disponíveis as seguintes tags:

[negrito] - Identifica o paragrafo a ser impresso com a fonte negrito;

[nomePlano] – Nome do plano do contrato;

[registroANS] – Utilizada para a impressão do código e descrição do plano conforme nome na ANS;

[percentualReajuste] – Informa o percentual de reajuste que a proposta sofrerá;

[oficioReajuste] – Utilizado para informar o oficio do reajuste feito pela ANS;

Image Removed

• Inadimplência - Para que esta mensagem seja exibida, é necessária que a parametrização para inadimplência esteja habilitada, realizando no vínculo no programa "Manutenção Tipo Plano x Forma Pagamento - PR0110T". Caso seja constatado a inadimplência do contratante, a mensagem será impressa no demonstrativo PDF.

Para as informações que poderão ser impressas nesta opção, estão disponíveis as seguintes tags:

[negrito] - Identifica o paragrafo a ser impresso com a fonte negrito;

Image Removed

• Carta de Quitação - Campo para o comprovante de declaração anual de débitos. Seu texto será impresso somente se todos os títulos anteriores ao ano da geração estiverem pagos, e a competência da fatura gerada (mês) for igual ao mês informado nos "Parâmetros dos Boletos".

Para as informações que poderão ser impressas nesta opção, estão disponíveis as seguintes tags:

[negrito] - Identifica o paragrafo a ser impresso com a fonte negrito;

[nomeContratante] - Nome do contratante a ser impresso;

[anoReferencia] - Imprime o ano anterior a data de competência da fatura;

[dataAtual] - Imprime a data atual;

[nomeUnidade] - Retorna a unidade da operadora;

[registroAns] - Código do Registro ANS da operadora de saúde;

[numeroContrato] - Número do contrato;

Image Removed

• Rodapé - A partir desta aba, as mensagens preenchidas serão impressas na parte inferior da página "Mensagens Informativas", última página do boleto PDF. Para cada aba disponível neste processo, é criado uma linha na página.

Image Removed

• Mensagem - O conteúdo para esta aba é de texto livre ao usuário. Nesta linha também é possível informar o Tipo de Plano regulamentado pela ANS.

Para as informações que poderão ser impressas nesta opção, estão disponíveis as seguintes tags:

[negrito] - Identifica o paragrafo a ser impresso com a fonte negrito;

[tipoPlanoANS] - Será utilizada para mostrar o tipo de plano conforme normas da ANS (Regulamentado, Não Regulamentado, Adaptado);

Image Removed

• Novo Reajuste - Texto livre de caráter informativo utilizado para a descrição da regra do novo reajuste.

Para as informações que poderão ser impressas nesta opção, estão disponíveis as seguintes tags:

[negrito] - Identifica o paragrafo a ser impresso com a fonte negrito;

Image Removed

• Período de Carência - Texto livre de caráter informativo utilizado para a descrição da regra de Período de Carência.

Para as informações que poderão ser impressas nesta opção, estão disponíveis as seguintes tags:

[negrito] - Identifica o paragrafo a ser impresso com a fonte negrito;

Image Removed

• Serviços Contratados - Texto livre de caráter informativo utilizado para a descrição sobre os serviços contratados pelo cliente.

Para as informações que poderão ser impressas nesta opção, estão disponíveis as seguintes tags:

[negrito] - Identifica o paragrafo a ser impresso com a fonte negrito;

Image Removed

• Tipo de Plano - Texto livre de caráter informativo utilizado para a descrição sobre o Tipo de Plano contratado pelo cliente.

Para as informações que poderão ser impressas nesta opção, estão disponíveis as seguintes tags:

[negrito] - Identifica o paragrafo a ser impresso com a fonte negrito;

Image Removed

• Último Reajuste - Texto livre de caráter informativo utilizado para a descrição sobre a aplicação da regra do reajustes autorizados pela ANS.

Para as informações que poderão ser impressas nesta opção, estão disponíveis as seguintes tags:

[negrito] - Identifica o paragrafo a ser impresso com a fonte negrito;

[percentualReajusteAnterior=x] - Define o percentual de reajuste definido pela ANS nos anos anteriores. O parâmetro 'x' indica a quantidade de anos que será retroagido a partir do ano atual;

Exemplo: percentualReajusteAnterior=1 irá retornar o reajuste do ano de 2015;

percencualReajusteAnterior=2 irá retornar o reajuste de 2014;

Image Removed

• Vigência- Texto livre de caráter informativo utilizado para a descrição sobre a regra de Vigência de Contrato.

Para as informações que poderão ser impressas nesta opção, estão disponíveis as seguintes tags:

[negrito] - Identifica o paragrafo a ser impresso com a fonte negrito;

Image Removed

Para a consulta de todas as tags disponíveis para a impressão das mensagens, possuímos a opção "Tag's Disponíveis". A partir desta tela, é mostrado ao cliente suas opções de impressão junto com uma breve explicação de cada item.

...