スイスQR紙幣を作成する n8n

このノードの機能

PDF4meスイスQR紙幣を作成する 完全準拠のスイスQR決済伝票を生成 PDF ドキュメントを通じて n8n 自動化ワークフローを提供します。 PDF バイナリデータ、base64 による請求書、 URLまたは背景文書がまったくない場合、ノードは標準化されたスイスのQR紙幣を出力します。 債権者と債務者の詳細、 IBAN参照番号、多言語ラベル、および設定可能な出力形式 単一の自動化されたステップで。すべてのスイスの銀行と完全に互換性があります。 PostFinance、およびスイス決済基準（SPS） 仕様。

関連ブログ記事(2)

Wordファイル、スイスのQRコード付き請求書、そして基本となるPDFファイル。n8nがそれらを1つに統合します。ノードは6つ。これで完了です！

n8nワークフロー：DropboxからWordファイルをダウンロードし、PDFに変換、PDF4meでスイスQRコード付き請求書を作成、ベースとなるPDFファイルをダウンロードし、オーバーレイとして結合、結果をアップロード。スクリーンショットと適切な画像メタタグを用いたステップバイステップの説明。

投稿を読む →

n8nでスイスQR紙幣を作成する：2つの完全なワークフロー（既存のPDFを使用する場合と使用しない場合）

PDF4meとDropboxを使用してスイスのQRコード付き紙幣を生成するためのn8nによるステップバイステップガイド。既存のPDFにQRコード付き紙幣を重ねる方法（4ノード）と、入力PDFを使用せずにQRコード付き紙幣をゼロから生成する方法（3ノード）の2つのシナリオを解説します。実際のスクリーンショットと正確なパラメータ値も含まれています。

投稿を読む →

認証 API リクエスト

毎 PDF4me ノード n8n 有効な 接続するための認証情報. 作成または選択して、 PDF4me API ワークフローがスイスのQRコード発行リクエストを安全に認証できるようにするためのキー。

Get your API Key

見逃してはならない重要な事実

スイスの銀行 IBAN 必須項目であり、フォーマットは厳密に検証されます。

の IBAN フィールドは有効なスイスの IBAN CHで始まり、その後に19桁の数字が続く。無効 IBAN ノードがエラーを返し、ワークフローが停止します。常に検証してください。 IBAN ノードに渡す前にフォーマットしてください。特に、データベースやフォーム入力から動的にマッピングする場合は重要です。

背景のないスタンドアロンのQR請求書を生成するには、入力データタイプ「なし」を使用してください。 PDF

入力データタイプを「なし」に設定すると、背景の請求書ドキュメントのない、クリーンで自己完結型のスイスQR請求書が作成されます。これは、支払い催促、購読料の延滞通知、および基盤となるデータがないワークフローに適したオプションです。 PDF 生成されました。出力は、選択したフォーマットタイプの、送信準備済みのQRコード付き請求書です。

自動銀行照合には構造化された住所タイプが必要です

債権者と最終債務者の両方が、構造化住所タイプと複合住所タイプを提供しています。構造化住所タイプは、通り、番地、郵便番号、都市などの構成要素を個別に保存し、QR請求書がスイスの自動銀行システムまたは支払照合ソフトウェアで処理される場合に必須となります。複合住所タイプを使用する特別な理由がない限り、常に構造化住所タイプを使用してください。

上部パネル、接続、入力タイプ、支払い詳細、および債権者住所フィールド

下部パネル、債務者住所、参照タイプ、言語、フォーマット、ページング、および出力構成

パラメータ

必須 n8n UI: 接続に使用する認証情報、入力データタイプ、金額、通貨、 IBAN、債権者名、債権者住所タイプ、最終債務者住所タイプ、参照タイプ、言語タイプ、区切り線、フォーマットタイプ、および（フォーマットタイプが PDFページングオプション。住所行、郵便番号、都市名のすべてのフィールドはオプションとしてマークされています。 UI しかし 有効なスイスQR紙幣に強くお勧めしますスイス決済基準仕様および PDF4me API これらは実運用に必要なものとして扱います。実行ペイロードは常にこれらを送信します（空白の場合は空の文字列として送信されます）。

