基于Airtable的瑞士二维码账单：使用PDF4me在Make中生成、附加并通过电子邮件发送

PDF4me Create Swiss QR-bill是一个Make模块，可以将付款详情转换为瑞士二维码账单图像。它与Airtable数据库关联，从一行数据中读取债权人、债务人和QR-IBAN，将生成的账单作为附件添加到同一记录中，并通过电子邮件发送给债务人。

问Airtable能否生成发票，答案是否定的，至少不能生成可支付的发票。它能很好地保存债权人、债务人、金额和QR-IBAN信息，但瑞士二维码发票需要特定的格式：明确的布局、裁剪线、正确格式的参考信息，以及银行应用程序能够识别的二维码。通常的建议是退出Airtable，打开银行网站，重新输入数据。但这种方法恰恰相反，数据始终保留在 Airtable 中，不会离开它原本所在的数据库。

基于原因的问答​

---

您将获得​

输入：一条Airtable记录，包含债权人、债务人、金额、币种和QR-IBAN， Status设置为“新建”。输出：一张附加到该记录的瑞士二维码账单 PNG 图片，以及一封附加了该账单的电子邮件，发送给债务人。

每张钞票一行。此处的每一列都对应瑞士二维码规范要求的一个字段。

---

你需要什么​

---

概览​

1. Watch records (Airtable) 开始在Swiss QR Requests中获取新行。
2. Create Swiss QR-bill （ PDF4me）将账单渲染为 PNG 格式。
3. Upload an attachment （ Airtable）会将其附加到同一行的Document字段中。
4. Update a record （ Airtable）会将结果写回该行。
5. Send an email （ Gmail）即可将催款单送达债务人。

完整场景概述​

三个Airtable模块、一个PDF4me模块和一个Gmail模块。数据库既是数据源，也是目标数据源。

---

步骤 1：如何从Airtable行触发场景？​

目前流程：尚未启动，这是触发点。

标记为“就绪”的行是请求，所以Make会监视它。

1. 添加Airtable > Watch records作为触发器。
2. 配置:
   • 根据: PDF4me Live Automations
   • 桌子: Swiss QR Requests
   • Trigger field: Created
   • Label field: Title
   • 限制: 10
   • 公式: {Status}='New'

Watch records配置​

该公式可以防止场景在未完成的行上触发。

---

步骤 2：如何将一行转换成瑞士 QR 钞票？​

目前为止的流程： Airtable触发器。

这是生成单据的模块。它的大部分字段直接映射到行数据；其中两个字段需要表达式。

1. 添加PDF4me > Create Swiss QR-bill。
2. Configure影响输出结果的设置：
   • Format Type: PNG
   • Reference Type: QRR
   • 语言: English
   • Separator Line: Line With Scissor
   • Creditor Address Type: S
3. 根据触发器映射支付数据：
   • Amount: formatNumber(1.Amount; 2; "."; "")
   • IBAN: replace(1.QRIBAN; " "; "")
   • Creditor Name、街道、邮政编码、城市和国家/地区（来自“债权人”栏）
   • Debtor姓名和地址取自“债务人”列， Reference取自该行。

Create Swiss QR-bill配置​

面板在此处可滚动查看。债权人名称下方显示的是债权人地址的其余部分以及完整的债务人信息。

每个设置决定什么​

场地	这里的价值	它控制着什么
Format Type	PNG	它不是 PDF 文件，而是图片，因此可以附加到Airtable单元格并进行内嵌预览。
Reference Type	QRR	结构化二维码参考，这种类型需要QR-IBAN。其他选择包括SCOR和NON
Separator Line	Line With Scissor	在收据和付款部分之间画出切割线
Creditor Address Type	S	结构化地址，即街道、邮政编码和城镇分别位于不同的字段中，而不是自由文本。
Amount	formatNumber(...)	两位小数，不设千位分隔符，这符合规范要求。
IBAN	replace(...)	在账户验证之前，去除用户在IBAN中输入的空格。

---

步骤 3：如何将纸条放回唱片上？​

目前流程：触发器加上PDF4me模块。

该排的客人要求结账，所以应该由该排的客人来付账。

1. 添加Airtable > Upload an attachment。
2. 配置:
   • Base和Table：同步骤 1
   • Record ID：触发器中的id
   • Attachment field: Document
   • File： PDF4me的输出结果 - Create Swiss QR-bill
   • File name： QRBill_ + 行Title + .png
   • Data：模块 2 的Document输出。
   • Content type: PNG image

Upload an attachment配置​

Record ID来自触发器，因此该单据会落在请求它的行上。

---

步骤 4：如何将结果记录在行中？​

目前流程：所有操作均通过附件上传完成。

上传文件并不等同于工作完成。最终结果需要通过单独的更新程序来写入。

