Skip to content
Sentinel 1.5 | Preview
Swiss localizationUpdated

Swiss QR-Bill in D365 Finance korrekt einrichten

Die QR-Rechnung ersetzt nicht nur ein Formular, sondern den gesamten Referenzkreislauf zwischen Rechnungssteller, Bank und Zahler. Diese Einrichtungsanleitung folgt der Reihenfolge, die im Projekt funktioniert - inklusive der Stellen, an denen die offizielle Dokumentation nicht mehr stimmt.

deOriginalsprache: Deutsch.
Author
Jeno Jegathees
Published
07 Aug 2026
Updated
09 Aug 2026
Reading time
9 min
Swiss QR-BillISO 20022Accounts payableAccounts receivableElectronic reportingSetup
Share on LinkedInShare by email
Pixel-art illustration of a Swiss QR-Bill payment slip with QR code, amount fields and bank icon

Warum die QR-Rechnung mehr ist als ein neues Layout

Mit der Ablösung von Einzahlungsschein und ESR hat die Schweiz nicht einfach ein Formular ersetzt, sondern den kompletten Referenzkreislauf zwischen Rechnungssteller, Bank und Zahlungspflichtigem neu definiert. In Dynamics 365 Finance betrifft das gleich vier Bereiche: Feature Management, Electronic Reporting (ER), die Bankeinrichtung und die Zahlungsmittel auf Kreditoren- und Debitorenseite. Wer nur einen dieser Bereiche einrichtet, bekommt am Ende ein QR-Bild, das die Bank nicht verarbeiten kann.

Dieser Artikel ist die aufgeräumte Version meiner Projektnotizen aus einem Schweizer Rollout: Reihenfolge der Einrichtung, die Stellen, an denen die offizielle Dokumentation unvollständig oder veraltet ist, und die Fehlermeldungen, die man sonst erst im Testing sieht.

Reihenfolge der Einrichtung

Die Einrichtung ist eine Kette. Jeder Schritt setzt den vorherigen voraus:

  1. Features aktivieren (QR-bills und Configurable payment ID)
  2. ER-Konfigurationen importieren (QR-Bill, ISO 20022 Credit transfer CH, pain.002, camt.054)
  3. Bankkonto mit QR-IBAN, Schweizer Adresse und Währung CHF
  4. Juristische Person mit UID/Registrierungsnummer
  5. Zahlungsmittel Kreditoren (getrennt für IBAN und QR)
  6. Zahlungsmittel und Payment ID Debitoren
  7. Testing mit echtem Zahlungsfile und QR-Scanner

1. Feature Management

Navigation path

WorkspacesFeature management

Zwei Features müssen aktiv sein:

FeatureZweck
(Switzerland) QR-billsQR-Referenz, QR-IBAN und QR-Rechnungslayout
Configurable payment IDAufbau der Referenznummer für Debitoren
Feature management mit aktivierten Features (Switzerland) QR-bills und Configurable payment ID
Feature management: (Switzerland) QR-bills aktivieren

2. Electronic Reporting

Navigation path

Organization administrationWorkspacesElectronic reporting

Die aktuellen Konfigurationen kommen aus dem Dataverse Configuration Repository (früher: Typ "Global", zusätzlich über LCS verfügbar). Zu importieren sind:

  • Swiss QR-Bill text
  • Swiss QR-Bill Structured information
  • ISO20022 Credit transfer (CH) — Ausgangszahlungen
  • ISO20022 pain.002 — Statusrückmeldung der Bank
  • ISO20022 Camt.054 — Zahlungseingänge Debitoren
Electronic reporting Workspace mit Konfigurationsanbietern
Electronic reporting: Konfigurationsanbieter und Repositories
Repository-Ansicht der Swiss QR-Bill ER-Konfigurationen
Repository: verfügbare Konfigurationen
Import der ISO 20022 und QR-Bill Konfigurationen aus dem Repository
Zu importierende Konfigurationen im Überblick
Tab Versions mit Auswahl der neuesten Konfigurationsversion
Tab Versions: neueste Version auswählen und importieren

3. Bankkonto

Navigation path

Cash and bank managementBank accountsBank accounts

  • Tab Additional identification: Feld QR-IBAN füllen (nicht die normale IBAN)
  • Tab Addresses: vollständige Schweizer Adresse hinterlegen
  • Währung: CHF
Bankkonto mit QR-IBAN im Tab Additional identification
Bank account: Feld QR-IBAN im Tab Additional identification
Schweizer Adresse und Währung CHF am Bankkonto
Bank account: Schweizer Adresse und Währung CHF