パラメータ	必須	その機能	例
Input Data Type	Required	How to provide the input data. Options: Base64 String, Binary Data, None, URL. Default is `Binary Data`.	Binary Data
Base64 Content	Conditional	Base64 encoded content of the file to process. Shown when Input Data Type is Base64 String.	JVBERi0xLjQK...
File Name	Conditional	Input file name from the source. Shown when Input Data Type is Base64 String.	document.pdf
Binary Property	Conditional	Name of the binary property containing the file to process. Shown when Input Data Type is Binary Data. Default is `data`.	data
File Name	Conditional	Input file name from the source. Shown when Input Data Type is Binary Data.	document.pdf
File URL	Conditional	URL to the file to process. Shown when Input Data Type is URL.	https://example.com/invoice.pdf
File Name	Conditional	Input file name from the source. Shown when Input Data Type is URL.	document.pdf
Amount	Required	The amount needs to be entered without leading zeroes.	1000
Currency	Required	Currency type. Options: Euro, Swiss Franc. Default is `Swiss Franc`.	Swiss Franc
IBAN	Required	IBAN of the creditor.	CH0200700110003765824
Creditor Name	Required	The Creditor's name or company according to the account name.	Test AG
Creditor Address Type	Required	Type of the Creditor's address. Options: Combined, Structured. Default is `Structured`.	Structured
Creditor Street Name or Address Line 1	Optional	The creditor's address line with max 70 characters.	Test Strasse
Creditor Building Number or Address Line 2	Optional	The creditor's address line - For S type 16 characters and for K type 70 characters.	1
Creditor Postal Code	Optional	The Creditor's postal code with a max of 16 characters.	8000
Creditor City	Optional	The Creditor's Town/City with max 35 characters.	Zurich
Ultimate Debtor Name	Optional	Debtor's name or company according to account name.	Test Debt AG
Ultimate Debtor Address Type	Required	Debtor's address type. Options: Combined, Structured. Default is `Structured`.	Structured
Ultimate Debtor Street Name or Address Line 1	Optional	Debtor's address line with max 70 characters.	Test Deb Strasse
Ultimate Building Number or Address Line 2	Optional	Debtor's address line - For S type 16 characters and for K type 70 characters.	2
Ultimate Debtor Postal Code	Optional	Debtor's postal code.	8000
Ultimate Debtor City	Optional	Debtor's Town/City.	Zurich
Reference Type	Required	Type of payment reference on the bill: QR Reference, Creditor Reference or No Reference. The reference itself is set in Advanced Options > Reference. Options: Creditor Reference, No Reference, QR Reference. Default is `No Reference`.	No Reference
Language Type	Required	Bill language type. Options: English, French, German, Italian. Default is `English`.	English
Separator Line	Required	Separator in QR Bill. Options: Dotted Line, Line With Scissor, Solid Line. Default is `Line With Scissor`.	Line With Scissor
Format Type	Required	Output format type. Options: Empty (Null), JPEG, PDF, PNG, TIFF. Default is `PDF`.	PDF
Output File Name	Conditional	Name for the output Swiss QR Bill file. Shown when Format Type is Empty (Null).	swissqr_bill.pdf
Output File Name	Conditional	Name for the output Swiss QR Bill file. Shown when Format Type is JPEG.	swissqr_bill.pdf
Paging Options	Conditional	Where to place the Swiss QR bill page. Shown when Format Type is PDF. Options: Add Page At End, Custom, First, Last. Default is `First`.	First
Custom Page	Conditional	Custom page number (only one page allowed). Shown when Paging Options is Custom. Default is `1`.	1
Output File Name	Conditional	Name for the output Swiss QR Bill file. Shown when Format Type is PDF. Default is `swissqr_bill.pdf`.	swissqr_bill.pdf
Output File Name	Conditional	Name for the output Swiss QR Bill file. Shown when Format Type is PNG.	swissqr_bill.pdf
Output File Name	Conditional	Name for the output Swiss QR Bill file. Shown when Format Type is TIFF.	swissqr_bill.pdf
Output Binary Field Name	Optional	Name of the binary property to store the resulting Swiss QR bill file. Default is `data`.	data
Advanced Options	Optional	Optional settings, collapsed behind Add Option.	Add Option
AV1 Parameter	Optional	Alternative scheme parameter.
AV2 Parameter	Optional	Alternative scheme parameter.
Billing Info	Optional	Billing info of the customer.
Custom Profiles	Optional	Not used by this operation: the value is not added to the request sent to PDF4me.
Reference	Optional	Reference, maximum 27 characters.	NON
Unstructured Message	Optional	Unstructured Message, maximum 140 characters permitted.	Human-readable status message confirming success or describing the error encountered. Useful for logging and error notification steps.

