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).
...
Campo: | Descrição |
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. - Ao selecionar a opção "TXT - Remessa" indica-se que esta regra será utilizada ao realizar o processamento do Arquivo de Remessa, no programa (Geração_Boletos_HFP.BilletProcess). A tela deverá habilitar as opções referentes a parametrização do layout para geração da remessa:
Ações Relacionadas: Ações: | Descrição | Adicionar Elemento | Esta opção deverá ser utilizada para criarmos uma nova linha no arquivo de remessa.
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: - 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 |
- Totalizador - Utilizada para incluirmos no arquivo alguns totalizadores referentes ao processo de geração. Nesta linha, há também a possibilidade de realizar a impressão de mensagens informativas (Texto Livre), e suas variáveis:
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;
| Configurar Remessa | 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:
Ações Relacionadas: Ação: | Descrição | Configurar informações de layout | - Mensagem - Esta opção define se as informações referente as mensagens serão impressas no demonstrativo PDF ou Arquivo de Remessa (TXT).
- Carta de Quitação - Esta opção define se a Carta de Quitação será apresentada no demonstrativo PDF ou Arquivo de Remessa (TXT).
- Débitos Anteriores - Indica se a listagem contendo a relação de títulos em atraso do contratante será impressa no demonstrativo.
- 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").
| Utilizar este Layout como padrão para os processos... | Para as gerações de boletos externos, informar qual layout será utilizado para cada uma dessas chamadas. Caso o tipo de processo da regra de layout seja Empresarial (Pessoa Jurídica), teremos os seguintes opções: - Consulta Faturas Contratante (FP0910U) - O layout utilizado pelo programa FP0910U será o registro no qual o check-box "Consulta Faturas Contratante" estiver marcado.
- PTU - O layout utilizado pelos processos do PTU (A500 e A580), será o registro no qual o check-box "PTU" estiver marcado.
- Acesso Empresarial - O layout utilizado pela tela "Consulta Títulos Faturamento" do Acesso Empresarial será o registro no qual o check-box "Acesso Empresarial" estiver marcado.
- Demais Processos - Para os demais processos progress (FP0110B, VP0110V e chamadas externas para o Webservice), será o registro no qual o check-box "Demais Processos" estiver marcado.
Caso o tipo de processo da regra de layout seja Empresarial (Pessoa Física), teremos os seguintes opções:
- Consulta Faturas Contratante (FP0910U) - O layout utilizado pelo programa FP0910U será o registro no qual o check-box "Consulta Faturas Contratante" estiver marcado.
- Demais Processos - Para os demais processos progress (FP0110B, VP0110V e chamadas externas para o Webservice), será o registro no qual o check-box "Demais Processos" estiver marcado.
Para a geração de líquido negativo para os títulos dos prestadores, teremos os seguintes opções: - Consultas Pagamento Prestador (PP0510C) - O layout utilizado pelo programa PP0510C será o registro no qual o check-box "Consultas Pagamento Prestador " estiver marcado.
- Demais Processos - Para os demais processos progress (chamadas externas para o Webservice), será o registro no qual o check-box "Demais Processos" estiver marcado.
|
|
| |
• 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.
...
Upload / Visualização dos Anexos | - 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
|
|
...
Image Removed
• TXT - Remessa - Indica que esta regra será utilizada ao realizar o processamento do Arquivo de Remessa, no programa (Geração_Boletos_HFP.BilletProcess).
Image Removed
• 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:
Image Removed
• 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:
Image Removed
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 |
...
...