4. Juristische Person und UID

Navigation path

Organization administrationOrganizationsLegal entities

Damit die UID-Nummer korrekt auf dem QR-Einzahlungsschein erscheint, muss sie über die Registrierungslogik gepflegt werden — nicht als freier Text:

  1. Registration categories anlegen und der Kategorie "VAT ID" zuordnen
  2. Registration types definieren
  3. Registration IDs auf der juristischen Person mit der UID füllen (Tax registration number)
Registration categories der juristischen Person
Registration categories
Registration types Einrichtung
Registration types
Registration IDs mit UID der juristischen Person
Registration IDs: UID erfassen
Tax registration number auf der juristischen Person
Tax registration number

5. Zahlungsmittel Kreditoren

Navigation path

Accounts payablePayment setupMethods of payment

Pro Zahlungsart ein eigenes Zahlungsfile: eines für klassische IBAN-Zahlungen, eines für QR-Zahlungen. Beispielkopf:

FeldWert
Method of paymentDTA CHF
DescriptionDTA UBS AG
PeriodTotal
Payment statusSent
Payment typeElectronic payment
Allow copies of paymentsNo
Method of payment Kreditoren mit Zahlungsfile-Einrichtung
Accounts payable: Method of payment für QR und IBAN getrennt

Payment specification: Tp3.QR

Die Payment specification Tp3.QR wird nur für die QR-Zahlungsmethode gesetzt — beim IBAN-Zahlungsmittel bleibt das Feld leer.

Tp3.QR landet im pain.001 unter PaymentTypeInformation > CategoryPurpose und signalisiert der Bank: Zahlung auf Basis einer Swiss QR-Bill.

Beim Generieren des Files gilt zusätzlich: Referenzformat entweder NONE (keine Referenz) oder Strd (strukturierte QR-Referenz) — Mischformen führen zu Validierungsfehlern.

text
Payment file standard: pain.001.001.03.ch.02;SPS;2022
CategoryPurpose:       Tp3.QR
Reference type:        Strd
Payment specification Einrichtung am QR-Zahlungsmittel
Payment specification nur am QR-Zahlungsmittel
Payment specification mit Wert Tp3.QR
Payment specification: Tp3.QR

6. Zahlungsmittel und Payment ID Debitoren

Navigation path

Accounts receivablePayment setupMethods of payment

  • Tab File formats > Import format configuration: ISO20022 Camt.054 wählen
  • Tab Payment control für die Rechnungsprüfung konfigurieren
  • Giro report processing group für den Druck der QR-Rechnung hinterlegen

Navigation path

Accounts receivablePaymentsSetup Payment ID

Hier wird der Aufbau der Referenznummer definiert:

EinstellungWert
ModuloModulo 10 (nicht Modulo 11)
Account numberLänge der Kundenkonto-Nr.
Invoice numberLänge der Rechnungsnummer

Ergänzend: Standard-Zahlungsmittel und Payment ID über Customer groups und den Tab Payment defaults am Kundenkonto vorbelegen, damit im Tagesgeschäft nichts manuell gesetzt werden muss.

Method of payment Debitoren mit Tab File formats
Accounts receivable: Method of payment, Tab File formats und Payment control
Import format configuration mit Auswahl ISO20022 Camt.054
Import format configuration: Camt.054 auswählen
Ausgewählte Camt.054 Importkonfiguration
Camt.054 Importformat am Zahlungsmittel
Setup Payment ID mit Modulo 10
Setup Payment ID: Modulo 10, Kontonummer- und Rechnungsnummernlänge
Accounts receivable parameters, Tab Ledger and sales tax
Hierarchie 1: Accounts receivable parameters
Customer groups mit Payment ID Vorbelegung
Hierarchie 2: Customer groups
Kundenkonto, Tab Payment defaults
Hierarchie 3: Customer account, Payment defaults
Giro report processing group Einrichtung
Giro report processing group
Form setup für den QR-Rechnungsdruck
Form setup für den Beleg
Zuordnung der Giro report processing group am Zahlungsmittel
Zuordnung der Report processing group

7. Testing

Kreditoren

Navigation path

Accounts payableInvoicesInvoice journal

  1. Rechnung mit QR-Zahlungsmittel und QR-Referenz erfassen
  2. Zahlungsvorschlag erstellen, Gegenkonto Typ Bank
  3. Zahlungsfile generieren und im ER-Parameterdialog Bankkonto sowie Referenzformat prüfen
  4. Rückmeldedatei pain.002 importieren und Formatfehlercodes auswerten