参照

QRコードに埋め込まれた実際の参照番号。参照タイプがQRR（27桁の数字）の場合に必須の内容。 SCOR （ISO 11649 RFで始まる形式）。

非構造化メッセージ

QR請求書に印刷される自由形式の支払メモ。例：「請求書番号2024-100、支払期限11月30日」。最大140文字。 billingInfo。

請求情報

スイスのQR請求書仕様に準拠した構造化請求情報（例：請求書番号、請求書日付、VAT詳細）。最大140文字。 unstructuredMessage。

av1

代替手続きパラメータ1（AV1）。将来のスイスの代替決済手続きのために予約されています。

av2

代替手続きパラメータ2（AV2）。将来のスイスにおける代替決済手続きのために予約されています。

プロフィール

カスタム PDF4me 処理プロファイル。高度な処理や特殊なQRコード決済処理のために、事前に設定されたオプションセットを適用します。

入力データタイプのオプション

ソースの選択方法 PDF ノードに入ります。各オプションは、異なるワークフローパターンに適しています。

入力データタイプのドロップダウンメニューでは、ソースをどのように処理するかを4つのオプションで制御します。 PDF ノードに供給されます

なし背景資料なし

基となる情報のない、独立したスイスのQRコード付き紙幣伝票を生成します。 PDF支払い催促、購読通知、または請求書がない場合に使用します。 PDF ワークフローの上流に存在する。

バイナリデータ前のノードからのファイル、最も一般的なもの

読む PDF バイナリコンテンツは、以前の出力から直接取得されます。 n8n Google Drive Download などのノード、 HTTP リクエスト、またはバイナリファイルの読み取り。バイナリプロパティフィールドは、どの出力フィールドから読み取るかを指定します（デフォルト： データ)

Base64文字列Base64エンコードされたファイルコンテンツ

受け入れる PDF base64エンコードされた文字列として。ファイルが到着したときにこれを使用します。 API レスポンス、Webhookペイロード、または生のバイナリではなくbase64としてドキュメントを保存するデータベースフィールド。

URL公開リンクからダウンロード

一般にアクセス可能な URL へ PDF ファイル。 PDF4me ファイルを直接ダウンロードします URL 処理前に。 URL アクセスには認証を必要とせず、公開されている必要があります。

住所タイプのオプション

両方に適用されます 債権者住所の種類 そして 最終債務者住所の種類・QRコードデータに住所の構成要素をどのように保存するかを選択します。

構造化された推奨：住所欄を分けて記入してください

各住所構成要素をそれぞれ別のフィールドに格納します。住所行1には通り名、住所行2には番地、郵便番号、都市名をそれぞれ別々に格納します。この形式は、ほとんどのスイス銀行システムで自動支払い照合に必要であり、必須です。 PostFinance 処理中。

組み合わせ自由形式の住所行が2行

住所全体を2行の自由形式の行として格納します。例えば、1行目に「Test Strasse 1」、2行目に「8000 Zurich」と入力します。入力は簡単ですが、スイスの銀行の自動照合システムとの互換性は低くなります。構造化形式が利用できない場合にのみ使用してください。

債権者住所の種類（構造化型 vs. 複合型）

最終債務者住所タイプ（債権者と同じ選択肢）

参照タイプオプション

