Der schnellste Weg
Lies https://wirdrei.digital/workflows/rechnungen-mit-qr.md und richte diesen Workflow bei mir ein. Frag mich nach den Angaben, die dir fehlen. Hol meine Freigabe ein, bevor du Dateien änderst, Software installierst, Zugangsdaten speicherst oder eine externe Aktion auslöst.
Was du brauchst
Ein Assistent mit Zugriff auf Dateien und Programme, zum Beispiel Claude Code, Codex oder opencode. Ein normaler Browser-Chat reicht nicht.
Deine IBAN. Für eine QR-Referenz brauchst du eine QR-IBAN von deiner Bank. Mit einer normalen IBAN verwendest du eine unstrukturierte Mitteilung oder eine SCOR-Referenz.
Die Anleitung
Die folgenden Schritte richten sich an deinen Assistenten. Du kannst mitlesen und gibst
Änderungen frei.
Arbeitsordner anlegen
Lege im Arbeitsbereich des Nutzers einen Ordner workflows/rechnungen/ an, darin die Unterordner entwuerfe/ und versendet/, eine rechnungen.csv mit Kopfzeile zeitpunkt;nummer;datum;empfaenger;betrag_chf;ereignis und eine CONTEXT.md:
# Workflow: Rechnungen mit QR-Zahlteil
Zweck: PDF-Rechnungen mit Schweizer QR-Zahlteil erstellen, nummerieren, im Journal führen.
## Regeln
- Beträge und Positionen stammen immer vom Nutzer, nie geschätzt.
- Die Rechnungsnummer wird erst nach Freigabe vergeben, nie im Entwurf.
- Vergebene Nummern werden nie wiederverwendet, auch nicht bei Stornos.
- Journalzeilen werden nur angehängt. Für `erstellt`, `bezahlt` und `storniert` entsteht je eine neue Zeile mit derselben Rechnungsnummer. Das letzte Ereignis ist der aktuelle Status.
## Nummernkreis
(mit dem Nutzer festlegen, Vorschlag: JJJJ-NNN, also 2026-001)
Geh die Regeln mit dem Nutzer durch, besonders die Nummernvergabe. Lass sie bestätigen, bevor du das Journal anlegst.
Absender- und Bankdaten erfassen
Leg mit dem Nutzer eine workflows/rechnungen/firmendaten.md an: Firmenname, Strasse, Hausnummer, Postleitzahl, Ort, Land, IBAN oder QR-IBAN, Zahlungsfrist, falls vorhanden die MWST-Nummer und die Sätze, die er verrechnet. Speichere die Adresse in diesen einzelnen Feldern, weil die QR-Bill-Spezifikation 2.3 strukturierte Adressen verlangt. Existiert bereits eine firmendaten.md aus dem Workflow Dokumente aus Vorlage, ergänze dieselbe Datei, statt eine zweite Wahrheit anzulegen.
Werkzeug für den QR-Zahlteil einrichten
Der Schweizer QR-Zahlteil folgt der QR-Bill-Spezifikation 2.3 von SIX. Bau ihn nicht von Hand. Wähle eine gepflegte Bibliothek, die Version 2.3 ausdrücklich unterstützt, prüfe Quelle und aktuelle Release-Version und halte Paketname und Version in der CONTEXT.md fest. Erzeuge damit einen Test-Zahlteil mit den Bankdaten aus Schritt 2 und zeig ihn dem Nutzer.
Ablauf pro Rechnung
- Nutzer nennt Empfänger, strukturierte Adresse, Positionen und Beträge.
- Rechnung als Entwurf bauen: Briefkopf, Positionen, Total, MWST falls zutreffend, QR-Zahlteil unten. Noch ohne Rechnungsnummer, im Entwurf steht
ENTWURF.
- PDF in
entwuerfe/ ablegen und dem Nutzer zeigen.
- Nach seiner Freigabe: nächste Nummer aus dem Nummernkreis vergeben, finale PDF nach
versendet/JJJJ-NNN_empfaenger.pdf, Ereignis erstellt ins Journal schreiben.
- Meldet der Nutzer den Zahlungseingang, eine neue Journalzeile mit Ereignis
bezahlt anhängen. Bei einem Storno entsprechend storniert anhängen. Bestehende Zeilen bleiben unverändert.
Verifikation
Bevor die erste echte Rechnung rausgeht: eine Test-Rechnung an die eigene Firma erstellen. Prüfe sie mit dem Validator der gewählten Bibliothek und scanne den QR-Zahlteil mit der eigenen Banking-App. Vergleiche Name, strukturierte Adresse, IBAN, Betrag, Währung und Referenz mit den Quelldaten. Erst danach ist der Workflow abgenommen.