kurtkeller / swiss-qr-bill

A Python library to generate Swiss QR-bill payment slips

Python library to generate Swiss QR-bills

From 2020, Swiss payment slips will progressively be converted to the QR-bill format. Specifications can be found on https://www.paymentstandards.ch/

This library is aimed to produce properly-formatted QR-bills as SVG files either from command line input or by using the QRBill class.

Command line usage example

Minimal:

$ qrbill --account "CH4431999123000889012" --creditor-name "John Doe"
  --creditor-postalcode 2501 --creditor-city "Biel"

More complete:

$ qrbill --account "CH58 0079 1123 0008 8901 2" --creditor-name "Robert Schneider AG"
--creditor-street "Rue du Lac 1268" --creditor-postalcode "2501" --creditor-city "Biel"
--extra-infos "Bill No. 3139 for garden work and disposal of cuttings."
--debtor-name "Pia Rutschmann" --debtor-street "Marktgasse 28" --debtor-postalcode "9400"
--debtor-city "Rorschach" --due-date "2019-10-31" --language "de"

For usage:

$ qrbill -h

If no --output SVG file path is specified, the SVG file will be named after the account and the current date/time and written in the current directory.

Python usage example

>>> from qrbill.bill import QRBill
>>> my_bill = QRBill(
        account='CH4431999123000899012',
        creditor={
            'name': 'Jane', 'pcode': '1000', 'city': 'Lausanne', 'country': 'CH',
        },
        amount='22.45',
    )
>>> bill.as_svg('/tmp/my_bill.svg')

Running tests

You can run tests either by executing:

$ python tests/test_qrbill.py

or:

$ python setup.py test