QRコードに埋め込まれる決済参照規格を制御します。これは、銀行システム内で決済情報と請求書がどのように照合されるかに影響します。

参照タイプ、参照なし、QRコード参照、または債権者参照

参照なしデフォルト、構造化参照なし

QRコードには支払い参照情報は埋め込まれていません。これは、照合を手動または外部システムで処理する、単純な単発支払いに使用してください。非構造化メッセージフィールドには、自由形式の支払いメモを追加できます。

QRコード参照27桁の数字、スイス銀行の照合

QRコードに27桁の数字参照（旧ESR/ISR参照と同様）を埋め込みます。これは、スイス国内のQR紙幣にリンクされる標準的な選択肢です。 PostFinance またはスイス銀行 IBANs. 銀行取引明細書との支払い照合を完全に自動化します。参照フィールドの値を指定する必要があります。

債権者照会ISO 11649国境を越えた SEPA 支払い

埋め込む ISO 11649 QRコード内の構造化債権者参照。 SEPA国境を越えた決済に対応している場合、または会計ソフトウェアで標準化されたISO参照が必要な場合に使用します。参照番号はRFで始まり、2桁のチェックサムと最大21文字の英数字が続きます。

フォーマットタイプのオプション

生成されるQRコード付き請求書のファイル形式を制御します。

書式タイプのドロップダウン、 PDF、 PNG、 JPEG、 TIFF、または空（null）

PDFデフォルト、印刷準備完了

フル忠実度で出力します PDF 印刷、メール送信、アーカイブ保存が可能な文書。請求書ワークフローにおける標準的な選択肢です。

PNGウェブおよびデジタル配信

QR請求書を出力します PNG 画像。ウェブページ、顧客ポータル、または画像形式が必要なデジタル通信への埋め込みに使用します。

JPEGメール送信に適した画像

QRコード付き紙幣を圧縮して出力します。 JPEG 画像。ファイルサイズが小さい PNGファイルサイズが重要な場合、メールへのインライン埋め込みやモバイル端末への配信に適しています。

TIFFアーカイブ品質

QRコード付き紙幣を高解像度で出力します TIFF 画像。文書管理システム、記録保存、および最大限の画像忠実度が求められるアーカイブワークフローで使用します。

空（null）生データ出力

特定のファイル形式ラッパーなしで生のQR請求書データを返します。下流のシステムが形式変換を処理する場合、または統合する場合に使用します。 API 生のバイナリデータを直接消費する。

ページングオプション

出力文書内で、既存の請求書ページに対するQRコード付き請求書の配置位置を制御します。

ページングオプション：最初、最後、最後にページを追加、またはカスタム

初めデフォルト、1ページ目にQRコード付き請求書

スイスのQRコード付き請求書を、出力文書の先頭、つまり1ページ目に配置します。QRコードによる支払いセクションを請求書の詳細の前に表示したい場合に使用してください。

最後最終ページにQRコード付き請求書

スイスのQRコード付き請求書を既存の文書の最終ページに配置します。請求書の内容を最初に表示し、新しいページを追加せずに最後に支払伝票を表示したい場合に使用します。

ページを最後に追加最も一般的な、専用のQRコード請求書ページ

請求書文書の末尾に、スイスのQRコード付き請求書を含む専用ページを新たに追加します。これはスイスの請求書自動化において最も一般的な構成で、請求書の内容は専用ページに保持され、QRコード付き支払伝票は専用のきれいなページに配置されます。

カスタム特定のページ位置

ドキュメント内でQRコード付き請求書をカスタム配置できるようにします。請求書テンプレートに、QRコード付き請求書用の予約スペースが、最初でも最後でもない特定のページまたは位置に確保されている場合に使用します。

出力

ノードが返すフィールド。

分野	タイプ	内容物
fileName	String	Value of Output File Name (empty if that field was left empty).
data	Binary	The Swiss QR bill in the chosen Format Type, stored under the Output File Name.

クイックセットアップ

