Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog

SwissQR-Code lesen in Zapier

SwissQR-Code lesen ist ein Zapier Aktion durch PDF4me das entschlüsselt QR-Rechnung eingebettet in ein PDF und gibt Gläubiger, Schuldner zurück, IBAN, Betrag und Referenzdaten als JSONNutzen Sie es, um Rechnungen automatisch umzubenennen, Zahlungen Buchhaltungsdatensätzen zuzuordnen oder Dokumente anhand von Betrag oder Referenz weiterzuleiten, ohne dass eine manuelle Dateneingabe erforderlich ist.

Verwandte Blog-Beiträge(1)

Was diese Aktion bewirkt

PDF4me SwissQR-Code lesen braucht einen PDF enthaltend Schweizerisch QR-Rechnung (QR-Rechnung) und gibt seine strukturierten Zahlungsdaten innerhalb eines Zaps zurück. Map the Dateiund die Aktion kehrt zurück Dokumenttext, A JSON Zeichenkette mit IBANGläubiger, Endgläubiger, Schuldner, Betrag, Währung und Referenzfelder. Mit einem Code analysieren. Zapier Schritt zur Steuerung der Umbenennung von Rechnungen, des Zahlungsabgleichs oder der Automatisierung der Buchhaltung.

Authentifizierung Ihres API Anfrage​

Um auf die PDF4me Web API durch ZapierJede Anfrage muss die entsprechenden Authentifizierungsdaten enthalten.

Get your API Key

Wichtige Fakten, die Sie nicht verpassen sollten​

Doc Text ist ein JSON Zeichenkette, nicht einzelne Felder
Die Aktion gibt ein Feld zurück. Dokumenttext, wobei die gesamte dekodierte Nutzlast als JSON Zeichenkette. Sie benötigen einen Code von Zapier (JavaScript ausführen) Schritt zu JSON.parse es vor der Zuordnung einzelner Werte wie IBAN oder ud_NameDie
Feldnamen verwenden die Präfixe cr_/ucr_/ud_
cr_ ist der Gläubiger, ucr_ ist der letztendliche Gläubiger (oft leer), und aus_ ist der letztendliche Schuldner, der den Schweizer Zahlungsnormen entspricht (SPC) Feldbenennung. cr_Name Und ud_Name sind die beiden Felder, die in den meisten Workflows verwendet werden.
Verwenden Sie die Originaldatei für die PDFnicht die Ausgabe dieser Aktion.
Das Lesen eines SwissQR-Codes liefert Daten über den PDFEs besteht die Prüfung nicht. PDF sich selbst und weiter beziehen. Immer wieder darauf verweisen. Datei von Ihrem Auslöser für jeden Upload-Datei-, E-Mail- oder Speicherschritt.
Zapier-Aktion „SwissQR-Code lesen“: Aktionsfeld mit den Feldern „Datei erforderlich“ und „Dateiname optional“ einrichten

Aktionsbereich einrichten: Nur die Datei ist erforderlich, der Dateiname ist optional.

Parameter​

Erforderlich in der Zapier UI: Datei. Der Dateiname ist optional.

ParameterErforderlichWas es tutBeispiel
FileRequiredThe PDF containing the Swiss QR-bill to decode. Map from your trigger or a previous step.1. File
File NameOptionalName for the response file. If left blank, the name is picked from the source URL.invoice.pdf

Ausgabe​

Die Aktion gibt Dateimetadaten sowie ein Nutzdatenfeld zurück. Dokumenttext, A JSON Zeichenkette. Analysiere sie, um die einzelnen Schweizer zu erhalten. QRDie Rechnungsfelder sind unterhalb der Tabelle aufgeführt.

FeldTypWas es enthält
File NameStringName of the generated response file, from File Name or picked from the source URL.
File ExtensionStringExtension of the response file, .json.
Full File NameStringComplete filename including extension.
File Alternate UrlStringURL to the generated JSON response file.
Document IdStringUnique identifier for this processing run.
File SizeNumberSize of the response file in bytes.
Doc TextString (JSON)The decoded Swiss QR-bill payload as a JSON string. Parse it to reach IBAN, creditor, debtor, amount, currency, and reference fields.

Dokumenttextfelder (nach JSON.parse)​

