跳到主要内容

在 Zapier 中将瑞士二维码账单添加到任何发票 PDF:4 步 Dropbox 工作流程

· 阅读需 22 分钟
SEO and Content Writer

每张瑞士发票都必须包含一个 瑞士二维码钞票 这样,银行和会计软件就可以自动扫描和处理付款。借助 Zapier 和 PDF4me,这一功能得以实现。 四步闪电Dropbox 文件夹中的新文件Dropbox 查找文件PDF4me 创建瑞士二维码钞票Dropbox 上传文件以下屏幕截图展示了画布中捕获的完整运行过程:一份 10 页的发票。 /pdf4metest/Swiss-RP 发票将生成符合瑞士标准的发票,并附上付款单,然后保存。 /pdf4meoutput10分钟内即可投入生产。

Zap概览
1. Dropbox New File in Folder
Watches /pdf4metest/Swiss-RP every 2 minutes. Trigger fires when a new invoice PDF lands.
2. Dropbox Find File
Resolves the file by name (10 page.pdf) and pulls the binary, ready for the next step.
3. PDF4me Create Swiss QR Bill
Appends the QR payment slip with all required SPS fields: CHF, QRR reference, English, Line with Scissor separator.
4. Dropbox Upload File
Writes the populated PDF to /pdf4meoutput. File Name and File Extension carried from the PDF4me output.
简短版

四个 Zap 步骤。Dropbox 文件夹中的新文件 手表 /pdf4metest/Swiss-RP (默认空格,包含子文件夹中的文件) 错误的包括文件内容和共享链接 是的Dropbox 查找文件 抬头 10页.pdf/pdf4metest/文件 并返回二进制文件。PDF4me 创建瑞士二维码钞票 附加符合瑞士支付标准的二维码账单页面(格式类型) PDF分页选项 第一的, 货币 充血性心力衰竭参考类型 QRR, 语言 英语分隔器 用剪刀剪线, 数量 1923.67国际银行账户 CH4431999123000889012债权人:Var Schneider AG,最终债务人:Pia-Maria Rutschmann-Schnyder,参考号 210000000003139471430009017Dropbox 上传文件 将填充后的 PDF 文件写入 /pdf4me输出 使用 3. 文件 URL, 和 3. 文件名3. 文件扩展名 作为输出名称。结果是一个瑞士银行可扫描的 PDF 文件,保存在压缩文件夹中。

决定你的输出是否符合银行扫描要求的两个因素

首先, IBAN 必须以 CH 或 LI 开头 且最多只能包含 21 个字符。对于 QRR 参考类型,IBAN 必须为 QR-IBAN,而不是标准的IBAN。其次,当 参考类型为 QRR, 这 参考字段是一个 27 位数字字符串,带有一个模 10 校验位。如果没有,请将参考类型切换为 得分 (ISO 11649)或 参考编号留空。银行会拒绝输入错误的参考编号,而不是二维码图像。

它解决了一些常见的现实问题

人们会用类似这样的短语搜索这个问题:

  • “如何在 Zapier 中自动将瑞士二维码账单添加到我的 PDF 发票中?” 这个 4 步 Zap 程序可以完成以下操作:文件上传到 Dropbox,程序运行,带有二维码的账单增强型 PDF 文件上传到输出文件夹。
  • Zapier能否根据现有发票生成瑞士二维码账单? 是的,可以通过 PDF4me 的“创建瑞士二维码账单”功能实现。输出结果与之前生成的 PDF 文件相同,只是在您选择的页面(首页、末页或指定页面)上附加了付款凭证。
  • “我需要二维码库还是瑞士二维码生成器订阅?” 不。PDF4me 操作将 QR 生成、mod-10 参考数学和完整的瑞士支付标准布局隐藏在单个 Zapier 步骤之后。
  • “如果没有源 PDF 文件,我可以生成独立的二维码吗?” 是的。跳过步骤 2(查找文件)和步骤 3 中的文件/文件 URL 字段。该操作仅根据支付数据返回一个独立的瑞士二维码账单 PDF 文件。
  • “瑞士银行会接受这种输出结果吗?” 此操作会生成符合 ISO 20022 瑞士支付标准的凭证。所有瑞士银行的手机银行应用程序都可以扫描此凭证发起支付。

