In diesem Artikel
Ab dem 21. November 2025 müssen die Adressinformationen für QR-Rechnungen in strukturierter Form bereitgestellt werden. Ohne eine strukturierte Adresse kann die Zahlung nicht verarbeitet werden.
Im Hinblick auf diese Änderungen:
- Es wurde eine neue Version von Banana Buchhaltung+ (ab Version 10.2.2) mit gezielten Aktualisierungen zur Verwaltung strukturierter Adressen veröffentlicht.
- Die Erweiterungen zum Drucken von Rechnungen mit QR-Zahlteil wurden aktualisiert und verwenden nun ausschliesslich strukturierte Adressen.
- Die erforderlichen Änderungen für die Benutzer sind minimal: Es genügt, Banana Buchhaltung+ zu aktualisieren.
Änderungen und Aktualisierungen in Banana Buchhaltung Plus
Ab Version 10.2.2 enthält Banana Buchhaltung+ die folgenden Änderungen:
- Neues Feld Hausnummer im Adressbereich der Dateieigenschaften (Stammdaten).
- Neue Spalte Hausnummer in der Tabelle Konten (Ansicht 'Adresse').
- Neue Spalte Hausnummer in der Tabelle Kontakte der Anwendung Offerten und Rechnungen.
Die Verwendung des Feldes 'Hausnummer' ist optional. Die Eingabe von Strasse und Hausnummer in einer einzigen Adresszeile bleibt zulässig, sofern das Feld 'Hausnummer' leer bleibt.
Wurde bisher die Spalte 'Extra' (XML-Name: AddressExtra) zur Eingabe der Hausnummer verwendet, muss diese nun in das neue, dafür vorgesehene Feld (Haus-Nr.) übertragen werden. Die Spalte 'Extra' darf künftig nicht mehr zur Eingabe der Hausnummer verwendet werden.
Es wird empfohlen, die ersten Ausdrucke sorgfältig zu prüfen, um sicherzustellen, dass die Adresse sowohl im Briefkopf als auch im QR-Code korrekt dargestellt wird.
Änderungen und Aktualisierungen in den Erweiterungen
Um strukturierte Adressen zu unterstützen, wurden die folgenden Erweiterungen aktualisiert:
- Erweiterung Rechnungslayout mit Schweizer QR-Code [CH10]
- Erweiterung Brief mit QR Schweiz
- Erweiterung Serienbriefe mit QR-Rechnung
- Erweiterung Offerten- und Rechnungsdialog
Die vorgenommenen Änderungen betreffen ausschliesslich den Druck und die Zusammensetzung der strukturierten Adresse.
Die Zeilen der strukturierten Adresse im QR-Code sind wie folgt aufgebaut:
- Zeile 1: Firmenname oder Vor- und Nachname des Kunden
- Obligatorisch, maximal 70 Zeichen
- Zeile 2: Strasse / Postfach
- Optional, maximal 70 Zeichen
- Kann die Hausnummer enthalten, sofern diese nicht in Zeile 3 steht.
- Zeile 3: Hausnummer
- Optional, maximal 16 Zeichen
- Nur verwenden, wenn die Hausnummer nicht bereits in Zeile 2 enthalten ist.
- Zeile 4: Postleitzahl
- Optional, maximal 16 Zeichen
- Zeile 5: Ort (Ortsname)
- Obligatorisch, maximal 35 Zeichen
- Zeile 6: Ländercode
- Obligatorisch, maximal zwei Zeichen
- Gemäss ISO-Standard 3166-1 (z.B. CH, DE, ...).
So erfassen Sie Adressen in den Tabellen 'Konten' und 'Kontakte'
Die Hausnummer kann entweder in der Spalte Strasse oder in der Spalte Hausnummer eingetragen werden. Beide Varianten sind korrekt.
Die Spalte Hausnummer akzeptiert beliebige Zeichen mit einer maximalen Länge von 16 Zeichen:
Die Spalte Strasse akzeptiert beliebige Zeichen mit einer maximalen Länge von 70 Zeichen.
Aktualisierung von benutzerdefinierten Erweiterungen für das Rechnungslayout CH10
Wenn Sie eine benutzerdefinierte Erweiterung verwenden – zum Beispiel ein angepasstes Rechnungslayout CH10, das Sie für den Rechnungsdruck verändert haben – müssen Sie prüfen, ob die Adressen im QR-Code im strukturierten Format (S) gedruckt werden.
Da es sich um eine benutzerdefinierte Erweiterung handelt, hat Banana keinen Zugriff auf den entsprechenden Code und kann diesen nicht automatisch anpassen. Daher kann nicht garantiert werden, dass die strukturierten Adressen korrekt gedruckt werden.
So überprüfen Sie, ob die Adressen im QR-Code im strukturierten Format (S) erscheinen:
- Öffnen Sie das Dialogfenster Rechnungen ausdrucken.
- Wählen Sie Ihr angepasstes Layout und klicken Sie auf Einstellungen.
- Aktivieren Sie die Option Rechnung JSON anzeigen (ganz unten) und bestätigen Sie mit OK.
- Klicken Sie erneut auf OK, um die Rechnung zu drucken.
- Vor dem Rechnungsdruck erscheint ein Fenster mit den JSON-Daten der Rechnung. Scrollen Sie nach unten zum Abschnitt QR Code text und prüfen Sie, ob vor beiden Adressen zwei "S" erscheinen.
- Wenn zwei "S" angezeigt werden, bedeutet das, dass die Adressen bereits im strukturierten Format vorliegen – es ist keine weitere Aktion erforderlich.
- Wenn ein oder zwei "K" erscheinen, bedeutet dies, dass eine oder beide Adressen vom Format-Typ "Kombiniert" sind und daher angepasst werden müssen. In diesem Fall haben Sie zwei Möglichkeiten:
- Einstellungen Ihres benutzerdefinierten Layouts anpassen:
- Im Abschnitt QR-Code > Zahlbar an: Aktivieren Sie das Feld und tragen Sie die Adressinformationen in die folgenden Felder ein: Name, Adresse, Hausnummer, Postleitzahl, Ort, Ländercode.
- Im Abschnitt QR-Code > Kunden-Adress-Typ: Klicken Sie mit der rechten Maustaste in den rechten Bereich, um die Auswahlliste zu öffnen, und wählen Sie den Typ "S" (Strukturiert) aus.
- In der Tabelle Konten/Kontakte: Tragen Sie die Hausnummer wahlweise in die Spalte Strasse (Strasse und Hausnummer in einem Feld), oder getrennt in die Spalte Extra ein.
- Wichtig: Die Spalte 'Extra' darf ausschliesslich für die Hausnummer verwendet werden – nicht für andere Informationen.
- Benutzerdefinierte Erweiterung neu erstellen (kompilieren):
- Öffnen Sie den Link zum neuen Code swissqrcode.js
- Speichern Sie die angezeigte Seite unter dem Namen swissqrcode.js
(achten Sie darauf, den Dateinamen nicht zu ändern!). - Ersetzen Sie die Datei swissqrcode.js in Ihrer bisherigen Erweiterung durch die neu heruntergeladene Version.
- Erstellen Sie das .sbaa-Paket Ihrer benutzerdefinierten Erweiterung neu.
- Deinstallieren Sie die alte Erweiterung und installieren Sie die neue Version.
- Einstellungen Ihres benutzerdefinierten Layouts anpassen:
Hinweis: Wenn Sie die neue Spalte Hausnummer und/oder die Spalte Extra für andere Informationen verwenden möchten, müssen Sie Ihre benutzerdefinierte Erweiterung entsprechend aktualisieren:
Laden Sie den neuen CH10-Erweiterungscode online herunter und passen Sie ihn Ihren Bedürfnissen an.
QR-Code testen
Die PDF-Dateien der Rechnungen mit QR-Code können über die offizielle Validierungsseite wie folgt getestet werden:
- Erstellen und speichern Sie die QR-Rechnung als PDF-Datei.
- Öffnen Sie die offizielle Seite 'Validator für QR-Rechnung': https://www.swiss-qr-invoice.org/validator.
- Ziehen Sie die PDF-Datei in den blauen Bereich auf der Webseite.
Bei korrektem QR-Code wird der Inhalt des QR-Codes angezeigt. Wenn Probleme vorliegen, werden diese in Rot dargestellt.
Erscheinen keine roten Meldungen, gilt der QR-Code als korrekt.
Adressschema für Schweizer QR-Rechnungen
Strukturierte Adresse:
<Cdtr>
<AdrTp>S</AdrTp>
<Name>Banana.ch SA</Name>
<StrtNmOrAdrLine1>Via la Santa</StrtNmOrAdrLine1>
<BldgNbOrAdrLine2>7</BldgNbOrAdrLine2>
<PstCd>6962</PstCd>
<TwnNm>Viganello</TwnNm>
<Ctry>CH</Ctry>
</Cdtr>Strukturierte Adresse mit "Toleranz":
<Cdtr>
<AdrTp>S</AdrTp>
<Name>Banana.ch SA</Name>
<StrtNmOrAdrLine1>Via la Santa 7</StrtNmOrAdrLine1>
<PstCd>6962</PstCd>
<TwnNm>Viganello</TwnNm>
<Ctry>CH</Ctry>
</Cdtr>Hinweise:
- Strukturierte Adresse (Standardregel)
- Es ist nicht erlaubt, eine strukturierte Adresse mit dem Element "AdrLine" zu kombinieren.
- Strukturierte Adresse mit "Toleranz"
- Die Hausnummer darf alternativ im Element "StrtNm" (Strassenname) erfasst werden – anstelle von "BldgNb" (Hausnummer).
CAMT-Bankauszüge (ISO 20022)
Die Erweiterung Bankauszug Camt ISO 20022 Schweiz (Banana+) verwendet bereits das aktuelle Format CAMT ISO 20022 V2019, welches die Verwendung strukturierter Adressen unterstützt.
Zahlungsaufträge pain.001
Ab dem 21. November 2026 müssen Adressen in pain.001-Zahlungsdateien ausschließlich in strukturierter oder hybrider Form übermittelt werden. Die Übermittlung in diesen Formaten ist bereits ab dem 21. November 2025 möglich.
Im Hinblick auf diese Änderungen wurde eine neue Version der Erweiterung veröffentlicht, die derzeit nur im Beta-Kanal verfügbar ist. Sie integriert den SPS 2025-Standard und ermöglicht das Versenden von Zahlungsaufträgen mit hybriden Adressen.
Adressschema für Zahlungen
Strukturierte Adresse:
Schweiz SIX | Europa EPC |
| |
Hybride Adresse:
Schweiz SIX | Europa EPC |
| |
Ressourcen
- SIX – Swiss Implementation Guidelines
Richtlinien zur korrekten Verwendung der QR-Rechnung in der Schweiz. - SIX – Schweizer Zahlungsschema für Adressen
Definition und Struktur der Adressdaten im Rahmen des Schweizer Zahlungsverkehrs. - EPC – European Payments Council Adressschema
Europäische Standards für die Adressstruktur im SEPA-Zahlungsverkehr.