メインコンテンツへスキップ

Makeで任意の請求書PDFにスイスQRコード付き請求書を追加する:3つのモジュールからなるDropboxワークフロー

· 1分で読める
SEO and Content Writer

すべてのスイスの請求書には スイスQR紙幣 そのため、銀行や会計ソフトウェアは支払いを自動的にスキャンして処理できます。MakeとPDF4meでは、追加機能は 3つのモジュールからなるシナリオ: Dropbox ファイルをダウンロードするPDF4me スイスのQRコード紙幣を作成するDropbox ファイルをアップロードする以下のスクリーンショットは、キャンバスに表示されている実際の実行手順を示しています。10ページの請求書 /pdf4metest/Files/10 page.pdf スイスの法令に準拠した請求書となり、支払い伝票が添付され、保存されます。 /pdf4meoutput/10分以内に本番環境に対応可能。

状況の概要
1. Dropbox Download a File
Reads /pdf4metest/Files/10 page.pdf. Scheduled trigger (clock badge) is shown but any trigger works.
2. PDF4me Create Swiss QR-bill
Appends the QR payment slip to the source PDF. Currency, IBAN, creditor + debtor blocks, reference filled out.
3. Dropbox Upload a File
Writes the populated PDF to /pdf4meoutput/. File Name and Data mapped from the prior step.
要約版