1. 追加 PDF4me あなたの n8n ワークフローを設定します。 リソース に 請求書 そして 請求書処理 に SwissQR紙幣を作成する。
2. で 接続するための認証情報選択してください PDF4me 認証情報またはクリック 新しい認証情報を作成する そしてあなたの API 鍵。
3. セット 入力データタイプ: 前のノードのバイナリ出力 (バイナリデータ) を接続し、 Base64 文字列、パブリック URLまたは、QRコードのみの伝票にする場合は「なし」を選択してください。
4. 入力 額、 通貨 （スイスフランでの支払いの場合はスイスフラン）、 IBAN (有効なスイスのCH) IBAN CHから始まる）。
5. すべて記入してください 債権者 項目: 氏名、住所の種類（構造化住所を推奨）、住所1行目、住所2行目、郵便番号、および市区町村。
6. すべて記入してください 最終債務者 支払者の氏名と住所の詳細を記入する欄。
7. セット 参照タイプ （参照なしがデフォルトです） 言語タイプ （英語、ドイツ語、フランス語、またはイタリア語） 分離ライン （ライン・ウィズ・シザーズはスイスの標準規格です。）
8. 設定する フォーマットタイプ （PDF 推奨） ページングオプション （「末尾にページを追加」をクリックすると、既存の請求書にQRコード付き請求書ページを追加できます。）
9. セット 出力ファイル名 に swissqr_bill.pdf そして 出力バイナリフィールド名 に data。
10. 出力先を次のノード（メール送信、クラウドストレージへのアップロード、データベースへの書き込み）に接続し、ワークフローを実行します。

ワークフローの例

ワークフローの例Common n8n workflow patterns using Create Swiss QR Bill.

月次請求書バッチ処理 → スイスQR請求書 → 顧客へのメール送信

1. スケジュールトリガーは毎月1日に起動し、請求処理を開始します。
2. Googleドライブのノードには、すべての請求書が一覧表示されます。 PDF毎月の請求書フォルダに、顧客1人につき1通ずつ入っています。
3. 「アイテムのループ」ノードが各ファイルを反復処理します。各ファイルについて、「Googleドライブのダウンロード」ノードがバイナリコンテンツを取得します。
4. PDF4me Create Swiss QR Bill は、顧客の金額を使用して、各請求書に準拠した QR 支払い伝票を添付します。 IBAN住所はGoogleスプレッドシートの顧客レコードからマッピングされます。言語タイプはドイツ語に設定されています。ページングオプションは「最後にページを追加」です。
5. GmailノードがQR請求書を送信します PDF 各顧客へのメール添付ファイルとして送信されます。ファイル名には顧客IDが使用され、参照が容易になっています。

Eコマース注文確定 → QR請求書 → 保存先 SharePoint

1. Webhookトリガーは、eコマースプラットフォームで注文が確定した際に発火します。
2. 1 HTTP リクエストノードが請求書を生成します PDF から HTML 注文データを使用したテンプレート。
3. PDF4me Create Swiss QR Billは、準拠したQRコード付き請求書を請求書に添付します。 PDF金額と債務者の詳細は、Webhookペイロードからマッピングされます。参照タイプは、照合のために「債権者参照」に設定されています。言語タイプは、フランス語圏であるスイスのためにフランス語に設定されています。
4. マイクロソフト SharePoint ノードが完成したQR請求書をアップロードします PDF 注文アーカイブフォルダへ移動します。
5. 1 HTTP リクエストノードは、注文ステータスを「請求書送信済み」に更新します。 CRM システム。

延滞購読 → 単独QR請求書 → 支払いリマインダー

1. スケジュールトリガーは毎週月曜日の朝に起動し、期限切れの購読アカウントをチェックします。
2. PostgreSQLノードは、14日以上前の未払い残高があるすべてのアカウントを照会します。
3. アイテムループノードは、各購読者を処理します。 PDF4me スイスQR紙幣作成が、入力データタイプを「なし」に設定して呼び出されました。背景はありません。 PDFクリーンなスタンドアロンQR請求書を生成します。債務者の氏名と住所はデータベースレコードからマッピングされます。参照タイプは「参照なし」です。言語タイプはイタリア語（イタリア語圏のスイス向け）です。
4. マイクロソフト Outlook ノードは、スタンドアロンのQR請求書とともに、各加入者に支払いリマインダーメールを送信します。 PDF 添付。
5. PostgreSQLノードは、リマインダー送信のタイムスタンプをログに記録し、各アカウントのリマインダー数をインクリメントします。

よくある質問

What input formats does Create Swiss QR Bill support in n8n?+

Four Input Data Types are available. None generates a standalone QR slip with no background PDF: useful for payment reminders when no invoice document exists. Binary Data reads the PDF from a previous n8n node and is the most common option for automation pipelines. Base64 String accepts the file as a base64-encoded string for API-sourced data. URL downloads the source PDF from a public link. Binary Data is recommended for standard n8n workflows where the invoice is produced by an upstream node.

What is the difference between Structured and Combined address types?+

Structured stores address components in separate fields: street name, house number, postal code, and city. This format provides maximum compatibility with Swiss payment standards and automated bank reconciliation systems: it is required by most Swiss banking integrations. Combined stores the full address as two free-form lines, which is simpler to populate but less precise for downstream automated processing. Use Structured for all production Swiss QR bill workflows unless you have a specific reason to use Combined.

When should I use QR Reference versus Creditor Reference?+

Use QR Reference (a 27-digit numeric code starting with 0) for domestic Swiss QR bills linked to PostFinance or Swiss bank IBANs. This reference type enables fully automated payment reconciliation with bank statements and is the standard choice for Swiss invoicing. Use Creditor Reference (ISO 11649 structured reference) for cross-border SEPA-compatible payments or when your accounting system requires standardized ISO references. Select No Reference when no structured payment tracking is needed or when the reference is managed entirely outside the QR code.

Can I generate a Swiss QR bill without attaching it to an existing PDF?+

Yes. Set Input Data Type to None to create a standalone Swiss QR bill slip with no background document. The node generates a clean, self-contained QR bill in your chosen Format Type: PDF, PNG, JPEG, or TIFF. This option is correct for payment reminders, subscription overdue notices, and any workflow where no underlying invoice PDF has been produced upstream in the workflow.

What output format and paging options are available for the generated QR bill?+

Format Type supports PDF (default, recommended for print-ready documents), PNG (for digital delivery and web embedding), JPEG (for email-friendly image output), TIFF (for high-quality archival storage), and Empty or null for raw data. Paging Options controls placement within the output document: First places the QR bill on the first page, Last on the final page, Add Page At End appends a dedicated QR bill page after the invoice content, and Custom enables specific page positioning. PDF combined with Add Page At End is the most common configuration for Swiss invoice automation workflows.

関連アクション

スプリット PDF スイスQRによる

分ける PDF スイスのQRコード設置場所にある文書を、インテリジェントな一括文書整理と個々の請求書の抽出に活用します。

スイスのQRコードを読み取る

スイスのQRコードに埋め込まれた支払いデータを抽出して解析します。 PDF 自動照合およびデータ取得のための請求書。

ZUGFeRD請求書を作成する

埋め込み機能を備えた構造化電子請求書を生成する XML EU準拠の電子請求とスイスのQRコードワークフローに対応。

他のプラットフォームでの同じタスク

スイスQR紙幣を作成する（Make）

スイスのQR紙幣と同じ操作 Make モジュール、同じ SPS-準拠した支払伝票の生成、 IBAN 検証機能、およびビジュアルシナリオビルダー向けの構造化された債権者／債務者フィールド。

スイスQR紙幣を作成する（Zapier）

と同じ操作 Zapier アクションに最適 SaaS 請求プラットフォームが、Gmail、Slack、会計ツール、およびWebhook駆動パイプラインを介して、スイスQRコードによる請求書発行をトリガーする。

スイスQR紙幣を作成する（Power Automate）

Power Automate / Microsoft 365 流れに最適 SharePoint ドキュメントライブラリ、 Outlook 請求書メール、そして Dynamics スイスの企業環境における365日間の財務統合。

ヘルプが必要な場合

n8n Integration Guiden8n SampleGetting Started