FeldWas es enthält
QRType, Version, CodingTypeSwiss Payment Standards header data identifying this as an SPC QR payload and its version.
IBANCreditor IBAN the payment settles to.
cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_CountryCreditor (biller) name and address.
ucr_Name, ucr_StreetOrAddressLine1, ucr_PostalCode, ucr_City, ucr_CountryUltimate creditor fields, populated only when the creditor differs from the ultimate payee.
Amount, CurrencyPayment amount and currency (CHF or EUR).
ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_CountryUltimate debtor (payer) name and address.
ReferenceType, ReferenceReference type (QRR, SCOR, or NON) and the reference number itself.
UnstructuredMessage, BillingInfoFree-text payment message and structured billing information, when present on the bill.

Wie richte ich das Lesen von SwissQR-Codes ein? Zapier?​

  1. Hinzufügen PDF4me als Aktions-App in Ihrem Zap auswählen SwissQR-Code lesenDie
  2. Verbinden Sie Ihr PDF4me Konto erstellen oder eine bestehende Verbindung auswählen.
  3. Karte Datei an die Schweizer QR-Rechnung PDF von Ihrem Auslöser oder einem vorherigen Schritt. Optional zuordnen DateinameDie
  4. Testen Sie den Schritt und prüfen Sie ihn. Dokumenttext Im Datenausgabe-Panel ist es ein JSON Zeichenkette.
  5. Füge ein Code von Zapier (JavaScript ausführen) Schritt, der Dokumenttext empfängt, wird ausgeführt JSON.parseund gibt das benötigte Feld zurück (ud_Name, cr_Name, IBAN, Referenz(oder andere).
  6. Ordne den geparsten Wert zu Datei hochladen (zum Umbenennen), ein Filter oder Wege Schritt (für die Weiterleitung) oder eine Tabellenkalkulations-/Buchhaltungsaktion.

Was ist die Schweiz? QR-Bill und warum braucht es einen speziellen Leser?​

Die Schweizer QR-Rechnung (QRDas Schweizer Zahlungsverkehrsnormen-Format (Rechnung) ist seit dem 30. September 2022 der einzig gültige Zahlungsbeleg in der Schweiz und ersetzte die alten orangefarbenen und roten Belege. Es kodiert Gläubiger, Schuldner, IBAN, Betrag und Referenzdaten innerhalb eines QR Code, der den SPC (Schweizer Zahlungscode)-Struktur, eine feste Feldreihenfolge, die ein generischer Barcode oder QR Der Scanner liest den Text als Rohdaten, kann ihn aber keinen benannten Feldern zuordnen. Der SwissQR-Code wird dekodiert. SPC Struktur und gibt sie als benannt zurück JSON Felder.

Typische Konfigurationen​

Workflow-BeispieleCommon Zapier patterns using Read SwissQR Code.
Rechnungen automatisch nach Schuldnernamen umbenennen
  1. Auslöser für eine neue Datei im Ordner (Dropbox, Google Drive, SharePoint) feuert auf einem neuen Schweizer QR-Rechnung PDFDie
  2. Der SwissQR-Code wird mit der vom Trigger zugeordneten Datei und dem Dateinamen ausgeführt und gibt den Dokumenttext zurück.
  3. Ein Code von Zapier Schritt analysiert Dokumenttext und gibt ud_Name (den Schuldner) zurück.
  4. Datei hochladen speichert dasselbe PDF Inhalte mit dem analysierten Namen, sodass Dateien vom Zahler durchsuchbar sind.
Gleichen Sie eingehende Zahlungen mit den Buchhaltungsunterlagen ab.
  1. Ein E-Mail- oder Ordner-Trigger liefert eine Schweizer QR-Rechnung PDFDie
  2. Der SwissQR-Code-Leser extrahiert den Dokumenttext und anschließend den Code. Zapier Schrittanalysen IBANBetrag und Referenz.
  3. Ein Suchschritt in einem Buchhaltungssystem (QuickBooks, Xero oder einer benutzerdefinierten Datenbank) gleicht die Referenz mit einer offenen Rechnung ab.
  4. In einem Folgeschritt wird die Rechnung als bezahlt markiert und die Transaktion protokolliert.
Route nach Betrag oder Referenztyp
  1. Der SwissQR-Code wird auf einer eingehenden Rechnung gelesen und gibt den Dokumenttext zurück.
  2. Ein Code von Zapier Schritt analysiert Betrag und Referenztyp.
  3. Ein Paths-Schritt leitet Zahlungen mit hohem Wert an eine Warteschlange für manuelle Genehmigung weiter und QRR-Bezugszahlungen auf die automatisierte Verbuchung.

Praktische Tipps​

Doc Text always needs a parse step
There is no built-in field mapping for individual Swiss QR-bill values. Budget for a Code by Zapier step in every Zap that uses this action.
cr_ vs ud_ vs ucr_ is easy to mix up
cr_ is the creditor (who gets paid), ud_ is the ultimate debtor (who is paying), ucr_ is the ultimate creditor and is usually blank. Double-check which prefix your workflow actually needs.
ReferenceType tells you the reference format
QRR means a 27-digit QR reference, SCOR means a Creditor Reference (ISO 11649), NON means no structured reference, only UnstructuredMessage. Branch your parsing logic on ReferenceType if you support more than one format.
Amount can be null for open-amount bills
Some Swiss QR-bills are issued without a fixed Amount, letting the payer enter it. Handle a null or missing Amount in your Code by Zapier step rather than assuming it is always present.
The action reads, it does not validate compliance
This action decodes whatever SPC data is embedded in the QR code. It does not certify Swiss banking regulatory compliance, that responsibility stays with however the bill was originally issued.

Spickzettel​

FeldWert
ActionRead SwissQR Code
FileRequired, Swiss QR-bill PDF
File NameOptional
Output payloadDoc Text (JSON string)
Common parsed fieldsIBAN, cr_Name, ud_Name, Amount, Currency, Reference
Parse step neededCode by Zapier, JSON.parse(Doc Text)
Counterpart actionCreate SwissQR Bill (generates the QR-bill instead of reading it)

Häufig gestellte Fragen​

What does Read SwissQR Code actually return?+
The action returns Doc Text, a JSON string containing the decoded Swiss QR-bill fields: QRType, Version, CodingType, IBAN, creditor fields (cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_Country), ultimate creditor fields (ucr_*), Amount, Currency, ultimate debtor fields (ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_Country), ReferenceType, Reference, UnstructuredMessage, and BillingInfo. It also returns file metadata (File Name, File Extension, Full File Name, File Alternate Url, Document Id, File Size) for the generated JSON response file.
Do I need a separate step to parse the output?+
Yes. Doc Text is a single JSON string, not individually mapped fields. Add a Code by Zapier (Run JavaScript) step, run JSON.parse on the Doc Text value, and return the specific field you need such as data.ud_Name or data.IBAN so later steps in the Zap can map it directly.
What is the Swiss QR-bill and why does it need a special reader?+
The <a href="https://www.six-group.com/en/products-services/banking-services/payment-standardization/qr-bill.html" target="_blank" rel="noopener noreferrer">Swiss QR-bill (QR-Rechnung)</a> is the Swiss Payment Standards format that became the only valid Swiss payment slip on 30 September 2022. It encodes structured payment data (IBAN, creditor, debtor, amount, reference) inside a QR code using the SPC data format, a fixed field order that a generic barcode or QR scanner cannot parse into named fields without knowing that structure.
Can I use the extracted data to rename or route the PDF?+
Yes. A common pattern parses Doc Text for ud_Name (debtor) or cr_Name (creditor) and uses that value as the filename in an Upload File step, or checks Reference or Amount in a Filter or Paths step to route the invoice. Use the original File field from your trigger for the file content, this action's output only carries data, not the PDF. See <a href="https://www.iso20022.org/" target="_blank" rel="noopener noreferrer">ISO 20022</a> for background on the structured payment messaging standard the Swiss QR-bill builds on.

Verwandte Aktionen​

Branchenspezifische Anwendungsfälle und Anwendungen​

  • ZahlungsabwicklungLesen Sie SwissQR-Codes für die automatisierte Zahlungsabwicklung und Transaktionsverwaltung.
  • Transaktionsmanagement: Zahlungsdaten für eine umfassende Transaktionsverarbeitung und Abstimmung extrahieren
  • Compliance-Berichterstattung: Füge die dekodierten Referenz- und Betragsdaten in die internen Prüfprotokolle ein.
  • KundendienstKundenzahlungen und -anfragen mit automatisierter SwissQR-Code-Erkennung verarbeiten

Hilfe erhalten​

Zapier IntegrationGet your API KeyZapier Documentation