Boleto Bancário . com
Desde 2000 no mercado de emissão de boletos!
Manual de Customização do Boleto Service
Introdução
O Boleto Service permite a customização da parte superior do boleto tanto no formato HTML quanto no formato PDF de acordo com suas necessidades.
Para o formato HTML o campo de customização é livre permitindo o uso de qualquer elemento HTML. Neste caso a customização ficará dentro de um elemento div.
Para customização de boletos em formato PDF disponibilizamos uma linguagem simples, conforme descrito nos tópicos abaixo.
Com 7 instruções é possível inserir imagens e texto de forma simples e ao mesmo tempo bastante flexível.
Caso deseje utilizar esta funcionalidade, é imprescindível a leitura e entendimento deste documento.
Formato
O campo customizado consiste de uma série de instruções separadas pelo caractere "|".
Atenção:
- Todos os campos de todas as instruções são obrigatórios.
- Com exceção das instruções "nl", "color", "rect" e "pos", as demais instruções fazem com que a posição do "cursor" fique a direita do elemento inserido. Chamamos esta posição de "esquerda atual".
1 - Instrução Image: Insere uma imagem no documento
- Formato:
image[L|C|R][ScalePercentage]:[Filename.[jpg|png|gif]] - * [L|C|R] - Posição da Imagem: L (Left/Esquerda) - C (Center/Centro) - R (Right/Direita)
- * [ScalePercentage] - Dimensionamento da imagem em relação ao seu tamanho original. Este campo é numérico e representa a porcentagem do tamanho.
- * [Filename.[jpg|png|gif]] - O nome do arquivo cuja imagem se deseja inserir.
- Exemplos:
imageC63:cabecalho_8.png- Insere a imagem cabecalho_8.png centralizada na linha atual. A imagem terá 63% de seu tamanho original.imageL100:logotipo.jpg- Insere a imagem logotipo.jpg na esquerda atual. O tamanho original será preservado.imageR100:http://www.boletobancario.com/imagens/home/logo.png- Insere a imagem logo.png na margem direita. A imagem será carregada da URL em questão.
2 - Instrução Text: Insere um texto no documento.
- Formato:
text[B|N][L|C|R][FontSize]:[Texto] - * [B|N] - Tipo de Fonte: B (Bold/Negrito) - N (Normal)
- * [L|C|R] - Posição do Texto: L (Left/Esquerda) - C (Center/Centro) - R (Right/Direita)
- * [FontSize] - Tamanho da Fonte: Campo numérico.
- * [Texto] - O texto que se deseja inserir.
- Exemplos:
textBC16:Fatura Mensal- Insere o texto "Fatura Mensal" em negrito, centralizado, com tamanho de fonte 16.textNL10:Desconto: 15%- Insere o texto "Desconto: 15%" com fonte normal, na esquerda atual e tamanho de fonte 10.
3 - Instrução New Line: Modifica a posição do cursor para uma nova linha e a margem esquerda.
- Formato:
nl:[Lines] - * [Lines] - Número de linhas que se deseja "pular".
- Exemplos:
nl:1- Move o cursor para a linha diretamente abaixo do último elemento inserido.nl:3- Move o cursor para 3 linhas abaixo do último elemento inserido.
O tamanho do espaçamento será o tamanho do maior elemento inserido na linha.
4 - Instrução Pos: Posiciona o cursor em uma coordenada [x, y] específica.
- Formato:
pos:[X],[Y] - * [X] - Coordenada X (horizontal). Número decimal, separado por ".". A parte esquerda do
documento é a posição zero, sendo que para folhas A4 a borda direita corresponde a 595.0.
- * [Y] - Coordenada Y (vertical). Número decimal, separado por ".". A parte de baixo do
documento é a posição zero, sendo que para folhas A4 o topo corresponde a 842.0.
- Exemplos:
pos:140,717- Posiciona o elemento seguinte na coordenada x = 140 e y = 717.pos:203.5,655.5- Posiciona o elemento seguinte na coordenada x = 203.5 e y = 655.5.
5 - Instrução Rect: Desenha um retângulo ou uma linha em uma posição específica.
- Formato:
rect:[LineWidth],[X],[Y],[Width],[Height] - * [LineWidth] - Define a espessura da linha. Número decimal separado por ".".
- * [X] - Coordenada X (horizontal) do canto inferior esquerdo do retângulo ou linha.
Número decimal separado por ".".
- * [Y] - Coordenada Y (vertical) do canto inferior esquerdo do retângulo ou linha.
Número decimal separado por ".".
- * [Width] - Largura do retângulo ou comprimento da linha.
Número decimal separado por ".".
- * [Height] - Altura do retângulo ou linha. Caso deseje inserir uma linha o valor deste
parâmetro deve ser igual ao parâmetro [LineWidth].
- Exemplos:
rect:0.8,350,500,200,0.8- Desenha uma linha com espessura 0.8 iniciando na coordenada x = 350 e y = 500. A linha terá 200 pontos de comprimento.rect:0.3,20,500,200,210- Desenha um retângulo com espessura de linha = 0.3 iniciando na coordenada x = 20 e y = 500, com 200 pontos de altura e 210 pontos de comprimento.
6 - Instrução Color: Altera a cor para os elementos seguintes.
- Formato:
color:[Red],[Green],[Blue] - * [Red] - Valor da cor vermelho, entre 0 e 255. Número inteiro.
- * [Green] - Valor da cor verde, entre 0 e 255. Número inteiro.
- * [Blue] - Valor da cor azul, entre 0 e 255. Número inteiro.
- Exemplos:
color:200,10,10- Altera a cor para vermelho = 200, verde = 10 e azul = 10.color:0,0,0- Altera a cor para vermelho = 0, verde = 0 e azul = 0 (preto).
7 - Instrução Tab: Move a esquerda atual N posições.
- Formato:
tab:[N] - * [N] - Número de posições que se deseja mover. Cada posição tem um espaçamento de 30 pontos.
- Exemplos:
tab:1- Move a esquerda atual 30 pontos em direção a margem direita.tab:3- Move a esquerda atual 90 pontos em direção a margem direita.
Exemplo completo
imageC63:http://www.boletobancario.com/imagens/home/logo.png|nl:1|textBC20: |nl:1|textBC16:Fatura mensal de serviços|nl:3|textBL12:Descritivo dos serviços|nl:2|tab:2|textNL11:* Quantidade contratada: 100 - |textBL11: R$ 20,00|nl:1|tab:2|textNL11:* Quantidade excedente: 150 - |textBL11: R$ 40,00|nl:2|tab:2|textNL11:* Desconto fidelidade: 14 Meses - |textBL11: 10% - (R$ 6,00)|nl:3|textNL12:Total desta fatura:|textBL12: R$ 54,00|nl:4|textNL10:Prezado cliente, verificamos que seu consumo excedeu em mais de 20% o plano contratado.|nl:1|textNL10:Você pode alterar seu plano na área restrita de nosso site: |textBL10:www.boletobancario.com|rect:0.5,10,450,575,0.5|color:200,10,10|rect:1,120,557,55,18
Considerações Finais
A customização deve ser programada com cautela, pois erros neste campo podem descaracterizar ou inviabilizar a geração do boleto.
Utilize sempre a funcionalidade de testes do Boleto Service para validar sua customização.
Em caso de dúvidas entre em contato através do endereço https://www.boletobancario.com/home/contato.