Como adicionar um código QR EPC a uma conta em Delphi e Lazarus

2022-03-29

A padronização dos sistemas de pagamento cria não apenas novos padrões, mas também novos documentos construídos sobre esses padrões. O sistema de relatórios deve fornecer a seus usuários uma maneira rápida e conveniente de criar esses documentos típicos.

O EPC é o padrão do Conselho Europeu de pagamentos (European Payments Council). Projetado para simplificar a codificação das informações de pagamento na "Área única de pagamento em euro" através de um código QR. Esse código de barras contém todas as informações necessárias para efetuar um pagamento. Um exemplo de informações codificadas podemos ver na tabela abaixo.

Service Tag:

BCD

Version:

001

Character set:

1

Identification:

SCT

BIC:

BPOTBEB1

Name:

Red Cross

IBAN:

BE72000000001616

Amount:

EUR1

Reason (4 chars max):

CHAR

Ref of invoice:

Empty line or REFINVOICE

Or text:

Urgency fund or Empty line

Information:

Sample EPC QR code

No FastReport VCL, para simplificar a formação desses dados e organizá-los na forma de objetos, existem classes especiais de predefinições. A classe TfrxEPCPaymentPreset foi projetada para gerar rapidamente um código QR no formato EPC.

Consideramos como adicionar um código QR com uma classe de configurações EPC e conectamos os dados deste exemplo. O relatório é baseado em nosso aplicativo de demonstração "Nested Groups". O relatório foi ligeiramente modificado para exibir a lista de produtos comprados de cada uma das empresas. No final do documento de pagamento de cada empresa, queremos adicionar um código QR de acordo com o padrão EPC para que o cliente possa efetuar um pagamento rápido.

Nosso relatório no Report Designer

Selecione o objeto código de barras com o tipo "QRCode" na paleta de componentes FastReport VCL e coloque-o no porão da banda. 

Como selecionar um objeto para criar

Clique no objeto código de barras e vá para a propriedade ExpressionPreset, expanda-o e selecione TfrxEPCPaymentPreset na propriedade PresetClass. 

Como selecionar uma classe de configurações

As configurações são atribuídas e agora podem ser abertas expandindo a propriedade DataObject no inspetor de objetos.

Configurações do código de barras

Em seguida, vinculamos os campos com os dados atuais. Arraste os campos necessários da árvore de dados para a propriedade desejada no inspetor de objetos.

Como vincular os campos com as propriedades

Para inserir dados estáticos, você deve usar aspas simples, pois os dados do campo são expressões. Por exemplo, para especificar um valor fixo na propriedade IBAN, você deve usar o formato 'BE00000000000000'.

Juntamos todos os dados necessários para gerar o código, atribuindo as propriedades apropriadas.

Configurações do código de barras

Você pode executar um relatório de execução e garantir que o código de barras seja gerado no formato desejado.

Pré-visualização

Mas esses não são todos os recursos dessa classe de configurações. A propriedade DrawOptions permite controlar as configurações de exibição do quadro e informações adicionais de acordo com a norma scan2pay.

Configurações de exibição

Consideremos essas propriedades com mais detalhes:

FillColor: è a cor de fundo preenchendo o código de barras.
FrameColor: è a cor do quadro com bordas arredondadas.
FrameVisible: ativa ou desativa o quadro dentro do código de barras.
FrameWidth: è a espessura do quadro interno.
Hint: são informações textuais adicionais.
HintType: determina onde mostrar informações adicionais:

  • htEPCNone é para ocultar mais informações;
  • htEPCLeft: na borda esquerda do quadro;
  • htEPCRight: na borda direita do quadro;
  • htEPCTop: na borda superior do quadro;
  • htEPCRight: na borda inferior do quadro;

Preencha os campos conforme o mostrado na captura de tela acima e execute o relatório de execução.

Pré-visualização

No final, recebemos um código de barras que corresponde ao padrão scan2pay. A peculiaridade dessas configurações é que o quadro e o texto são desenhados dentro do objeto (ao contrário do quadro ao redor do objeto, pelo qual as propriedades do quadro são responsáveis), e esse quadro será exibido corretamente em todos os formatos de arquivos exportados.

VCL Lazarus FastReport Barcode Delphi QR Code VCL Lazarus FastReport Barcode Delphi QR Code
18 de agosto de 2022

Instalação do FastReport no Lazarus para Linux e Windows

Instruções para instalar o FastReport no Lazarus para vários sistemas operacionais com uma comparação das edições Academic, Trial, Professional.
06 de julho de 2022

Como importar um relatório do StimulSoft para o FastReport.NET

O FastReport. net adicionou um plug-in de importação de relatórios do StimulSoft que converte automaticamente seus documentos em um formato .frx.
20 de maio de 2022

Como atualizar da versão antiga do FastReport VCL para a nova

Instruções passo a passo para remover componentes anteriores e instalar uma nova versão do FastReport VCL usando o utilitário Delphi.
Fast Reports
  • 800-985-8986 (English, US)
  • +31 97 01025-8466 (English, EU)
  • +49 30 56837-3928 (German, DE)
  • +55 19 98147-8148 (Portuguese, BR)
  • info@fast-report.com
  • 66 Canal Center Plaza, Ste 505, Alexandria, VA 22314

© 1998-2025 Fast Reports Inc.