qrbill – create QR-bills based on the swiss payment standard

Copyright (C) Marei Peischl (peiTeX) marei@peitex.de, 2020–2023

This work is part of a collaborative project of Marei Peischl (peiTeX) and Alex Antener (foobar LLC).

qrbill 2023/07/24 v2.01

This material is subject to the LaTeX Project Public License version 1.3c or later. See http://www.latex-project.org/lppl.txt for details.

The included qrbill-qrencode.lua file is subject to a 3-clause BSD license Copyright (c) 2012-2020, Patrick Gundlach (SPEEDATA GMBH) and contributors, see https://github.com/speedata/luaqrcode. All rights reserved.

Provided files

• README.md
• qrbill.dtx
• qrbill.ins
• qrbill-vocab.csv
• qrbill_swiss-cross.pdf

The files

• qrbill.sty
• swiss.qrbill-cfg.tex
• epc.qrbill-cfg.tex as well as the demo files
• qrbill-standalone-demo.tex
• qrbill-letter-demo.tex
• qrbill-epc-demo.tex can be created from the qrbill.dtx by processing the qrbill.ins-file.

Installation Notes

To be able to compile the package, the files qrbill.sty, swiss.qrbill-cfg.tex, qrbill_swiss-cross.pdf and qrbill-vocab.csv have to be placed in the $TEXINPUTS path.

To simplify this, you can have a look at the qrbill.tds.zip, which provides an already prestructured variant to be extracted to any tds tree.

Use the Repository directly

The repository provides a l3build script. You can build the documentation by running

l3build doc

This will unpack the package files and build the the docs within build/.

To install the files into your local texmf tree run

l3build install

For further information on l3build and other options please have a look at the corresponding documentation texdoc l3build.

Version History

• v1.00 (2020-06-28) First official version
• v1.01 (2020-06-29) Add tds package and the separate option
• v1.02 (2020-08-25)
  • Fix placement issue with separate option
  • Add sep-iban/sep-reference mechanism
  • Not on version number inconsistency
• v1.03 (2021-05-10)
  • Update to swiss qrbill payments standard v2.2
  • Add seb-iban and sep-reference to the example files
• v1.04 (2022-07-02)
  • add basic support for EPC QR codes
  • add date parsing mechanism to preset the dates to values of \today
• v1.05 (2022-09-15)
  • add option to convert all data to strings
  • add mechanism to do custom replacements within the data
  • fix qrcode encoding to support UTF-8
  • add support for speedata's luaqrcode library for qrcode generation http://speedata.github.io/luaqrcode/
  • small layout and documentation fixes
• v1.06 (2022-10-18)
  • additional customization for vrule
  • add possibilities to ignore data fields if empty
  • allow the usage of commas within the billing info
• v1.07 (2022-10-20)
  • fix utf8 encoding für qrmode=package
• v2.00 (2023-02-28)
  • add luaqrcode to qrbill
• v2.01 (2023-07-24)
  • add full epc qrcode example
  • improve documentation
  • disable hyperlink if qrmode=package and hyperref is loaded
  • support icons with epc qrcodes
  • fix icon alignment for qrmode=lua
  • update luaqrcode library