你正在构建的

这是一个可重复使用的四步 Zapier Zap。触发器监视 Dropbox 文件夹,Zap 查找最新发票,运行 PDF4me Swiss QR Bill 操作,并输入债权人、债务人和付款详情,然后将增强后的 PDF 上传到输出文件夹。此模式同样适用于客户发票、计划批量运行或完全事件驱动的应收账款处理。

Zapier Zap 画布包含四个步骤:Dropbox 在文件夹中新建文件(间隔 2 分钟)、Dropbox 查找文件、PDF4me 创建 SwissQR 账单、Dropbox 上传文件。状态横幅显示“成功 2026 年 6 月 1 日下午 1:00:20”,并附有运行 ID。

从上到下共分四步。第一步的 2 分钟间隔是 Zapier 为 Dropbox 触发器设置的默认轮询频率;升级计划可以设置更高的轮询频率。


你需要什么

  • Zapier 帐户。 创建 Zapier 帐户 如果你需要的话。
  • PDF4me API密钥获取您的 API 密钥 当 PDF4me 在 Zap 编辑器中提示输入帐户时,添加它。参见 将 PDF4me 连接到 Zapier
  • Dropbox 带有源文件夹(例如 /pdf4metest/Swiss-RP)和一个输出文件夹(/pdf4me输出)。
  • 发票PDF (截图使用 10页.pdf可选:跳过源文件,仅使用支付数据生成独立的二维码单。
  • 瑞士支付数据:a CH 或 LI IBAN金额,货币(充血性心力衰竭 或者 欧元),以及债权人和债务人姓名/地址栏。完整字段参考信息请见此处。 行动文件

快速参考:关键参数

IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Currency
CHF or EUR only. Other currencies rejected by 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 Postal Code + City). K = combined (full address in two Address Lines).
paging Options
first, last, append, or a specific 1-based page number.
Format Type
PDF for printable invoices, PNG/JPEG/TIFF for image output.

建造闪电

步骤 1:Dropbox - 在文件夹中新建文件(触发)

请留意源文件夹,查看是否有新发票。

场地本次运行中使用的值
SpaceDefault
Folder/pdf4metest/Swiss-RP
Include files in subfolders?False
Include file contents?Yes
Include sharing link?Yes
Zapier Dropbox 文件夹内新建文件触发器:空间默认,文件夹 /pdf4metest/Swiss-RP,包含子文件夹中的文件否,包含文件内容是,包含共享链接是。

步骤 2:Dropbox - 查找文件

按文件名解析文件。这样就能为步骤 3 提供一个稳定且可映射的文件引用。

场地本次运行中使用的值
SpaceDefault
Folder/pdf4metest/Files
Include files in subfolders?False
File Name10 page.pdf
Include Deleted Files?False
Include file contents?Yes
Zapier Dropbox 查找文件:空间默认,文件夹 /pdf4metest/Files,文件名 10 页.pdf,包含已删除文件 False,包含文件内容 Yes。

步骤 3:PDF4me - 创建 SwissQR 账单

执行该操作的行动。搜索 PDF4me 在动作选择器中,选择 创建瑞士二维码钞票然后,请完全按照屏幕截图中的方式填写字段。 行动参考 显示。满足此运行条件的最低要求:

