跳到主要内容

在 Make 中将瑞士二维码账单添加到任何发票 PDF:一个包含 3 个模块的 Dropbox 工作流程

· 阅读需 21 分钟
SEO and Content Writer

每张瑞士发票都必须包含一个 瑞士二维码钞票 这样,银行和会计软件就可以自动扫描和处理付款。借助 Make 和 PDF4me,这项功能得以扩展。 三模块场景Dropbox 下载文件PDF4me 创建瑞士二维码钞票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 模块。Dropbox 下载文件 提取源发票(屏幕截图显示) YnooxTestone 联系, 选择文件, 小路 /pdf4metest/Files/10页.pdfPDF4me 创建瑞士二维码钞票 附加符合瑞士支付标准的二维码账单页面(格式类型) PDF分页选项 第一的, 货币 充血性心力衰竭以……开头的 IBAN CH(完整的债权人和债务人封锁)。Dropbox 上传文件 将结果写入 /pdf4meoutput/ 文件设置为 地图文件名 = 6. 姓名数据 = 6. 文件生成的 PDF 文件可用于电子邮件发送,也可通过任何瑞士银行的移动应用程序扫描二维码发送。

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

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

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

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

  • 如何自动将瑞士二维码账单添加到我的PDF发票中? 将发票上传到 Dropbox;这个 3 模块方案会完成其余工作,包括 IBAN、金额、参考信息以及债权人/债务人详细信息。
  • “Make能否根据现有发票生成瑞士二维码账单?” 是的,可以通过 PDF4me 的“创建瑞士二维码账单”模块实现。输出结果与原 PDF 文件相同,只是在您选择的页面(首页/末页/特定页面)上附加了付款凭证。
  • 我需要Excel模板还是二维码库? 不。该模块将所有二维码生成、模 10 参考数学和瑞士支付标准布局隐藏在一个可配置的步骤之后。
  • “如果我没有现有的发票PDF文件,我还能生成独立的二维码单吗?” 是的。完全跳过文件组,该模块将返回一个独立的瑞士二维码账单 PDF 文件。
  • “瑞士银行真的会接受这种输出结果吗?” 该模块生成符合 ISO 20022 瑞士支付标准的单据。所有瑞士银行的手机银行应用程序都可以扫描该单据以发起支付。

你正在构建的

这是一个可复用的三模块 Make 场景。触发条件(手动、定时、文件监视等)触发后,系统会提取源发票,追加瑞士二维码账单,并保存输出结果。该模式同样适用于一次性测试、定时批处理运行或完全事件驱动的发票处理。

创建场景画布:Dropbox 下载文件(带有定时时钟徽章)连接到 PDF4me 创建瑞士二维码账单,该二维码账单连接到 Dropbox 上传文件。三个大型圆形模块图标通过标准的虚线连接线连接。

三个模块构成完整的流程。Dropbox 1 上的时钟图标表示已设置定时触发。您可以根据实际使用场景切换到手动触发或 Webhook 触发。


你需要什么

  • 制作 已创建场景的账户。 创建 Make 帐户 如果你需要的话。
  • PDF4me API密钥获取您的 API 密钥 当 PDF4me 提示需要连接时,添加该连接。参见 连接 PDF4me 以创建
  • Dropbox 带有源文件夹(例如 /pdf4metest/文件/)和一个输出文件夹(/pdf4meoutput/任何存储服务的工作方式都相同。根据需要,可以替换为 Google Drive、OneDrive 或 SharePoint。
  • 发票PDF (截图使用 10页.pdf(可选)跳过源文件,仅根据支付数据生成独立的二维码单据。
  • 瑞士支付数据:a CH 或 LI IBAN金额,货币(充血性心力衰竭 或者 欧元),以及债权人和债务人姓名/地址栏。完整字段参考信息请见此处。 行动文件

构建场景

模块 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 - 创建瑞士二维码账单

搜索 PDF4me 并挑选 创建瑞士二维码钞票该模块公开了 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 创建瑞士二维码账单)。数据绑定到 6. 文档。提示:文件名,包括扩展名,例如 invoice.xml。

文件单选按钮设置为 地图 将文件名和数据分别作为单独的插槽显示。将两者都绑定到 PDF4me 模块 2 的输出,以便完整地输出已填充的 PDF 文件。

保存并点击 运行一次填写完毕的发票将显示在 /pdf4meoutput/ 几秒钟之内。


输出文件夹中会包含什么内容

以来源命名的单个 PDF 文件(例如: 10 page.pdf)并将瑞士二维码账单页面插入到选定的位置 分页选项First 将其设为新的第 1 页; Last (将其附加到文件末尾)。在任何 PDF 查看器中打开文件,二维码账单部分将显示付款二维码、易于理解的待冻结账户/应付账款、金额、币种、参考信息以及债权人/债务人地址。使用瑞士银行应用程序扫描二维码,付款信息将自动填写。


快速参考:关键参数

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.

开始使用