Für die Gegenprobe des QR-Codes reicht ein QR-Scanner-Add-In im Browser: der ausgelesene Datensatz muss QR-IBAN, Referenz, Betrag und Adressblock exakt so enthalten, wie sie im Beleg gebucht wurden.

Debitoren

Freitextrechnung buchen, Druckziel prüfen, QR-Code scannen, anschliessend camt.054 der Bank importieren und den automatischen Zahlungsabgleich verifizieren.

Kreditorenbank anlegen mit QR-IBAN
Vendor: Bankkonto anlegen
Kreditorenbank Detailansicht
Vendor bank account: Detailfelder
Tab Payment am Kreditor mit Zahlungsmittel
Vendor: Tab Payment mit QR-Zahlungsmittel
Neues Invoice journal für die Testrechnung
Invoice journal: neue Erfassung
QR-Scanner Add-In liest den QR-Code aus
QR-Scanner Add-In: Datensatz auslesen
Import QR-Bill Dialog in der Rechnungserfassung
Import QR-Bill: ausgelesene Daten einfügen
Übernommene QR-Bill Daten auf der Rechnungszeile
Übernommene QR-Daten prüfen, Leerzeichen entfernen
Zahlungsvorschlag für die Kreditorenzahlung
Erstellung Zahlungsfile: Payment reference muss gefüllt sein
Zahlungszeile mit Payment reference
Zahlungszeile mit QR-Referenz
Gegenkonto Typ Bank in der Zahlungserfassung
Bank muss sich mit der Bank im Journal decken
Referenzformat NONE oder Strd im Generierungsdialog
Wichtig: Format NONE oder Strd
Generierung des pain.001 Zahlungsfiles
Zahlungsfile generieren: Voucher-Nummer beachten
ER-Parameterdialog beim Generieren des Files
Electronic report parameters vor dem Export
Import der pain.002 Rückmeldedatei mit Formatfehlercodes
pain.002: Formatfehlercodes zurückgeben
Auswertung der Statuszuordnung aus der pain.002
pain.002: Formatstatuszuordnung

Error Handling: die Klassiker

FehlermeldungUrsacheLösung
Error while evaluating expression for path `$CustPaymMode/PaymentType`Model Mapping mehrfach oder falsch als Default markiertNur das benötigte Mapping als Default setzen, überzählige Mappings entfernen
List is empty at `$notSentTransactions/$CustPaymMode`Zahlungsmittel am Beleg nicht gesetzt oder Payment type leerZahlungsmittel am Kunden/Kreditor vorbelegen
The payments cannot be generatedFolge der beiden Fehler obenErst Mapping bereinigen, dann Zahlungsvorschlag neu aufbauen
Referenz wird von der Bank nicht zugeordnet`Tp3.QR` fehlt oder normale IBAN statt QR-IBANPayment specification und Bankkonto korrigieren
Payment model mapping Übersicht im ER Debugging
ER Debugging: Payment model mappings prüfen
Fehlerhafte Mehrfach-Mappings im Model mapping
Mehrfach markierte Mappings sind die häufigste Fehlerquelle
Neu geladene Konfiguration nach dem Bereinigen
Setups löschen und neu laden
Camt.054 als Default for model mapping setzen
ISO20022 Camt.054: Default for model mapping = Yes
Fehlermeldung Model mapping run beim IBAN-Pfad
Fehlermeldung: Error while evaluating expression for path IBAN
Falsches Bankkonto in den Electronic report parameters
Ursache: falsches Bank account bei Functions > Import payments

Fazit

Die Swiss QR-Bill in D365 Finance ist kein Layout-Thema, sondern eine Kette aus Feature, ER-Konfiguration, Bank, UID, Zahlungsmittel und Referenzlogik. Die zwei Stellen, an denen die meisten Projekte scheitern, sind die Payment specification Tp3.QR auf der Kreditorenseite und die Payment-ID-Logik mit Modulo 10 auf der Debitorenseite. Wer beides korrekt einrichtet und das Ergebnis mit einem QR-Scanner gegen den gebuchten Beleg prüft, hat den Rest im Griff.

Quellen

  • Microsoft Learn: Swiss QR-bills (D365 Finance, Localizations Switzerland)
  • Microsoft Support: Country-specific update to support Swiss QR bills
  • Six / Swiss Payment Standards: Implementation Guidelines QR-Bill