Histórico da Página
Cadastro de
...
Layouts -
...
Cobranças
Visão Geral do Programa
Este cadastro tem por objetivo a parametrização de regras de layouts, utilizados para a configuração do Arquivo de Remessa (TXT), e também para a escolha das informações que serão impressas no demonstrativo "PDF", durante o processo de Geração de Boletos Cobranças (Geração _Boletos_HFP.BilletProcessde Cobranças (hfp.billetGeneration)).
Objetivo da tela: | Manutenir as regras de layouts utilizadas para a geração de |
cobranças. |
Ações Relacionadas:
Ações |
Descrição | |
Adicionar | Realiza o cadastramento de uma nova regra. |
Pesquisa |
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".
Realiza o filtro das regras por código ou descrição. Acessível através do campo de busca. | |
Busca Avançada | Abre a tela com as opções de busca avançada de registros. |
Adicionar
Modificar | Realiza a modificação de uma regra, a partir do item selecionado na lista principal |
. Acessível através do ícone de edição da coluna de ações. | |
Detalhar | Realiza o detalhamento de uma regra, a partir do item selecionado na lista principal |
. Acessível através do link na descrição da regra. | |
Remover | Realiza a remoção de uma ou mais regras, a partir dos itens selecionados na lista principal. Acessível através do ícone de exclusão da coluna de ações. |
Botão Adicionar/Modificar
Ao realizar a manutenção das regras de layout serão apresentados apresentadas para cadastro algumas informações básicas e outras informações que poderão variar de acordo com o campo "Tipo de Geração":
Principais Campos e Parâmetros:
Campo |
Descrição |
Descrição | Utilizado como facilitador para a |
identificação da regra |
. |
Tipo |
do Processo | Informa para qual processo esta regra será criada |
: |
|
|
| |
Tipo de Geração | Informa para qual tipo de geração esta regra será criada |
(TXT - Remessa ou PDF)
|
|
|
Configuração do arquivo |
Principais Campos e Parâmetros |
: |
|
Para cada elemento é possível escolher se este será um texto livre ou uma variável.
O texto livre será uma informações fixa que deverá ser parametrizada para impressão na linha do arquivo TXT. E, a opção variável, será uma informação não parametrizável, impressa na linha do arquivo TXT recebida do sistema.
Há 6 tipos diferentes de elementos/linhas que poderão ser adicionadas e cada uma delas poderão ter diferentes variáveis:
OBSERVAÇÃO: O "Código identificador da linha" e o "Número sequencial", não permitem a alteração da posição, pois serão sempre no início e fim da linha respectivamente. A parametrização do arquivo de remessa será realizada adicionando elementos a serem impressos no arquivo. Os elementos podem também ser vinculados à linhas de Eventos da Remessa. Ações Relacionadas:
|
- Linha Customizável - Utilizada para a criação de uma linha no arquivo TXT, onde poderá ser adicionado informações referentes a fatura e boleto de cobrança. As variáveis são divididas em 5 grupos, relacionando-se a um determinado tipo de informação:
Informações da Operadora | |
Nome da Operadora | Texto |
CNPJ | Texto |
Número Registro ANS | Texto |
Rua | Texto |
Bairro | Texto |
UF | Texto |
CEP | Texto |
Cidade | Texto |
Telefone | Texto |
Informações do Cliente (Contratante ou Prestador) | |
Código do Cliente | Inteiro |
Código do Prestador | Interiro |
Nome do Cliente | Texto |
CPF/CNPJ | Texto |
Rua | Texto |
Bairro | Texto |
CEP | Texto |
UF | Texto |
Cidade | Texto |
Número de Telefone | Texto |
Número de Inscrição | Texto |
Tipo de Pessoa | Texto |
Informações da Fatura | |
Modalidade do Plano | Inteiro |
Número do Contrato | Inteiro |
Código do Plano ANS | Texto |
Nome do Plano | Texto |
Tipo do Plano | Texto |
Data do Início do Contrato | Data |
Código Contratante Origem | Inteiro |
Nome Contratante Origem | Texto |
Número da Fatura | Inteiro |
Número do Título | Texto |
Parcela | Inteiro |
Espécie | Texto |
Ano de Referência | Inteiro |
Mês de Referência | Inteiro |
Valor do Título | Decimal |
Data de Emissão | Data |
Data de Vencimento | Data |
Data de Pagamento | Data |
Data de Competência | Texto |
Data de Processamento | Data |
Identificador Débito Automático | Lógico |
Identificador Débito em Produção | Lógico |
Informações do Boleto | |
Número da Agência | Inteiro |
Dígito da Agência | Inteiro |
Número da Conta | Inteiro |
Dígito da Conta | Inteiro |
Espécie do Documento | Texto |
Aceite | Texto |
Carteira | Inteiro |
Nosso Número | Texto |
Dígito Nosso Número | Texto |
Valor do Desconto | Decimal |
Valor Final | Decimal |
Nome do Favorecido | Texto |
CNPJ do Favorecido | Texto |
Local de Pagamento | Texto |
Linha de Instrução 1 | Texto |
Linha de Instrução 2 | Texto |
Linha de Instrução 3 | Texto |
Linha de Instrução 4 | Texto |
Linha de Instrução 5 | Texto |
Linha de Instrução 6 | Texto |
Linha de Instrução 7 | Texto |
Linha de Instrução 8 | Texto |
Mensagens do Boleto | |
Mensagem Livre | Texto |
Mensagem de Portabilidade | Texto |
Mensagem Reajuste de Contrato | Texto |
Mensagem de Inadimplência | Texto |
Mensagem de Rodapé | Texto |
Mensagem de Novo Reajuste | Texto |
Mensagem do Período de Carência | Texto |
Mensagem do Tipo de Plano | Texto |
Mensagem do último reajuste | Texto |
Mensagem da Vigência | Texto |
Carta de Quitação | Texto |
- Relatório de Débitos Anteriores - Utilizada para imprimir no arquivo TXT as informações do relatório de Débitos Anteriores do título. Nesta linha, há também a possibilidade de realizar a impressão de mensagens informativas (Texto Livre), e suas variáveis:
Relatório de Débitos Anteriores | |
Número do Título | Texto |
Valor do Título | Decimal |
Data de Vencimento | Data |
Dias em atraso | Inteiro |
- Relatório de Eventos - Utilizada para imprimir no arquivo TXT as informações do relatório de Eventos da Fatura. Nesta linha, há também a possibilidade de realizar a impressão de mensagens informativas (Texto Livre), e suas variáveis:
Relatório de Eventos | |
Código do Evento | Inteiro |
Descrição do Evento | Texto |
Crédito/Débito | Lógico |
Valor do Evento | Decimal |
Relatório de Valores por Beneficiários - Utilizada para imprimir no arquivo TXT as informações do relatório de Extrato de Utilização dos Beneficiários. Nesta linha, há também a possibilidade de realizar a impressão de mensagens informativas (Texto Livre), e suas variáveis:
Valores por Beneficiários Nome do Beneficiário Texto Cartão Nacional de Saúde Decimal Data de Inclusão Data Valor do Evento Decimal Descrição do Evento Texto
|
Totalizadores | |
Quantidade de títulos na remessa | Inteiro |
Total de valores na remessa | Decimal |
Total de débito em utilização | Decimal |
Além disso, poderão ser configuradas as propriedades do texto de cada linha:
- Tamanho - Tamanho que esta mensagem irá ocupar dentro da linha. Caso o tamanho informado seja maior do que o texto digitado, o conteúdo restante será preenchido com espaços em branco;
- Completar com Zeros - Se este parâmetro estiver marcado, os caracteres restantes para completar o tamanho máximo informado no campo "Tamanho" será com o número zero "0".
- Formatação do Texto - Indica se a mensagem informada será alinhada a direita ou esquerda da linha, limitando-se ao tamanho máximo informado no campo "Tamanho";
Para cada linha/elemento adicionado, através da opção "Configurar Linha" , é possível parametrizar também:
- Descrição da Linha - Campo informativo para o usuário;
- Somente uma linha por remessa - Indica que se esta linha será impressa somente uma vez na geração do arquivo;
- Identificador da linha - Campo utilizado para informar o código identificador da linha;
Através da opção "Configurar Remessa", o usuário poderá habilitar algumas configurações no momento da impressão, tais como:
- Tamanho da Linha - Indica qual é o tamanho máximo em que cada linha linha do arquivo poderá conter;
- Valor Mínimo - Para faturas de Co-Participação ou de Líquido Negativo, as mesmas só serão incluídas na remessa se o seu valor for maior do que o informado;
- Impressão para Débito em Produção? - Indica se faturas que possuam Débito em Produção cadastradas serão impressas no arquivo;
- Habilita número sequencial da linha - Se este parâmetro estiver selecionado, ao final de cada linha do arquivo será mostrado um número sequencial correspondente a linha impressa;
- Quantidade de dígitos do sequencial - Informa a quantidade máxima de números sequenciais gerados;
- Habilita código identificador da linha - Indica se ao início de cada linha, será impresso um código identificador;
- Quantidade de dígitos do identificador - Quantidade máxima de caracteres impressos no código identificador.
- Ao selecionar a opção "PDF" indica-se que esta regra será utilizada ao realizar o processamento de faturas no formato PDF, no programa (Geração_Boletos_HFP.BilletProcess). Ao selecionarmos esta opção, temos a possibilidade de configurarmos quais informações serão mostradas no demonstrativo PDF, através das opções:
• PDF - Indica que esta regra será utilizada ao realizar o processamento de faturas no formato PDF, no programa (Geração_Boletos_HFP.BilletProcess).
Ao selecionarmos esta opção, temos a possibilidade de configurarmos quais informações serão mostradas no demonstrativo PDF, através das opções:
• Beneficiário - Indica se a listagem contendo os beneficiários dos contratos faturados serão impressos no demonstrativo. (Esta opção só é habilitada ao realizar o tipo de processo "Familiar");
• Extrato de Utilização - Indica se a listagem contendo a utilização do beneficiário no plano será impressa no demonstrativo. (Esta opção só é habilitada ao realizar o tipo de processo "Familiar");
• Débitos Anteriores - Indica se a listagem contendo a relação de títulos em atraso do contratante será impressa no demonstrativo.
Para a geração empresarial, é habilitado a opção "Layout para geração via Web Service?". Ao selecionarmos este campo, esta regra de layout será utilizada nos processos de geração do PTU(A500, A800), e também para a impressão dos demonstrativos via Acesso Empresarial.
...
Ao selecionar a opção "PDF", indica-se que esta regra será utilizada ao realizar o processamento de faturas no formato "PDF", no programa (Geração de Cobranças (hfp.billetGeneration)). Ao selecionarmos esta opção, temos a possibilidade de configurarmos quais informações serão mostradas no demonstrativo "PDF", por meio das opções:
|
Conteúdos Relacionados
Cadastro de Configurações Financeiras - Boletos (hfp.billetBankConfigurations) |
Geração de Cobranças (hfp.billetGeneration) |
• Carregar Arquivo de Logo - Possibilidade de realizar o upload de um logotipo no formato ".png" e ".jpg", para ser incluído no cabeçalho do demonstrativo.
• TXT - Remessa - Indica que esta regra será utilizada ao realizar o processamento do Arquivo de Remessa, no programa (Geração_Boletos_HFP.BilletProcess).
• Habilita código identificador da linha - Ao habilitar este parâmetro, durante a geração do Arquivo de Remessa, os primeiros 5 caracteres de cada linha são reservados para a impressão de um código identificador, utilizado para o reconhecimento desta linha no momento da leitura do arquivo por softwares de terceiros.
• Carregar Arquivo XML- Neste campo, devemos realizar o upload do XML de parametrização necessário para a configuração do Arquivo de Remessa (TXT). (Este campo é obrigatório para finalização da regra).
Com a geração do processo de Arquivo de Remessa, temos a possibilidade de realizarmos as configurações do layout TXT, definindo quais informações serão impressas em cada uma de suas linhas. Para definirmos essas configurações, um XML contendo essas definições deve ser criado, através de tag's disponíveis:
• Layout - Tag inicial do arquivo XML. A partir desta etiqueta, em que todas as outras opções serão implementadas.
• valorMinimoParticipacao - Informa um valor mínimo para a geração de faturas de participação. Caso o valor seja menor do que o estabelecido, esta fatura não será enviada na remessa.
• valorMinimoLiqNegativo - Informa um valor mínimo para a geração de títulos de líquido negativo. Caso o valor seja menor do que o estabelecido, este título não será enviado na remessa.
• Custom - Linha customizável utilizada para criar as informações impressas em determinada linha. Dentro desta tag, é possível utilizarmos variáveis ou texto livre.
• Variável - Imprime o conteúdo de uma informação relacionada aos dados da fatura ou boleto de cobrança.
• Texto - Realiza a impressão de um texto fixo na linha desejada.
Para cada variável ou texto informado, podemos definir um tamanho máximo, ou alinhar o texto para direita ou esquerda, conforme imagem abaixo:
• Relatório - Esta linha é utilizada caso desejamos imprimir alguns relatórios utilizados pelo sistema Gestão de Boletos (Relatório de Eventos da Fatura, Relação de Beneficiários do Contrato e Extrato de Utilização dos Beneficiários no Plano). Dentro desta tag, podemos alterar quais informações serão mostradas:
Para cada variável utilizada, possuímos algumas propriedades que podem ser adicionadas ao layout:
Variável | Descrição | Valor Padrão |
tamanho | Informa qual será o tamanho máximo que a propriedade possuirá na linha | 8 |
conteudo | Utilizada para adicionarmos um texto livre na linha | Vazio |
alinharTexto | Alinha o campo no formato desejado (Direita ou Esquerda) | Esquerda |
formatoData | Definição de um formato para as variáveis do tipo DATA | dd/MM/yyyy |
formato | Definição de um formato para as variáveis do tipo LÓGICO. Exemplo: S/N - True - S - False - N | true/false
|
Listagem de variáveis:
• Fatura e Boleto de Cobrança
Nome | Descrição |
dt-processamento-fat | Dia da geração da remessa |
nr-titulo-acr | Número do título no EMS |
nr-nosso-num | Nosso Número |
nr-dig-nosso-num | Dígito do Nosso Número |
dt-vencimento | Data de Vencimento da Fatura |
vl-valor-fatura | Valor da Fatura |
cd-modalidade | Código da Modalidade |
nr-ter-adesao | Código do Contrato (Termo de Adesão) |
nr-titulo-acr | Número do título no EMS |
cdn-plano-ans | Código do Plano Regulamentado na ANS |
nm-plano | Nome do Plano Regulamentado na ANS |
• Contratante
Nome | Descrição |
cd-contratante | Código do Contratante |
nr-cgc-cpf | CPF ou CNPJ do Contratante |
nm-contratante | Nome do Contratante |
en-rua | Rua do Contratante |
en-bairro | Bairro do Contratante |
en-cep | CEP do Contratante |
nm-cidade | Cidade do Contratante |
en-uf | UF do Contratante |
lg-debito-automatico | Identifica se o contratante possui débito automático |
• Relatório - Evento da Fatura
Nome | Descrição |
ds-evento | Descrição do Evento da Fatura |
vl-evento | Valor do Evento da Fatura |
lg-cred-deb | Identifica se o evento é de Crédito ou Débito |
• Relatório - Beneficiários dos contratos faturados
Nome | Descrição |
nm-tipo-plano | Tipo de Plano do Usuário |
dt-inclusao-plano | Data de Inclusão do Plano do Beneficiário |
vl-usuario | Valor do Evento a nível de Beneficiário |
cd-cns | CNS (Cartão Nacional de Saúde) |
• Relatório - Relação de Débitos Anteriores
Nome | Descrição |
nr-dias-atraso | Numero de dias em atraso do título |
nr-titulo-acr | Número do Título |
vl-total | Valor do Título em atraso |
dt-vencimento | Data de Vencimento |
• Relatório - Extrato de Utilização
Nome | Descrição |
dt-realizacao | Data de Realização de um Serviço |
cd-carteira-inteira | Carteira do Beneficiário |
nm-usuario | Nome do Beneficiário |
nm-prestador | Nome do Prestador |
ds-servico | Nome do Serviço Realizado |
qt-servico | Quantidade do Serviço Realizado |
vl-evento | Valor do Serviço |
• Mensagens
Nome | Descrição |
msg-reajuste-corrente | Mensagem de Reajuste de Contrato |
msg-portabilidade | Mensagem de Portabilidade de Carências |
msg-vigencia-contrato | Mensagem de Vigência do Contrato |
msg-tipo-plano | Mensagem Tipo de Plano do Contrato |
msg-servicos-contratados | Mensagem Serviços Contratados |
msg-novo-reajuste | Mensagem Novo Reajuste |
msg-ultimo-reajuste | Mensagem Último Reajuste |
msg-periodo-carencia | Mensagem Períodos de Carência |
msg-inadimplencia | Mensagem de Inadimplência |
msg-carta-quitacao | Mensagem Carta de Quitação |
Um exemplo contendo o layout configurado em formato XML encontra-se disponível no diretório "lap/layoutParametrizacaoBoletoFamiliar.xml".