Makeモジュール3つ。Dropbox ファイルをダウンロードする ソース請求書を取得します(スクリーンショットには、 YnooxTestone 繋がり、 ファイルを選択してください、 パス /pdf4metest/Files/10 page.pdfPDF4me スイスのQRコード紙幣を作成する スイス決済規格に準拠したQR請求書ページを追加します(フォーマットタイプ PDFページングオプション 初め、 通貨 CHFIBANは CH(債権者と債務者のブロックをすべて含む)。Dropbox ファイルをアップロードする 結果を書き込みます /pdf4meoutput/ ファイル設定 地図ファイル名 = 6. 名前データ = 6. 文書出力されるPDFファイルは、メール送信やスイスの銀行のモバイルアプリのQRコードスキャナーに対応しています。

出力が銀行でスキャン可能かどうかを決定する2つの要素

まず、 IBANはCHまたはLIで始まる必要があります 最大21文字です。QRR参照タイプの場合、IBANは QRコードIBAN標準IBANではありません。2番目に、 参照タイプはQRRです、 参照フィールドは、mod 10 チェックデジットを含む 27 桁の数値文字列です。; ない場合は、参照タイプを次のように設定します。 スコア (ISO 11649)または 非 参照欄は空欄のままにしてください。銀行は入力ミスのある参照値を拒否しますが、QRコード自体は拒否しません。

現実世界でよくある疑問を解決します​

人々は次のようなフレーズを使って、まさにこの問題を検索しています。

  • 「スイスのQRコード付き領収書をPDF請求書に自動的に追加するにはどうすればよいですか?」 請求書をDropboxにドロップするだけで、この3つのモジュールからなるシナリオが、IBAN、金額、参照番号、債権者/債務者の詳細など、残りの処理をすべて行います。
  • 「Makeは既存の請求書からスイスのQRコード付き請求書を生成できますか?」 はい。PDF4meの「スイスQR請求書作成」モジュールを使用します。出力は、選択したページ(最初/最後/特定ページ)に支払伝票が添付された同じPDFファイルです。
  • 「ExcelテンプレートやQRコードライブラリは必要ですか?」 いいえ。このモジュールは、QRコード生成、mod-10参照計算、およびスイス決済規格のレイアウトといったすべての処理を、単一の設定可能なステップに統合しています。
  • 「既存の請求書PDFがない場合でも、単独のQRコード付き伝票を生成することはできますか?」 はい。ファイルグループを完全にスキップすると、モジュールは独立したスイスのQRコード付き請求書PDFを返します。
  • 「スイスの銀行は実際にこの出力を受け入れるのだろうか?」 このモジュールは、ISO 20022スイス決済基準に準拠した伝票を生成します。スイスのすべての銀行のモバイルバンキングアプリでこの伝票をスキャンして、支払いを開始できます。

あなたが構築しているもの​

再利用可能な3つのモジュールからなるMakeシナリオ。トリガーが発火すると(手動、スケジュール設定、ファイル監視など)、ソース請求書が取得され、スイスのQRコード付き請求書が追加され、出力が保存されます。このパターンは、単発のテスト、スケジュール設定によるバッチ実行、または完全にイベント駆動型の請求書処理にも適用できます。

シナリオキャンバスを作成します。Dropbox の「ファイルのダウンロード」(スケジュールされた時計バッジ付き)が PDF4me の「スイスの QR 請求書の作成」に接続され、それが Dropbox の「ファイルのアップロード」に接続されます。3 つの大きな円形のモジュールアイコンが、標準の「作成」の点線コネクタで接続されています。

3つのモジュールがエンドツーエンドで動作します。Dropbox 1の時計バッジは、スケジュールされたトリガーを示しています。ユースケースに合わせて、手動またはWebhookに切り替えてください。


必要なもの​

  • 作る シナリオが開いているアカウント。 Makeアカウントを作成する 必要であれば。
  • PDF4me APIキー。 APIキーを取得してください PDF4meが接続を要求したときにそれを追加します。参照 PDF4me を接続して作成する。
  • Dropbox ソースフォルダ (例: /pdf4metest/Files/)と出力フォルダー(/pdf4meoutput/どのストレージでも同じように動作します。必要に応じて、Google Drive、OneDrive、またはSharePointに切り替えてください。
  • 請求書のPDFファイル (スクリーンショットは 10ページ.pdfオプション:ソースファイルをスキップして、支払いデータのみからスタンドアロンのQRコードスリップを生成します。
  • スイスの決済データ: a CHまたはLI IBAN、金額、通貨(CHF または ユーロ)、および債権者 + 債務者の氏名/住所ブロック。完全なフィールド参照は アクションドキュメント。

シナリオを作成する​

モジュール1:Dropbox - ファイルのダウンロード​

入力フォルダから元の請求書を取得してください。

分野この実行で使用された値
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Files/10 page.pdf
Dropbox のファイルダウンロード設定を行います。接続先を YnooxTestone に設定します。ファイルの選択方法を「ファイルを選択」に設定します。ファイルパスは /pdf4metest/Files/10 page.pdf です。キャンセルボタンと保存ボタンは下部にあります。

Dropbox ファイル設定をダウンロードします。パスピッカーを使用してファイルを選択するか、バッチ処理の場合は、 検索ファイル そしてファイルを動的にバインドする。

モジュール2:PDF4me - スイスのQRコード付き請求書を作成する​

検索する PDF4me そして選ぶ スイスのQRコード紙幣を作成するこのモジュールは 26 個のフィールドを公開します。フィールドごとの完全なリファレンス (5 つの詳細な UI スクリーンショットと Var Schneider AG、CH4431999123000889012、Pia-Maria Rutschmann-Schnyder などのサンプル値を含む) は、 MakeでSwissQR請求書を作成する アクションページ。設定する必要のある最小項目:

グループ分野価値
SourceFileDropbox - Download a File (pulls from Module 1 automatically)
OutputFormat TypePDF
OutputPaging OptionsFirst (also: Last, or a specific 1-based page number)
PaymentCurrencyCHF (or EUR)
PaymentReference TypeQRR, SCOR, or NON
PaymentLanguageEnglish / German / French / Italian
PaymentSeparator LineLine With Scissor, Only Line, or No Line
PaymentAmounte.g. 1250.00
PaymentIBANCH or LI IBAN, max 21 chars
CreditorCreditor Address TypeS (Structured) or K (Combined)
CreditorCreditor NameCompany name on the account
DebtorUltimate Debtor AddressTypeS or K

選択した住所タイプに従って、債権者と債務者の住所欄を入力し、必要に応じて参照情報、非構造化メッセージ、請求情報、AV1、AV2 パラメータを入力してください。

モジュール3:Dropbox - ファイルのアップロード​

入力済みのPDFファイルを出力フォルダに書き込む。

分野この実行で使用された値
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection as Module 1
Folder/pdf4meoutput/
FileMap (so File Name and Data come from the PDF4me step)
File Name6. Name (dynamic content from PDF4me Module 2)
Data6. Document (dynamic content from PDF4me Module 2)
Dropbox のファイルアップロード構成を作成します。接続先: YnooxTestone。フォルダ: /pdf4meoutput/。ファイル設定: マップ。ファイル名: 6 にバインド。名前 (PDF4me Create Swiss QR-bill から)。データ: 6 にバインド。ドキュメント。ヒント: ファイル名 (拡張子を含む)、例: invoice.xml。

ファイルラジオを 地図 ファイル名とデータを別々のスロットとして公開します。両方をPDF4meモジュール2の出力にバインドすることで、データが書き込まれたPDFがそのままの状態で出力されます。

保存してクリック 1回実行入力済みの請求書は以下に表示されます。 /pdf4meoutput/ 数秒以内に。


出力フォルダには何が保存されるのか​

ソースと同じ名前の単一の PDF (例: 10 page.pdf)スイスのQRコード付き請求書ページを、選択した位置に挿入します。 ページングオプション (First それを新しいページ1として配置します。 Last (末尾に追加されます)。任意の PDF ビューアでファイルを開くと、QR 請求書セクションに支払い QR コード、人間が読み取れる口座 / 支払先ブロック、金額、通貨、参照、および債権者 / 債務者の住所が表示されます。スイスの銀行アプリを QR コードにかざすと、支払いが事前入力されます。


クイックリファレンス:主要パラメータ​

IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Currency
CHF or EUR only. Anything else is rejected by the Swiss Payment Standards.
Reference Type
QRR (27-digit + mod-10), SCOR (ISO 11649), or NON. Pick once, fill Reference accordingly.
Address Type
S = structured (separate PostalCode + City). K = combined (full address in two AddressLines).
Paging Options
First, Last, or a 1-based page number. Decides where the QR-bill page lands.
AV1 / AV2
Alternative scheme parameters for eBill and similar. Format: Name AV1: UV;value;id.

トラブルシューティング​

QR-bill page is blank or the QR code is unreadable
The IBAN is invalid (must start with CH or LI, max 21 chars) or the Currency was something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Reference Type QRR but the bank rejects the reference
QRR references must be 27 digits with a mod-10 check digit. If you do not have one, switch Reference Type to SCOR (ISO 11649) or NON and leave Reference empty.
QR-bill landed on the wrong page
Adjust Paging Options. First puts the slip as the new page 1. Last appends it after the last page. Or pass a 1-based page number to insert at that position.
Creditor or Debtor address looks wrong on the slip
Mismatched Address Type. With type S, fill PostalCode + City and use AddressLine1/2 for street. With type K, leave PostalCode + City empty and put the full address into AddressLine1 + AddressLine2.
Upload writes a zero-byte file
File Name or Data in the Upload module is not bound to the PDF4me Module 2 outputs. Click the field and re-pick the dynamic content from Module 6 (PDF4me Create Swiss QR-bill).
Want a standalone QR slip without an invoice
Skip the source file entirely. Remove Dropbox Module 1, or leave the File group empty in the PDF4me module. The output is a standalone Swiss QR-bill PDF.

このパターンはいつ使用するのか​

Outgoing customer invoices
Bills that need to be Swiss-payable directly from a banking app via QR scan.
Subscription billing
QR-IBAN + 27-digit QRR reference identifies the customer or contract on every recurring run.
Bulk invoice retrofitting
When an existing PDF invoice template does not yet carry the payment slip. Append it via this scenario.
e-Bill replacements / fallbacks
For customers who prefer paper or in-app QR-scan over the electronic Bill flow.

次に読むべきもの​


よくある質問​

Do I need a special Swiss QR library or font?+
No. The PDF4me Create Swiss QR-bill module bundles QR-code generation, the QR-bill fonts (Liberation Sans), the mod-10 reference math, and the Swiss Payment Standards layout. Configure the fields, click Run, and the output is a Swiss-compliant PDF.
What is the difference between QRR, SCOR, and NON references?+
QRR is the Swiss 27-digit numeric reference with a mod-10 check digit; it requires a QR-IBAN. SCOR is the international ISO 11649 creditor reference; it works with a standard IBAN. NON means no reference is shown on the slip. useful for ad-hoc one-off payments where the debtor adds their own reference at payment time.
Can I generate a Swiss QR-bill without an existing PDF invoice?+
Yes. Skip the File group in the PDF4me module and the output is a standalone Swiss QR-bill PDF (just the payment slip, no invoice body). Useful when the debtor only needs the slip, or when your invoice body comes from a different source.
My IBAN starts with DE / FR / IT. can I still use this?+
No, Swiss QR-bills are scoped to CH and LI IBANs only. For European SEPA payments with non-Swiss IBANs, use the Generate EPC QR Code for SEPA module instead.
Address Type S vs K. which one should I pick?+
S (Structured) is the modern default: PostalCode and City go in separate fields; AddressLine1/2 carries the street. K (Combined) puts the full address in two free-text AddressLine fields and ignores PostalCode/City. New integrations should use S unless you are importing legacy data that does not separate postal code and city.
Does the output PDF work with mobile banking apps?+
Yes. Every Swiss bank app that supports payments via QR-bill (which is all of them since 2022) can scan the output to pre-fill the payment form. Test by opening UBS, PostFinance, Raiffeisen, or any Swiss banking app and scanning the QR code on the printed or on-screen slip.
How do I change where the QR-bill page lands?+
Set Paging Options. First puts the slip as the new page 1 of the output PDF, Last appends it to the end, or pass a 1-based page number to insert it at that position. Page indexing starts at 1.
Same scenario in n8n, Zapier, or Power Automate?+
Yes. The same PDF4me Create Swiss QR-bill action is available on all four platforms with identical parameters. See the cross-platform comparison at the bottom of the Create SwissQR Bill action page.

さあ始めましょう​