Skip to content

About

GiroCode (EPC-QR-Code für SEPA-Überweisungen) automatisch in LibreOffice-Writer-Rechnungen einfügen – Platzhalter-Rahmen, PDF-Export per Icon, für Kleingewerbe & Freiberufler

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

writer-girocode

English summary: Adds a GiroCode (EPC QR code for SEPA credit transfers) to invoices written in LibreOffice Writer. Place an empty frame named GIROCODE in 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.

Beispiel-Rechnung mit GiroCode

So funktioniert's

  1. 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.

  2. 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.py auf.
  3. 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.

  4. 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.

Voraussetzungen

  • 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.

Installation

git clone https://github.com/minlux/writer-girocode.git
cd writer-girocode
./install.sh

install.sh

  • legt .venv/ an und installiert pypdf und segno,
  • kopiert config.example.json nach config.json (bitte anpassen),
  • verlinkt das Makro nach ~/.config/libreoffice/4/user/Scripts/python/. Ein abweichendes Profil lässt sich mit LO_USER_DIR=… ./install.sh angeben.

Danach LibreOffice komplett neu starten.

Konfiguration (config.json)

{
  "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.

Icon in der Symbolleiste

Extras → Anpassen… → Reiter „Symbolleisten"

  1. Oben rechts als Ziel „LibreOffice Writer" wählen, nicht das aktuelle Dokument.
  2. Links bei Kategorie: LibreOffice-Makros → Meine Makros → girocode_export → extended_pdf_export auswählen und mit dem Pfeil hinzufügen.
  3. Rechts Ändern → Symbol ändern… bzw. Umbenennen…, z. B. „PDF + GiroCode".

Optional im Reiter Tastatur auch ein Tastenkürzel vergeben.

Platzhalter-Rahmen anlegen

  1. Einfügen → Rahmen → Rahmen…. Ein Textfeld oder Bild geht auch.
  2. 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.
  3. 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.

Kommandozeile

./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.

Ausprobieren und Tests

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.

Windows / macOS (ungetestet)

  • 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.py nicht wie unter Linux. Dort das Makro kopieren und in girocode_export.py den Pfad PYTHON auf .venv\Scripts\python.exe anpassen.

Technische Details

Siehe DESIGN.md.

Lizenz

MIT, siehe LICENSE.

About

GiroCode (EPC-QR-Code für SEPA-Überweisungen) automatisch in LibreOffice-Writer-Rechnungen einfügen – Platzhalter-Rahmen, PDF-Export per Icon, für Kleingewerbe & Freiberufler

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages