n8nでスイスQR紙幣を作成する：2つの完全なワークフロー（既存のPDFを使用する場合と使用しない場合）
すべてのスイスの請求書には スイスQR紙幣 （スイスQR決済伝票とも呼ばれます）銀行や会計ソフトがスキャンして支払いを自動的に処理できるようにします。n8nとPDF4meは、この生成を完全に自動化します。このガイドでは、その手順を説明します。 2つの実運用可能なワークフロー1つはDropboxに保存済みの既存のPDFにQRコードを重ねて表示するもので、もう1つは背景となるPDFを必要とせず、支払いデータのみから独立したQR請求書ドキュメントを生成するものです。どちらも設定は10分以内で完了します。
ワークフローA： トリガーが作動します。Dropbox Download が取得します テスト債務AG.pdf (344 kB) PDF4me Create SwissQR Bill は以下で動作します: 入力データタイプ：バイナリデータ金額 1000、CHF、IBAN CH0200700110003765824債権者: Test AG。出力は swissqr_bill.pdf ファイルサイズは602KBです。Dropbox Uploadが結果を保存します。
ワークフローB： トリガーが発火します。PDF4me スイスQR請求書の作成は、 入力データタイプ: なし同じ支払いフィールドに加えて、完全な構造化された債権者住所。出力は n8n_swissqr02.pdf ファイルサイズは132KBです。Dropbox Uploadが結果を保存します。
の 入力データタイプ PDF4meノードのフィールドは、2つのワークフロー間の唯一の構造的な違いです。 バイナリデータ 既存の PDF がある場合 (ワークフロー A)。 なし 支払いデータのみから独立したQRコード伝票を作成したい場合（ワークフローB）。金額、IBAN、通貨、債権者名など、その他のパラメータはすべて両者で同一です。
あなたが構築しているもの
2020年に旧支払伝票規格から移行された後に発行されるスイスの請求書にはすべて、スイスQR請求書を含める必要があります。スイスQR請求書とは、IBAN、金額、通貨、債権者、およびオプションの債務者データをISO 20022形式でエンコードしたQRコードを含む標準化された支払セクションです。銀行や会計ソフトウェアは、手動で再入力することなくこれをスキャンします。このガイドで紹介する2つのn8nワークフローは、この生成ステップを自動化し、手動で操作することなくQR請求書を作成してDropboxに保存します。
一目でわかる
ワークフローA：4つのステップ
ワークフロー A: 4 つのノード、トリガーからダウンロード、SwissQR 請求書 (バイナリ データ) の作成、アップロードまで。
ワークフローB：3つのステップ
ワークフローB：3つのノード、SwissQR請求書を作成するトリガー（入力データタイプなし）からアップロードまで。ダウンロード手順は不要です。
なぜ2つの別々のワークフローなのか
ワークフローAでは、ブランドロゴ入りの請求書テンプレートをそのまま使用します。PDF4meは、Dropboxに保存されているPDFファイルにスイスのQRコード付き伝票を追加します。フォーマット変更、デザイン変更、手動レイアウト作業は一切不要です。
ワークフローBでは、ダウンロード手順を完全に省略します。支払いデータを入力するだけで、PDF4meがQRコード付き支払い伝票をゼロから作成します。ベースとなるPDFファイルは一切不要です。
唯一の構造上の違いは 入力データタイプ フィールド：ワークフローAではバイナリデータ、ワークフローBではなし。金額、IBAN、通貨、および債権者名は、どちらのワークフローでも同じように設定されます。
始める前に
- n8n （クラウドまたはセルフホスト）。新しい空のワークフローを作成します。
- PDF4me APIキー初回セットアップ: PDF4meをn8nに接続する。
- Dropbox n8nにおけるOAuth2認証情報。作業フォルダへの読み取りおよび書き込みアクセス権限が付与されます。
- ワークフローAのみ： Dropboxに保存されている既存のPDFファイル（例：
テスト債務AG.pdfで/ブログデータ/SwissQR/) - 支払いデータ: 有効なスイスIBAN（21文字、
CH）、金額、通貨（CHFまたはEUR）、債権者名、およびワークフローBの場合は完全な構造化された債権者住所。
ワークフローA：既存のPDFファイル上にスイスQR請求書を作成する（4ノード）
既にPDF形式の請求書や書類をお持ちの場合は、こちらをご利用ください。PDF4meは、スイスのQRコード付き請求書をファイルに重ねて表示します。
ステップ1：Dropboxから既存のPDFをダウンロードする
これまでの流れ： トリガー。
- 追加する Dropbox ノード。
- 資格情報: Dropbox OAuth2 API。
- リソース： ファイル。 手術： ダウンロード。
- ファイルパス: Dropbox 内の PDF へのパス、例:
テスト債務AG.pdfこの例ではファイルは/ブログデータ/SwissQR/) - 出力ファイルをフィールドに配置してください:
データ。 - ステップを実行します。出力パネルにファイル名が表示されます（
テスト債務AG.pdf)、ディレクトリ、MIMEタイプアプリケーション/PDFファイルサイズは344kBです。
ファイルパスで構成されたDropboxダウンロード テスト債務AG.pdf そして出力ファイルをフィールドに配置します データ出力結果から、ファイルが344kBでダウンロードされたことが確認できます。
ステップ2：ダウンロードしたPDF上でSwissQR請求書を作成する
これまでの流れ： トリガーをクリックしてPDFをダウンロードしてください。
これが重要なステップです。PDF4meはダウンロードしたPDFバイナリを読み込み、スイスのQRコード付き紙幣が添付された新しいPDFを生成します。
- 追加する PDF4me ノード。
- 資格情報: PDF4MEアカウント。
- リソース： 請求書。 請求書処理業務： SwissQR請求書を作成する。
- 入力データタイプ: バイナリデータ（前のノードからPDFを供給しているため）。
- 二元的な性質:
データ（ダウンロード手順のフィールド名と一致します。） - ファイル名：
テスト債務AG.pdf（ソースドキュメントのファイル名） - 支払い欄に記入してください。
- 額：
1000 - 通貨： スイスフラン
- IBAN:
CH0200700110003765824 - 債権者名：
テストAG
- 額：
- ステップを実行します。出力パネルには、
swissqr_bill.pdfMIMEタイプアプリケーション/PDFファイルサイズは602kB（QRコード用紙のページが埋め込まれたため、344kBから増加）。
入力データタイプがバイナリデータであるSwissQR請求書を作成します。入力はDropboxからの344kBのPDFです。出力は swissqr_bill.pdf ファイルサイズは602kBです。サイズが増加したことから、QRコードが埋め込まれていたことが確認できます。
ステップ3：結果をDropboxにアップロードする
これまでの流れ： トリガーを起動し、PDFをダウンロードし、SwissQR請求書を作成します。
- もう一つ追加する Dropbox ノード。
- 資格情報: Dropbox OAuth2 API。
- リソース： ファイル。 手術： アップロード。
- ファイルパス: Dropbox 内の宛先パス、例:
/ブログ データ/SwissQR/swissqr_bill.pdf。 - バイナリファイル: の上。
- 入力バイナリフィールド:
データ（前のステップで出力されたSwissQR請求書） - 実行してください。Dropboxは、ファイル名とパスを確認するアップロードメタデータを返します。
ワークフローAが完了しました。既存のPDFファイルにスイスのQRコード付き請求書が追加され、Dropboxに保存されました。
ワークフローB：スタンドアロンのスイスQR紙幣を作成する（3ノード）
背景となるPDFファイルがない場合にご利用ください。PDF4meは、ノードに直接入力した支払い情報から、QRコード付き支払い伝票全体を生成します。
ステップ1：背景のないPDFでSwissQR請求書を作成する
これまでの流れ： トリガー。
入力用のPDFファイルがないため、PDF4meがスイスQR請求書の完全なレイアウトをレンダリングできるように、債権者の住所をすべて入力する必要があります。
- 追加する PDF4me ノード。
- 資格情報: PDF4MEアカウント。
- リソース： 請求書。 請求書処理業務： SwissQR請求書を作成する。
- 入力データタイプ: なし（これは、PDF4me に背景 PDF のないスタンドアロンの QR スリップを生成するように指示します）。
- 支払い欄に記入してください。
- 額：
1000 - 通貨： スイスフラン
- IBAN:
CH0200700110003765824 - 債権者名：
テストAG - 債権者住所の種類: 構造化された
- 債権者の住所（番地または住所欄）：
テスト通り - 債権者建物番号:
1 - 債権者の郵便番号：
8000 - 債権者の都市:
チューリッヒ
- 額：
- ステップを実行します。出力パネルには、
swissqr_bill.pdf容量は132kBです。背景のPDFファイルがなく、QRコードのみが含まれているため、ワークフローA（602kB）よりも大幅に小さくなっています。
入力データタイプ「なし」でSwissQR請求書を作成します。PDF4meはレイアウトをゼロから生成するため、債権者の完全な住所が必要です。出力サイズは132KBです。
ステップ2：スタンドアロンQR請求書をDropboxにアップロードする
これまでの流れ： トリガーを実行してから、SwissQR請求書を作成します。
- 追加する Dropbox ノード。
- 資格情報: Dropbox OAuth2 API。
- リソース： ファイル。 手術： アップロード。
- ファイルパス:
/n8n_swissqr02.pdf（またはDropbox内の任意のパス）。 - バイナリファイル: の上。
- 入力バイナリフィールド:
データ。 - 実行してください。出力パネルにアップロードが完了したことが表示されます。
名前: n8n_swissqr02.pdf、表示パス: /n8n_swissqr02.pdf、サイズ: 132191、 そしてis_downloadable: true。
アップロード確認済み: 名前 n8n_swissqr02.pdf、 パス /n8n_swissqr02.pdfサイズ 132191 バイト、 is_downloadable: true。
ワークフローBが完了しました。単体のスイスQR請求書PDFはDropboxに保存されており、メール送信またはあらゆる送信文書への添付が可能です。
どのワークフローを選択すべきでしょうか？
| ワークフローA（既存のPDFファイルを使用する場合） | ワークフローB（スタンドアロン） | |
|---|---|---|
| Nodes | 4 (trigger + download + QR + upload) | 3 (trigger + QR + upload) |
| Input Data Type | Binary Data | None |
| Requires existing PDF | Yes (in Dropbox or another source) | No |
| Output size (example) | 602 kB | 132 kB |
| Full creditor address required | No (name only shown in example) | Yes (Structured address required for layout) |
| Best for | Adding QR slip to finished invoices or letters | Sending a separate payment slip alongside any document |
クイックリファレンス：主要パラメータ
| ノード | キー設定 | 例の値 |
|---|---|---|
| Dropbox Download (A only) | File Path + Put Output File in Field | Test Debt AG.pdf; data |
| PDF4me Create SwissQR Bill (A) | Input Data Type + Binary Property + File Name | Binary Data; data; Test Debt AG.pdf |
| PDF4me Create SwissQR Bill (A and B) | Amount + Currency + IBAN + Creditor Name | 1000; Swiss Franc; CH0200700110003765824; Test AG |
| PDF4me Create SwissQR Bill (B only) | Input Data Type | None |
| PDF4me Create SwissQR Bill (B only) | Creditor Address Type + Street + Number + Postal Code + City | Structured; Test Strasse; 1; 8000; Zurich |
| Dropbox Upload (A) | File Path + Binary File + Input Binary Field | /Blog Data/SwissQR/swissqr_bill.pdf; On; data |
| Dropbox Upload (B) | File Path + Binary File + Input Binary Field | /n8n_swissqr02.pdf; On; data |
ユースケース
月次請求書バッチ： Dropboxから請求書のPDFのリストを取得し、ループ処理します。 n8n バッチに分割 各ノードに対してワークフローAを実行し、結果を別のフォルダに保存します。1回の実行で1か月分のデータを処理できます。
データベースから動的に生成される支払伝票： 支払いリクエストが作成されたときにWebhook経由でトリガーします。PostgresまたはAirtableノードから金額、IBAN、および債権者データを取得します。ワークフローBを使用してQRコードスリップを生成し、GmailまたはOutlook経由で自動的にメールで送信します。
家賃と光熱費： 家賃、光熱費、会費などの支払い用に、毎月独立したQRコード伝票（ワークフローB）を生成します。生成された伝票はDropboxに保存し、n8nから送信されるメールに添付します。背景となるPDFファイルは不要です。
セルフホスティングおよびオンプレミス： n8nは自社インフラ上で運用できます。PDF4me API呼び出しを除き、決済データはネットワーク外に送信されることはありません。Dropboxの代わりに、オンプレミスのファイル共有やNASと組み合わせて使用できます。
よくある質問
ワークフローAとワークフローBは、それぞれどのような場合に使い分けるべきですか？
使用 ワークフローA 既に完成したPDFドキュメント（請求書、手紙、その他のファイル）にスイスのQR請求書を追加したい場合、PDF4meは既存のファイルにQRスリップを追加します。 ワークフローB 支払いデータ（IBAN、金額、債権者情報）のみがあり、QRコード付きの支払い伝票PDFを単独で作成したい場合、ワークフローBを使用すると、背景となるPDFファイルを必要とせずに、完全なドキュメントをゼロから生成できます。
スイスのQRコード請求書では、どのようなIBANフォーマットが必要ですか？
IBANは有効である必要があります スイスIBAN: 正確に 21 文字で、 CHに続いて、2桁のチェックデジットと17桁の銀行口座番号が続きます。例： CH0200700110003765824スイスのQR規格はQR-IBAN（ CH 銀行識別子には3000～3199の範囲を使用します。無効なIBANまたはスイス以外のIBANを使用すると、PDF4me APIで検証エラーが発生し、PDFが生成される前にエラーが発生します。
ワークフローBでは債権者の完全な住所が必要なのに、ワークフローAでは必要ないのはなぜですか？
入力データ型を使用する場合 バイナリデータ （ワークフロー A）では、PDF4me は既存の PDF に QR スリップを追加し、レイアウトにはソース ドキュメントの視覚的なコンテキストが含まれます。QR スリップ セクションは追加されるため、債権者の住所はオプションです。入力データ タイプを使用する場合 なし （ワークフローB）では、PDF4meが文書全体のレイアウトをゼロから生成します。スイスのQRコード規格では、単独のQR請求書には、決済システムが他の文書情報なしで処理できるように、債権者の完全な住所（番地、建物番号、郵便番号、都市）をQRコードデータに含めることが義務付けられています。
ハードコードされた値の代わりに、データベースやフォームから取得した動的な支払いデータを使用することはできますか？
はい。n8nでは、PDF4meノードのどのフィールドでも式を受け付けます。Postgresクエリ、Airtableレコード、Googleスプレッドシートの行、n8nフォームトリガーによるフォーム送信、またはWebhookペイロードなど、前のノードからAmount、IBAN、Creditor Name、Cityフィールドをマッピングします。すると、ワークフローを手動で編集することなく、各実行で現在のアイテムの固有のQR請求書が生成されます。これは、本番環境における請求業務の自動化に推奨される方法です。
PDF4meノードでエラーが発生しています。まず何をチェックすればよいでしょうか？
３つの項目を順番に確認してください。 初めAPIキーが有効であることを確認してください。 pdf4me.com そして、あなたのアカウントにはクレジットがあります。 2番ワークフローBの場合、債権者住所タイプが「構造化」であれば、債権者住所の4つのフィールド（番地、建物番号、郵便番号、市区町村）すべてが入力されていることを確認してください。いずれか1つでも入力漏れがあると、検証エラーとなります。 三番目ワークフロー A の場合、Dropbox Download ステップが正常に完了し、PDF4me ノードの Binary プロパティ名が Download ノードで設定されたフィールド名と一致していることを確認してください (両方とも データ)
トラブルシューティング
Dropbox Upload ノードは、次のフィールドを探します。 データ デフォルトではこのようになっています。Create SwissQR Billノードで異なる出力バイナリフィールド名を使用する場合は、Uploadノードの入力バイナリフィールドをそれに合わせて更新してください。この問題を回避するには、すべてのノードで同じフィールド名を使用してください。
IBANは有効なスイスIBANで、 CH （21文字）。ワークフローBでは、債権者住所タイプが構造化されている場合、債権者住所の4つのフィールド（番地、建物番号、郵便番号、市区町村）すべてを入力する必要があります。いずれか1つでも入力漏れがあると、検証エラーが発生します。
ダウンロード ノードのファイル パスを再確認してください。Dropbox のパスは、アカウントによっては大文字と小文字が区別されます。Dropbox を開き、フォルダ名とファイル拡張子を含む正確なパスをコピーしてください。ファイルがサブフォルダ内にある場合は、パスにフォルダ階層全体を含める必要があります。例: /ブログ データ/SwissQR/テスト デット AG.pdf。
見る PDF4meのトラブルシューティング APIキーの検証、残りのクレジットの確認、n8nでの認証情報の再接続の手順については、こちらをご覧ください。
次に試すべきことは？
オプション：トリガーを交換します。手動トリガーを スケジュール 月次請求実行の場合、 Webhook 支払いリクエスト作成時に発火するか、 Dropboxファイルが作成されました 新しいPDFファイルが到着したら自動的に処理する。