English summary: Adds a GiroCode (EPC QR code for SEPA credit transfers) to invoices written in LibreOffice Writer. Place an empty frame named
GIROCODEin your invoice. A toolbar macro exports the document as a tagged PDF, and a Python script reads the invoice number, amount, IBAN and BIC from the PDF and draws a vector QR code exactly where the frame sits. Customers scan it with their banking app and get a pre-filled transfer. The UI and docs are in German, since GiroCode is mainly used in the DACH region.
Rechnungen aus LibreOffice Writer bekommen beim PDF-Export automatisch einen GiroCode (EPC-QR-Code für SEPA-Überweisungen). Der Kunde scannt ihn mit seiner Banking-App, und die Überweisung ist schon ausgefüllt: Empfänger, IBAN, Betrag und Rechnungsnummer als Verwendungszweck.
-
In der Rechnung liegt ein leerer Rahmen mit dem Namen
GIROCODE. Er ist im PDF unsichtbar und legt Position und Größe des QR-Codes fest. Du siehst also schon im Writer, wo der Code landet, und kannst ihn verschieben. -
Ein Klick auf das Symbolleisten-Icon startet das Makro
extended_pdf_export. Es- speichert das Dokument,
- exportiert es als getaggtes PDF neben das ODT (
rechnung.odt→rechnung.pdf), - ruft
girocode_pdf.pyauf.
-
Das Skript liest aus der Textebene der PDF:
- Rechnungsnummer (z. B.
Rechnung Nr. RE2611041,Rechnungsnummer: 2026-001) - Betrag (z. B.
Gesamtbetrag: 1.234,56 €) - IBAN und BIC (z. B. aus der Fußzeile; Ersatzwerte aus
config.json)
Dann setzt es den QR-Code als Vektorgrafik an die Stelle des Rahmens.
- Rechnungsnummer (z. B.
-
Eine Meldung zeigt die verwendeten Werte, Warnungen oder Fehler.
Vor dem Einfügen wird geprüft: Rechnungsnummer und Betrag müssen eindeutig gefunden werden, und die IBAN muss die Prüfsumme bestehen. Schlägt etwas fehl, bleibt die PDF ohne Code; es wird nichts geraten.
- LibreOffice mit Python-Makro-Unterstützung. Unter Debian/Ubuntu ist sie ein eigenes
Paket:
sudo apt install libreoffice-script-provider-python - Python ≥ 3.9
- Getestet unter Linux (Ubuntu 24.04, LibreOffice 24.2). Windows und macOS sollten mit angepassten Pfaden funktionieren (siehe unten), sind aber ungetestet.
git clone https://github.com/minlux/writer-girocode.git
cd writer-girocode
./install.sh
install.sh
- legt
.venv/an und installiertpypdfundsegno, - kopiert
config.example.jsonnachconfig.json(bitte anpassen), - verlinkt das Makro nach
~/.config/libreoffice/4/user/Scripts/python/. Ein abweichendes Profil lässt sich mitLO_USER_DIR=… ./install.shangeben.
Danach LibreOffice komplett neu starten.
{
"name": "Max Mustermann",
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX"
}| Schlüssel | Pflicht | Bedeutung |
|---|---|---|
name |
ja | Empfänger, muss dem Kontoinhaber entsprechen (Empfängerprüfung der Bank) |
iban, bic |
nein | Ersatzwerte, falls die PDF keine enthält; bei Abweichung Warnung |
invoice_pattern |
nein | Regex für die Rechnungsnummer (genau eine Klammergruppe) |
amount_pattern |
nein | Regex für den Betrag im Format 1.234,56 (eine Klammergruppe) |
Die Standardmuster stehen oben in girocode_pdf.py (DEFAULT_INVOICE_PATTERN,
DEFAULT_AMOUNT_PATTERN). Zum Testen eigener Muster eignet sich --dry-run.
Extras → Anpassen… → Reiter „Symbolleisten"
- Oben rechts als Ziel „LibreOffice Writer" wählen, nicht das aktuelle Dokument.
- Links bei Kategorie: LibreOffice-Makros → Meine Makros → girocode_export → extended_pdf_export auswählen und mit dem Pfeil hinzufügen.
- Rechts Ändern → Symbol ändern… bzw. Umbenennen…, z. B. „PDF + GiroCode".
Optional im Reiter Tastatur auch ein Tastenkürzel vergeben.
- Einfügen → Rahmen → Rahmen…. Ein Textfeld oder Bild geht auch.
- Im Dialog einstellen:
- Typ: Größe, z. B. 3 × 3 cm, mindestens 2 cm. Bei einem nicht quadratischen Rahmen zählt die kürzere Seite, und der Code wird mittig gesetzt.
- Optionen → Name:
GIROCODE - Umrandung: keine; Fläche: keine
- Verankerung: „An der Seite" hält die Position fest, „Am Absatz" lässt den Code mit dem Text wandern.
- Den Titel (Alternativtext) setzt das Makro beim Export automatisch.
Den Rahmen am besten einmal in der Rechnungsvorlage anlegen. Pro Dokument ist genau
ein GIROCODE erlaubt; bei mehrseitigen Rechnungen landet der Code auf der Seite des
Rahmens. Der Code hat eine weiße Ruhezone und verdeckt, was darunter liegt.
./girocode_pdf.py rechnung.pdf --dry-run # nur erkannte Werte anzeigen
./girocode_pdf.py rechnung.pdf # GiroCode einfügen
./girocode_pdf.py rechnung.pdf --config andere.json
Das Skript startet sich selbst mit dem .venv neben der Datei, auch über einen
Symlink, z. B. in ~/bin. Es braucht eine PDF, die aus einem Dokument mit Rahmen
und als getaggtes PDF exportiert wurde. Ein Export ganz ohne Writer-Oberfläche:
soffice -env:UserInstallation=file:///tmp/lo-cli-profile --headless \
--convert-to 'pdf:writer_pdf_Export:{"UseTaggedPDF":{"type":"boolean","value":"true"}}' \
--outdir ausgabe/ rechnung.odt
Das eigene Profil (-env:UserInstallation) ist nötig, sonst geht der Auftrag an ein
bereits offenes LibreOffice. Beim CLI-Weg muss der Rahmen schon den Titel
GIROCODE haben, weil das Makro ihn hier nicht setzt. Dafür Eigenschaften →
Optionen bzw. Beschreibung… öffnen.
Ein zweiter Lauf auf dieselbe PDF bricht absichtlich ab („kein Platzhalter"), damit der Code nicht doppelt eingefügt wird.
example/Beispiel-Rechnung.odt ist eine Rechnung mit Fantasie-Daten und eingebautem
Rahmen. Sie wird von example/make_example.py erzeugt.
./install.sh --dev # zusätzlich zxing-cpp + pillow
.venv/bin/python tests/test_e2e.py # braucht soffice und pdftoppm (poppler-utils)
Der Test exportiert die Beispiel-Rechnung, setzt den Code ein, liest ihn mit einem QR-Decoder wieder aus und vergleicht den Inhalt.
- Makro-Ordner: Windows
%APPDATA%\LibreOffice\4\user\Scripts\python\, macOS~/Library/Application Support/LibreOffice/4/user/Scripts/python/ - Unter Windows funktionieren Symlinks und der Shell-Shebang von
girocode_pdf.pynicht wie unter Linux. Dort das Makro kopieren und ingirocode_export.pyden PfadPYTHONauf.venv\Scripts\python.exeanpassen.
Siehe DESIGN.md.
MIT, siehe LICENSE.