1. 添加Airtable > Update a record。
2. 配置:
   • Base和Table：同步骤 1
   • Record ID：触发器中的id
   • Record：填写您希望返回的字段。 Status非常重要，因为它是触发公式读取的内容；而OutputLink列则方便您放置可共享的 URL。

Update a record配置​

该面板列出了表格中的每一列。如果您不想被覆盖，请将任何列留空。

---

第五步：如何将账单寄给债务人？​

目前流程：所有操作均已完成记录更新。

最后一个模块将收据送到指定地址。

1. 添加Gmail > Send an email。
2. 配置:
   • To：触发器中的Email列
   • Subject： Your Swiss QR bill 及Title
   • Body type: Raw HTML
   • Content：一段简短的 HTML 代码，包含债务人姓名、账单名称和金额。
3. 添加附件：
   • File： PDF4me - Create Swiss QR-bill输出
   • File name： QRBill_ + Title + .png
   • Data：模块 2 的Document输出。

Send an email配置​

附件从模块 2 获取字节，因此Airtable永远不会被读取。

---

运行场景并验证​

1. Save方案并运行一次。
2. 向Swiss QR Requests中添加一行，其中包含债权人、债务人、金额、 QR-IBAN和Status New。
3. 观察五个模块的指示灯亮起情况。每个模块应该报告一项操作。
4. 打开该行： Document字段应包含一个以Title命名的 PNG 文件。
5. 打开附件并检查两部分。收据和付款单上的账户、参考编号和金额必须一致，中间用剪刀线隔开。
6. 请在电子邮件栏的收件箱中查看邮件及其附件。

在捕获的运行中，行INV-1003生成了一张支付给Muster AG （地址： Bahnhofstrasse 1, 8001 Zuerich的收款单，账户为 CH44 3199 9123 0008 8901 2，参考号为 21 00000 00003 13947 14300 09017，由Test Kunde AG （地址： Seestrasse 10, 8002 Zuerich支付，金额为 100.50 CHF。

---

无需重建即可添加的常见变体​

与其他制作瑞士二维码钞票的方式相比，这种方式有何异同？​

每一行描述了一种替代方案。最后一行就是当前的情况。

比较	谁在运营它	数据来源	你所维护的
银行门户网站与此场景对比	一个人，一次失误，慢慢积累起来。	手工重录	没什么，但每张账单都会占用别人几分钟时间。
具备瑞士二维码导出功能的会计软件包与此方案的对比	金融，在该产品内部	该产品的账簿	订阅服务，以及客户的第二个家
开发者库与此场景	应用程序内部的开发人员	通过代码实现您的数据库	代码、规范更新和版本发布
这种情况	任何可以添加Airtable行的人	团队已经保留的基础	五个模块和一个QR-IBAN

---

常见问题​

什么是瑞士二维码钞票？​

瑞士二维码账单是取代瑞士旧式橙红色支付单的支付凭证。它包含一个二维码，其中包含债权人、债务人、金额和参考编号等信息，因此付款人只需在银行应用程序中扫描二维码即可，无需手动输入任何内容。

它分为两部分，收据部分和付款部分，中间有一条切割线隔开，布局由……固定。Swiss implementation guidelines published by SIX因此，生成一个这样的模型是一个规范问题，而不是一个设计问题。

瑞士的QR-IBAN号码是什么？​

QR-IBAN是银行除了您的普通IBAN之外发放的第二个账号，其机构标识符位于预留范围内，因此很容易识别。它的存在是为了让银行能够识别收到的付款带有结构化的 QR 参考号，并自动将其与发票匹配。

针对这种情况，实用规则是：如果将Reference Type设置为QRR则必须使用QR-IBAN，而不是您常用的 IBAN。混用两者会导致生成的凭证虽然看起来正确，但无法扫描。

如何支付瑞士二维码账单？​

付款人打开银行应用程序，扫描支付部分的二维码，查看屏幕上的金额并确认。无需输入任何内容，这正是这种支付方式的意义所在。

也可以在邮局柜台支付汇票，或者从打印的字段中手动输入，因此付款部分会在代码旁边以可读文本的形式重复显示账户、参考号和金额。

Airtable可以创建发票吗？​

仅靠Airtable本身无法做到这一点。Airtable 可以存储数据，并将其布局在界面或可打印视图中，但它无法生成符合支付标准的文档，也无法生成符合该规范的可扫描二维码。

它的优势在于能够提供真实可靠的信息。这种方案也保留了这种划分： Airtable保存数据行， PDF4me生成符合规范的文档，最终结果以附件的形式返回到数据行中。

---

故障排除​

---

后续步骤​

您现有的数据库通常比看起来更接近最终的付款单据。它只需要一些能够体现规范的内容。