团体场地价值
SourceFormat TypePDF
SourceFile2. File: (Exists but not shown)
SourceFile Name2. File Name: 10 page + 2. File Ext: .pdf
Sourcepaging Optionsfirst
PaymentCurrencyCHF
PaymentReference TypeQRR
PaymentLanguage TypeEnglish
PaymentSeparator LineLine with Scissor
PaymentAmount1923.67
PaymentIBANCH4431999123000889012
CreditorCreditor Address TypeS
CreditorCreditor NameVar Schneider AG
CreditorCreditor:Street / Address Line 1Var Schneider AG
CreditorCreditor:Building No. / Address Line 223
CreditorCreditor Citybiel
CreditorCreditor Postal Code2501
DebtorUltimate Debtor Address TypeS
DebtorUltimate Debtor NamePia-Maria Rutschmann-Schnyder
DebtorUltimate Debtor:Address Line 1Grosse Marktgasse
DebtorUltimate Debtor:Address Line 232
DebtorUltimate Debtor CityRorschach
DebtorUltimate Debtor Postal Code9400
Ref/MsgReference210000000003139471430009017
Ref/MsgUnstructured MessageInstruction of 15.09.2019
Ref/MsgBilling InfoS1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106017086/40/1020/41/3010
Ref/MsgAV1 ParametersName AV1: UV;UltraPay005;12345
Ref/MsgAV2 ParametersName AV2: XY;XYService;54321

步骤 4:Dropbox - 上传文件

将生成的PDF文件保存到输出文件夹。

场地本次运行中使用的值
SpaceDefault
Folder/pdf4meoutput
File3. File Url (from PDF4me Step 3)
Overwriteno
Specify File Name3. File Name: 10 page (from PDF4me Step 3)
Specify File Extension3. File Extension: .pdf (from PDF4me Step 3)
Zapier Dropbox 上传文件:空间默认,文件夹 /pdf4meoutput,文件 3. 文件 URL,覆盖否,指定文件名 3. 文件名:10 页,指定文件扩展名 3. 文件扩展名:.pdf。

地图 文件 到 PDF4me 文件 URL 输出(步骤 3);单独 指定文件名指定文件扩展名 字段保留原名称。

保存并点击 发布Zap 已上线;请上传新发票。 /pdf4metest/Swiss-RP 而带有二维码的账单增强型 PDF 文件则落入了…… /pdf4meoutput 在下一个投票周期内。


故障排除

QR-bill page is blank or unreadable
IBAN is invalid (must start with CH or LI, max 21 chars) or Currency is something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Bank rejects a QRR 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. Pass a 1-based page number to insert at that position.
Creditor or Debtor address looks wrong on the slip
Mismatched Address Type. With S, fill Postal Code + City and use Address Line 1/2 for street. With K, leave Postal Code + City empty and put the full address into Address Line 1 + Address Line 2.
Upload writes a zero-byte or missing file
File field on Step 4 is not bound to the PDF4me File Url. Re-pick 3. File Url. Also confirm Specify File Name and Specify File Extension are mapped to the PDF4me Step 3 outputs, not hardcoded.
Want a standalone QR slip without a source invoice
Skip Step 2 (Find File). In Step 3, leave File and File URL empty and the action returns 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.
e-Bill fallbacks
For customers who prefer paper or in-app QR-scan over electronic Bill.

接下来读什么?


常问问题

Do I need a special Swiss QR library or font?+
No. The PDF4me Create Swiss QR Bill action bundles QR-code generation, the QR-bill fonts (Liberation Sans), mod-10 reference math, and the Swiss Payment Standards layout. Configure the fields, publish the Zap, 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 Step 2 (Find File). In Step 3, leave File and File URL empty and the action returns a standalone Swiss QR-bill PDF (just the payment slip, no invoice body).
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 Create EPC QR Code action instead.
Address Type S vs K. which one should I pick?+
S (Structured) is the modern default: Postal Code and City go in separate fields; Address Line 1/2 carries the street. K (Combined) puts the full address in two free-text Address Line fields and ignores Postal Code/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, Make, 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 Swiss QR Bill action page.

开始使用