Histórico da Página
Cadastro de Layout - Boletos
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 (Geração_Boletos_HFP.BilletProcess).
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";
Ao realizar a manutenção das regras de layout, possuímos as seguintes informações disponíveis para cadastro:
• Código - Valor gerado automaticamente pelo sistema, incrementando o seu valor a cada nova regra criada. Este campo não poderá ser alterado;
• Descrição - Utilizado como facilitador para a identificação da regra;
• Tipo de Processo - Informa para qual processo esta regra será criada.
- Boleto Familiar - Boletos para contratantes de modalidade pessoa física;
- Boleto Empresarial - Boletos para contratantes de modalidade pessoa jurídica;
- Boleto Líquido Negativo - Boletos para títulos do prestador na modalidade de líquido negativo; (Quando a produção do prestador é menor do que seus gastos com a operadora de saúde).
• Tipo de Geração - Informa para qual tipo de geração esta regra será criada.
• 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.
• Carregar Arquivo de Capa - Possibilidade de realizar o upload de um arquivo no formato ".pdf", utilizado como capa para a geração. Esta capa será impressa como primeira página do demonstrativo.
• 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".