Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog

Erstellen Sie eine SwissQR-Rechnung in Make

Was dieses Modul bewirkt

PDF4me SwissQR-Rechnung erstellen fügt eine konforme Schweizer QR Zahlungsbeleg für eine bestehende Rechnung PDF Das Dokument enthält den vollständigen, von den Schweizer Zahlungsnormen geforderten standardisierten Abschnitt (ISO 20022Für die Rechnungsstellung innerhalb der Schweiz und Liechtensteins. Bitte senden Sie uns Ihre Rechnung. PDF, die Angaben zu Gläubiger und Schuldner, IBANDas Modul gibt nach Eingabe von Betrag und Referenznummer dasselbe Dokument mit dem beigefügten Zahlungsbeleg zurück. Jede Schweizer Bank akzeptiert diese Ausgabe zur Zahlungsinitiierung per Mobile-Banking-App.

Verwandte Blog-Beiträge(2)
Word-Dokument, Schweizer QR-Code-Rechnung und eine PDF-Datei. Zusammenführen zu einem Dokument. Sechs Module, fertig!
Szenario erstellen: Word-Datei per Dropbox herunterladen, mit PDF4me in PDF konvertieren, SwissQR-Rechnung erstellen, Basis-PDF herunterladen, PDF-Overlay einfügen, hochladen. Schritt-für-Schritt-Anleitung mit Screenshots und Bild-Meta-Tags.
Beitrag lesen →
Fügen Sie in Make einer beliebigen PDF-Rechnung einen Schweizer QR-Code hinzu: Ein Dropbox-Workflow mit 3 Modulen
Szenario mit drei Modulen: Datei per Dropbox herunterladen, PDF4me erstellt eine Schweizer QR-Rechnung, anschließend Datei per Dropbox hochladen. Fügt jeder PDF-Rechnung eine QR-Rechnungsseite gemäß den Schweizer Zahlungsstandards hinzu, die alle Felder für Gläubiger, Schuldner, IBAN und Referenz enthält. Original-Screenshots und exakte Feldwerte.
Beitrag lesen →

Authentifizierung Ihres API Anfrage​

Jeder PDF4me Modul in Make erfordert eine gültige VerbindungErstellen oder wählen Sie einen Eintrag aus, der Ihre Daten enthält. PDF4me API Schlüssel, damit das Szenario Schweizer authentifizieren kann QR Sichere Rechnungserstellung.

Get your API Key

Wichtige Fakten, die Sie nicht verpassen sollten​

Fügt Ihrem bestehenden Konto einen Zahlungsbeleg hinzu. PDF und erstellt kein eigenständiges Image
Im Gegensatz zu "Barcode erstellen", das einen zurückgibt Base64 Dieses Modul ändert Ihr Quelldokument, indem es das vollständige Schweizer Bild anhängt. QR Abschnitt der Rechnung mit einem QR Code und lesbare Zahlungsfelder direkt an die PDFSie geben Ihre Rechnungsvorlage ein, und Sie erhalten eine versandfertige Schweizer Rechnung mit Zahlungsbeleg.
Adresstyp S und K erfordern unterschiedliche Felder
Sowohl Gläubiger als auch Schuldner haben ein Feld für die Adressart: S (Strukturiert) oder K (Kombiniert). Bei S füllen Sie bitte separate Felder aus. PostalCode Und City Felder. Verwenden Sie bei K die beiden AddressLine In diese Felder geben Sie die vollständige Adresse als Freitext ein. Der gewählte Typ bestimmt, welche Adressfelder validiert werden. Füllen Sie daher nur die Felder aus, die dem gewählten Typ entsprechen.
IBAN muss aus der Schweiz oder Liechtenstein stammen und die Währung ist CHF oder EUR nur
Der Modulhinweis besagt, dass IBAN Muss mit CH oder LI beginnen und darf maximal 21 Zeichen lang sein. Die Währung ist streng beschränkt auf CHF oder EURFür Europäer SEPA Zahlungen mit Nicht-Schweizern IBANs, verwenden Sie Generieren EPC QR Code für SEPA stattdessen.

Parameter​

Das Modul stellt 26 Felder bereit, die in vier logische Blöcke gruppiert sind: Verbindung + Quelldatei, Zahlungsgrundlagen, Gläubigerblock, Schuldnerblock, Und ZahlungsreferenzDie folgenden Screenshots spiegeln die genaue Feldreihenfolge in der Make UIDie

Erforderlich (roter Stern im UI): Verbindung, Formattyp, Paginierungsoptionen, Währung, Referenztyp, Sprache, Trennlinie, Betrag IBANArt der Gläubigeranschrift, Name des Gläubigers, Endschuldner AddressTypeDie Bedingt: Dateiname + Dokument, wenn Datei auf eingestellt ist Map; Seitenzahl nur wenn die Paging-Optionen auf „“ eingestellt sind Benutzerdefiniert (Seitenzahl)Die Optional: alle verbleibenden Gläubiger-/Schuldneradressfelder zuzüglich Referenz, Unstrukturierte Nachricht, Rechnungsinformationen und AV1/AV2 Parameter.

Make Create SwissQR Bill module: Block 1: Connection, Format Type, File source, Paging Options, Currency
Block 1: Connection, Format Type, File source, Paging Options, Currency
Make Create SwissQR Bill module: Block 2: Reference Type, Language, Separator Line, Amount, IBAN
Block 2: Reference Type, Language, Separator Line, Amount, IBAN
Make Create SwissQR Bill module: Block 3: Creditor Address Type, Name, AddressLine1 and 2, PostalCode
Block 3: Creditor Address Type, Name, AddressLine1 and 2, PostalCode
Make Create SwissQR Bill module: Block 4: Creditor City, Ultimate Debtor AddressType, Name, AddressLine1 and 2
Block 4: Creditor City, Ultimate Debtor AddressType, Name, AddressLine1 and 2
Make Create SwissQR Bill module: Block 5: Ultimate Debtor PostalCode and City, Reference, Unstructured Message, Billing Info, AV1 Parameters
Block 5: Ultimate Debtor PostalCode and City, Reference, Unstructured Message, Billing Info, AV1 Parameters
ParameterErforderlichWas es tutBeispiel
ConnectionYesPDF4me connection. Click Add and paste your API key the first time, then reuse the connection across every PDF4me module.test prod account
Format TypeYesOutput container format. PDF for printable invoices and email attachments; PNG, JPEG, or TIFF for image output (no Paging Options applies in image modes). Empty falls back to the connector default. See the dropdown reference card below.PDF
FileConditionalHow the source PDF arrives. Radio: Dropbox - Download a File (or any other storage module), PDF4me Dev - Create Swiss QR Bill (chain from a prior PDF4me action), or Map (bind File Name and Document from a prior module manually). Skip the source file entirely for a standalone payment slip.Map
File NameConditionalFilename of the source PDF including .pdf extension. Required when File is set to Map. Mapped from the prior module File Name output.1. File Name
DocumentConditionalBinary content of the source PDF. Required when File is set to Map. Mapped from the prior module Data / binary output.1. Data
Paging OptionsYesWhere the Swiss QR-bill page is inserted (PDF Format Type only). Options: Empty (default), First (new page 1), Last (appended), Add page at the end (alias for Last), Custom (page number) (insert at the page number you supply in the Page Number field). See the dropdown reference card below.Custom (page number)
Page NumberConditionalThe 1-based page number where the Swiss QR-bill is inserted. Required when Paging Options is Custom (page number); ignored for every other Paging Options value. Page indexing starts at 1.3
CurrencyYesPayment currency. Only CHF and EUR are permitted by the Swiss Payment Standards.CHF
Reference TypeYesFormat of the payment reference. QRR (Swiss QR Reference, 27-digit numeric, used with QR-IBAN), SCOR (ISO 11649 creditor reference), NON (no reference).QRR
LanguageYesLanguage for the printed QR-bill text (Payment part labels: Account / Payable to, Reference, Currency, Amount). German, French, Italian, English.English
Separator LineYesSeparator line style displayed in the QR-bill section. Line With Scissor (line + scissor pictogram, standard print), Only Line (line, no pictogram), or No Line (eBill / e-invoice). Note: the Make UI labels the field "Seperator Line" (the engine accepts either spelling.Line With Scissor
AmountYesPayment amount in two decimal places without leading zeroes. Use the locale decimal separator your Culture & Language Settings expect.35345436
IBANYesIBAN or QR-IBAN of the creditor. Maximum 21 characters with CH or LI country codes only. QR-IBAN required when Reference Type is QRR.CH4431999123000889012
Creditor Address TypeYesAddress format for the creditor: S (Structured, separate PostalCode and City fields) or K (Combined, two free-text AddressLine fields).S
Creditor NameYesCreditor name or company according to the bank account. Maximum 70 characters.Var Schneider AG
Creditor AddressLine1NoCreditor primary address line. Maximum 70 characters.Var Schneider AG
Creditor AddressLine2NoCreditor secondary address line. 16 characters when address type is S; 70 characters when type is K.23
Creditor PostalCodeNoCreditor postal code. Maximum 16 characters.2501
Creditor CityNoCreditor town or city. Maximum 35 characters.biel
Ultimate Debtor AddressTypeYesAddress format for the debtor: S (Structured) or K (Combined). Same rules as Creditor Address Type.S
Ultimate Debtor NameNoDebtor name or company according to the bank account. Maximum 70 characters.Pia-Maria Rutschmann-Schnyder
Ultimate Debtor AddressLine1NoDebtor primary address line. Maximum 70 characters.Grosse Marktgasse
Ultimate Debtor AddressLine2NoDebtor secondary address line. 16 characters (S) or 70 characters (K).32
Ultimate Debtor PostalCodeNoDebtor postal code. Maximum 16 characters.9400
Ultimate Debtor CityNoDebtor town or city. Maximum 35 characters.Rorschach
ReferenceNoPayment reference number. Maximum 27 characters. Format depends on Reference Type (QRR: 27-digit numeric with mod-10 check; SCOR: ISO 11649; NON: leave empty).210000000003139471430009017
Unstructured MessageNoFree-text payment description shown in the Additional information block. Maximum 140 characters.Instruction of 15.09.2019
Billing InfoNoStructured billing information (Swico, etc) shown alongside the Unstructured Message. Maximum 140 characters.S1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106017086/40/1020/41/3010
AV1 ParametersNoAlternative scheme parameter 1 (e.g. eBill identifier). Maximum 100 characters. Convention: "Name AV1: UV;…".Name AV1: UV;UltraPay005;12345
AV2 ParametersNoAlternative scheme parameter 2. Maximum 100 characters. Same convention as AV1 when a second alternative scheme is required.Name AV2: XY;Service002;67890

Formatoptionen​

Der Make UI Es werden 5 Werte angezeigt. Wählen Sie aus. PDF für druckbare Rechnungen und E-Mail-Anhänge; die Bildformate sind nützlich, wenn Sie die Bilder einbetten. QR schlüpfen Sie in eine vorgegebene PDF später oder direkt im E-Mail-Text anzeigen.

PDF
Standard. Hybrid PDF/A-compatible page appended to the source invoice. Use with the Paging Options field below to choose where the slip lands.
PNG
Raster image of the QR-bill slip alone. Useful for inline email images or web previews.
JPEG
Compressed raster output. Slightly smaller than PNG; the QR code stays scannable.
TIFF
Lossless raster archive format. Best when the recipient needs print-grade quality.
Empty
No value set; the connector falls back to its default (PDF).

Referenz zu den Paging-Optionen​

Gilt nur, wenn Formattyp ist PDFDie Die Bildformattypen (PNG, JPEG, TIFF) Die Paginierungsoptionen werden ignoriert, da kein mehrseitiges Dokument zum Einfügen vorhanden ist.

First
Insert the QR-bill as the new page 1 of the output. The original first page becomes page 2.
Last
Insert the QR-bill at the end, after the original last page.
Add page at the end
Functional alias for Last. Picks whichever phrasing matches your downstream documentation.
Custom (page number)
Insert the QR-bill at a specific 1-based page index. Requires the Page Number field to be filled with the desired index (e.g. 3 inserts the slip as the new page 3).
Empty
No value set; the connector falls back to its default (First).

Schnellkonfiguration​

  1. Hinzufügen PDF4me Zu SwissQR-Rechnung erstellen in Ihrem Make Szenario.
  2. Wählen Verbindung (oder klicken Sie hier) Hinzufügen um einen mit Ihrem API Schlüssel).
  3. Satz Formattyp Zu PDF (oder PNG / JPEG / TIFF (für Bildausgabe). Einstellen Paging-Optionen Zu First, Last, Add page at the end, oder Custom (page number)Wenn Sie auswählen Benutzerdefiniert (Seitenzahl), füllen Sie auch aus Seitenzahl mit dem 1-basierten Index, bei dem der Gleitpunkt landen sollte (z.B. 3).
  4. Satz Datei zu einem Speichermodul wie Dropbox – Datei herunterladenoder wählen Map und binden Dateiname Und Dokumentieren aus dem vorherigen Schritt. Überspringen Sie die Dateigruppe vollständig, um eine eigenständige Datei zu erstellen. QR Ausrutscher.
  5. Füllen Sie die erforderlichen Zahlungsfelder mit den Werten aus den obigen Screenshots aus: Währung (CHF oder EUR), Referenztyp (QRR), Sprache (English), Trennlinie (Line With Scissor), Menge, IBAN (max. 21 Zeichen, CH oder LI), Art der Gläubigeranschrift (S oder K), Name des Gläubigers, Und Endgültiger Schuldner AddressTypeDie
  6. Fügen Sie die Adressfelder für Gläubiger und Schuldner hinzu und füllen Sie sie optional aus. Referenz, Unstrukturierte Nachricht, Rechnungsinformationen, Und AV1 / AV2 Parameter für umfassendere Zahlungsdaten.
  7. Speichern und ausführen. Die Modulausgabe Doc Data enthält die Quelle PDF mit den Schweizern QR-Rechnungsseite an der in Schritt 3 gewählten Position eingefügt (oder eine eigenständige QR (Fehler, wenn keine Quelldatei angegeben wurde).

Workflow-Beispiele​

Workflow-BeispieleCommon Make scenario patterns using Create SwissQR Bill.
Automatisierte Erstellung von Schweizer Rechnungen aus einem Google Sheet
  1. Das Szenario wird ausgelöst, wenn eine neue Zeile in einem Google Sheets-Rechnungsregister hinzugefügt wird.
  2. Google Drive lädt die leere Rechnung herunter. PDF Vorlage.
  3. Die Erstellung einer SwissQR-Rechnung ordnet alle Zahlungsfelder zu, einschließlich des Betrags. IBANReferenz, Gläubiger- und Schuldnerdetails, direkt aus den Spalten des Tabellenblatts.
  4. Gmail sendet die fertige Rechnung mit der Schweiz. QR Die Rechnung wurde anhand des Datenblatts an die E-Mail-Adresse des Kunden angehängt.
Monatliche Abonnementabrechnung für Schweizer Kunden
  1. Ein geplanter Auslöser wird jeweils am 1. des Monats ausgeführt.
  2. Airtable gibt alle aktiven Abonnementdatensätze zurück.
  3. Ein Iterator verarbeitet jeden Abonnenten einzeln. Die Funktion „SwissQR-Rechnung erstellen“ generiert eine personalisierte Rechnung mit dem Abonnementbetrag, den Kundendaten als Endschuldner und einer eindeutigen Referenz pro Datensatz.
  4. Gmail sendet jedem Kunden seine Rechnung. Airtable wird mit dem Sendezeitpunkt aktualisiert.
Forderungen aus Lieferungen und Leistungen: beifügen QR Rechnung ERP Genehmigung
  1. Ein Webhook wird ausgelöst, wenn eine Rechnung genehmigt wird. ERP System.
  2. HTTP lädt die genehmigte Rechnung herunter PDFDie
  3. Mit „SwissQR-Rechnung erstellen“ wird der Zahlungsbeleg mithilfe des ERP-geliefert IBAN, Betrag und Referenznummer.
  4. Die fertige Rechnung wird hochgeladen auf SharePoint Der Ordner „Debitoren“ wird erstellt und das Buchhaltungsteam wird benachrichtigt über Microsoft TeamsDie

Häufig gestellte Fragen​

What does this module actually add to my PDF?+
It appends the complete Swiss QR bill payment slip section to your existing PDF. This is a standardized block containing the QR code with all encoded payment data, plus the human-readable payment fields (amount, IBAN, reference, creditor details). The output is a ready-to-send invoice accepted by Swiss banks for payment via mobile banking app.
What is the difference between Address Type S and K?+
S (Structured) means you fill separate PostalCode and City fields alongside AddressLine1 for the street. K (Combined) means you write the complete address across two free-text AddressLine fields with no separate city or postal code. Choose whichever matches how your data is structured, since both are valid under Swiss Payment Standards.
What Reference Type should I use?+
QRR (QR Reference) is the most common and uses a 27-character numeric string with a check digit for automated bank reconciliation in Switzerland. SCOR follows the international ISO 11649 creditor reference format. NON means no reference is included. Check with your bank which format your account supports for incoming payment matching.
Why is the IBAN restricted to CH or LI?+
Swiss QR bills are a payment standard specific to Switzerland and Liechtenstein. The module hint confirms: "Max 21 characters with CH or LI only." For SEPA payments across the EU and EEA using other country IBANs, use the Generate EPC QR Code for SEPA module instead.
What does the module return?+
Name (the output filename) and Doc Data (the binary PDF buffer of your source document with the Swiss QR bill section appended). Route Doc Data into Gmail as an attachment, upload it to Dropbox or Google Drive, or POST it to your ERP system.

Verwandte Module​

Hilfe erhalten​

Make IntegrationGet your API KeyMake Documentation