创建瑞士二维码账单 n8n
此节点的功能
PDF4me创建瑞士二维码钞票 生成完全符合瑞士规定的二维码支付单，并嵌入其中 PDF 通过您的文件 n8n 提供自动化工作流程。 PDF 通过二进制数据（base64编码）开具发票 URL如果没有任何背景文件，或者根本没有背景文件，该节点将输出一张标准化的瑞士二维码钞票。 债权人和债务人详情 IBAN参考编号、多语言标签和可配置的输出格式 只需一步自动化操作即可完成。与所有瑞士银行完全兼容。 PostFinance以及瑞士支付标准（SPS） 规格。
相关博客文章(2)
验证您的身份 API 要求
每一个 PDF4me 节点 n8n 需要有效 用于连接的凭证创建或选择一个可以容纳您的 PDF4me API 关键在于确保工作流程能够安全地验证瑞士二维码账单生成请求。
您不容错过的重要事实
瑞士银行 IBAN 必须填写，格式会严格验证。
这 IBAN 字段必须是有效的瑞士 IBAN 以 CH 开头，后跟 19 位数字。无效号码。 IBAN 导致节点返回错误并停止工作流。务必验证 IBAN 在将其传递给节点之前进行格式化，尤其是在从数据库或表单输入动态映射时。
使用“输入数据类型为 None”可生成不带背景的独立二维码账单。 PDF
将“输入数据类型”设置为“无”会生成一个简洁、独立的瑞士二维码账单，其中不包含任何背景发票文档。这对于付款提醒、订阅逾期通知以及任何无需底层数据的流程来说都是正确的选择。 PDF 已生成。输出结果是您所选格式的可直接发送的二维码账单。
自动银行对账需要结构化地址类型。
债权人和最终债务人均提供结构化地址和组合地址两种类型。结构化地址分别存储街道、门牌号、邮政编码和城市等信息，当二维码账单将由瑞士银行自动化系统或支付对账软件处理时，结构化地址为必填项。除非有特殊原因需要使用组合地址，否则请始终使用结构化地址。
顶部面板、连接方式、输入类型、付款详情和债权人地址字段
底部面板，包括债务人地址、参考类型、语言、格式、分页和输出配置
参数
必需 n8n UI： 连接凭证、输入数据类型、金额、货币 IBAN债权人名称、债权人地址类型、最终债务人地址类型、参考类型、语言类型、分隔符、格式类型，以及（当格式类型为） PDF分页选项。所有地址行、邮政编码和城市字段均标记为可选。 UI 但是是 强烈推荐用于有效的瑞士二维码钞票瑞士支付标准规范和 PDF4me API 请将它们视为生产环境必需品。执行有效负载始终会发送它们（如果为空，则发送空字符串）。
| 范围 | 必需的 | 它的作用 | 例子 |
|---|---|---|---|
| Input Data Type | Conditional | How the source PDF is supplied. None generates a standalone QR bill with no background document. Binary Data reads from a previous n8n node: the most common option. Base64 String accepts encoded file content. URL downloads from a public link. | Binary Data |
| Binary Property Name | Conditional | Name of the binary field from the previous node. Required when Input Data Type is Binary Data. Maps to the output binary field of a prior download or file node. | data |
| Base64 Content | Conditional | Base64-encoded PDF content. Required when Input Data Type is Base64 String. | JVBERi0xLjQK... |
| File URL | Conditional | Public URL to the source PDF file. Required when Input Data Type is URL. | https://example.com/invoice.pdf |
| File Name | Conditional | Filename of the source PDF input. Shown only when Input Data Type is Binary Data, Base64 String, or URL: hidden for None. Include the .pdf extension. | document.pdf |
| Amount | Yes | Payment amount for the Swiss QR bill. Enter without leading zeroes (per the node field description). Must be a positive number with up to two decimal places. | 1000 |
| Currency | Yes | Currency for the QR bill. Only two options accepted: CHF (Swiss Franc, standard for domestic Swiss payments) or EUR (cross-border transactions). | CHF |
| IBAN | Yes | Creditor's Swiss IBAN. Must start with CH followed by 19 digits and be linked to a valid PostFinance or Swiss bank account. An invalid IBAN halts the workflow. | CH0200700110003765824 |
| Creditor Name | Yes | Full name of the creditor company or individual as registered with the bank. Printed on the generated QR bill in the creditor section. | Test AG |
| Creditor Address Type | Yes | Address format for creditor information. Sent as code S (Structured: components stored separately for maximum SPS compliance) or K (Combined, two free-form lines). | Structured (S) |
| Creditor Address Line 1 | No | Street name for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills: always provide it. When Address Type is Structured, enter the street name only. | Test Strasse |
| Creditor Address Line 2 | No | House number or secondary address detail. Used as the second address line when Creditor Address Type is Structured. | 1 |
| Creditor Postal Code | No | Swiss postal code for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills. Must be a 4-digit Swiss postal code matching the creditor city. | 8000 |
| Creditor City | No | Swiss city name for the creditor's address. Marked optional in the UI but required for valid Swiss QR bills. Must correspond to the postal code entered above. | Zurich |
| Ultimate Debtor Name | No | Full name of the party who will pay the bill. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. Appears in the payment section of the printed QR bill. | Test Debt AG |
| Ultimate Debtor Address Type | Yes | Address format for the ultimate debtor. Sent as code S (Structured: recommended for automated Swiss banking) or K (Combined, two free-form lines). | Structured (S) |
| Ultimate Debtor Address Line 1 | No | Street name for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | Test Deb Strasse |
| Ultimate Debtor Address Line 2 | No | House number or secondary address line for the debtor. Used as the second line when Ultimate Debtor Address Type is Structured. | 2 |
| Ultimate Debtor Postal Code | No | Swiss postal code for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | 8000 |
| Ultimate Debtor City | No | Swiss city name for the debtor's address. Marked optional in the UI but required for valid Swiss QR bills with a known debtor. | Zurich |
| Reference Type | Yes | Sent as code NON (No Reference: simple payments), QRR (QR Reference, 27-digit numeric for PostFinance/Swiss bank reconciliation), or SCOR (Creditor Reference, ISO 11649 for SEPA-compatible cross-border payments). | NON |
| Language Type | Yes | Display language for QR bill labels and printed text. Options: English, German, French, Italian. Choose the language matching the recipient's Swiss region. | English |
| Separator Line | Yes | Visual separator between the invoice body and the QR bill tear-off section. Note the node field name is spelled "seperatorLine". Options: Line With Scissor (Swiss standard), Simple Line, No Line. | Line With Scissor |
| Format Type | Yes | Output file format for the generated QR bill. PDF is recommended for print-ready documents. PNG and JPEG for digital delivery. TIFF for archival quality. Empty or null for raw data output. | PDF |
| Paging Options | Conditional | Controls where the QR bill slip is placed in the output document. Required when Format Type is PDF. Options: First, Last, Add Page At End, Custom. | First |
| Page Number | Conditional | Specific page index for placing the QR bill. Shown and required only when Format Type is PDF and Paging Options is Custom. | 3 |
| Output File Name | No | Filename for the generated Swiss QR bill document. Default value is provided by the node. Include the extension matching your chosen Format Type. | swissqr_bill.pdf |
| Output Binary Field Name | No | Name of the binary field in the n8n output that holds the generated QR bill file. Default is data. Used to reference the file in subsequent workflow nodes. | data |
高级选项
所有字段都位于 高级选项 收集功能是可选的，可提供对二维码账单有效载荷的额外控制。可通过以下方式添加： 添加选项 在节点用户界面中。
参考二维码中嵌入的实际参考编号。当参考类型为 QRR（27 位数字）时，此为必填内容。 SCOR （ISO 11649 格式以 RF 开头）。
非结构化消息二维码账单上可打印自由格式的付款备注，例如“发票编号 2024-100，到期日 11 月 30 日”。与二维码结合使用时，最多可包含 140 个字符。 billingInfo。
账单信息符合瑞士二维码账单规范的结构化账单信息，例如发票号码、发票日期、增值税详情。与二维码结合使用时，最多可包含 140 个字符。 unstructuredMessage。
av1替代程序参数 1 (AV1)。保留用于未来瑞士的替代支付程序。
av2替代程序参数 2 (AV2)。保留用于未来瑞士的替代支付程序。
简介风俗 PDF4me 处理配置文件。应用预配置的选项集，实现高级或专门的二维码账单处理。
输入数据类型选项
选择来源方式 PDF 进入节点。每个选项都适用于不同的工作流程模式。
输入数据类型下拉菜单，四个选项控制数据源的来源。 PDF 提供给节点
没有任何无背景文件生成一张独立的瑞士二维码纸币，不包含任何底层信息。 PDF可用于付款提醒、订阅通知或任何无需发票的情况。 PDF 存在于工作流程的上游。
二进制数据来自前一个节点的文件，最常见的阅读 PDF 直接从先前的输出中获取二进制内容 n8n 节点例如 Google 云端硬盘下载， HTTP 请求或读取二进制文件。二进制属性字段指定要从中读取的输出字段（默认值：
数据）。Base64字符串Base64编码的文件内容接受 PDF 以 base64 编码字符串的形式。当文件来自……时，请使用此格式。 API 响应、webhook 有效负载或以 base64 格式而非原始二进制格式存储文档的数据库字段。
URL从公共链接下载提供公开访问 URL 到 PDF 文件。 PDF4me 直接从……下载文件 URL 处理之前。 URL 必须开放，访问无需身份验证。
地址类型选项
适用于两者 债权人地址类型 和 最终债务人地址类型选择地址组成部分在二维码数据中的存储方式。
结构化建议使用单独的地址字段将地址的每个组成部分分别存储在单独的字段中：街道名称在地址行 1，门牌号在地址行 2，邮政编码和城市也分别单独存储。大多数瑞士银行系统要求使用这种格式进行自动付款对账，并且对于某些特定情况，这种格式是强制性的。 PostFinance 加工。
合并两条自由格式地址线将完整地址存储为两行自由格式的组合，例如，第一行“Test Strasse 1”，第二行“8000 Zurich”。这种方式更易于填写，但与瑞士银行自动对账系统的兼容性较差。仅在无法使用结构化存储方式时才使用。
债权人地址类型，结构化地址与组合地址
最终债务人地址类型，与债权人地址类型相同。
参考类型选项
控制二维码中嵌入的付款参考标准。这会影响银行系统中付款与发票的匹配方式。
参考类型：无参考、二维码参考或债权人参考
无参考默认情况下，无结构化引用二维码中未嵌入付款参考信息。此二维码适用于简单的单次付款，此类付款的对账工作需手动完成或通过外部系统进行。您仍然可以使用“非结构化消息”字段添加自由格式的付款备注。
二维码参考27位数字瑞士银行对账单在二维码中嵌入一个27位数的数字参考编号（类似于旧的ESR/ISR参考编号）。这是瑞士国内二维码纸币的标准选择。 PostFinance 或瑞士银行 IBANs. 可实现与银行对账单的全自动付款核对。需要提供“参考”字段值。
债权人参考ISO 11649跨境 SEPA 付款嵌入一个 ISO 11649 二维码中包含结构化的债权人参考信息。用于 SEPA用于兼容的跨境支付，或当您的会计软件需要标准化的 ISO 参考号时。参考号以 RF 开头，后跟两位校验和，最多 21 个字母数字字符。
格式类型选项
控制生成的二维码账单输出的文件格式。
格式类型下拉菜单， PDF， PNG， JPEG， TIFF或空（null）
PDF默认，可直接打印输出全保真 PDF 文档已准备好进行打印、电子邮件发送或存档。是发票工作流程的标准选择。
PNG网络和数字交付输出二维码账单 PNG 图片。可用于嵌入网页、客户门户或需要图片格式的数字通信中。
JPEG适合电子邮件发送的图片将二维码账单输出为压缩格式。 JPEG 图片。文件大小比……小 PNG适用于对文件大小有要求的邮件内嵌或移动端友好型交付。
多伦多国际电影节档案级品质以高分辨率格式输出二维码钞票 TIFF 图像。适用于需要最高图像保真度的文档管理系统、记录保存和归档工作流程。
空（null）原始数据输出返回原始二维码账单数据，不带特定文件格式封装。适用于下游系统处理格式转换或与……集成的情况。 API 直接消耗原始二进制数据。
分页选项
控制二维码账单在输出文档中相对于现有发票页面的位置。
分页选项：首页、末页、页尾添加或自定义
第一的默认设置，二维码账单位于第 1 页。将瑞士二维码账单置于输出文档的第一页，即文档开头。当二维码支付部分需要显示在发票详情之前时，请使用此选项。
最后的最后一页有二维码账单将瑞士二维码账单单放置在现有文档的最后一页。适用于发票内容应显示在最前面，付款单显示在最后，且无需添加新页的情况。
在末尾添加页面最常见的专用二维码账单页面在发票文档末尾添加一个全新的专用页面，其中包含瑞士二维码账单。这是瑞士发票自动化中最常见的配置，发票内容保留在单独的页面上，而二维码付款单则拥有自己独立的空白页面。
风俗特定页面定位允许自定义二维码在文档中的位置。当您的发票模板在特定页面或位置（既非首页也非末页）预留了二维码空间时，可以使用此功能。
输出字段
| 场地 | 类型 | 它包含什么 |
|---|---|---|
fileName | String | Filename of the generated Swiss QR bill document, for example swissqr_bill.pdf. Map into an upload or email node as the destination filename. |
mimeType | String | MIME type of the output file, for example application/pdf. Useful for content type validation in downstream HTTP or storage nodes. |
fileSize | Number | Size of the generated QR bill file in bytes. Useful for storage planning, bandwidth monitoring, and conditional routing in the workflow. |
success | Boolean | True when the Swiss QR bill was created successfully. False if an error occurred during generation. Use this field to route error handling branches in your workflow. |
message | String | Human-readable status message confirming success or describing the error encountered. Useful for logging and error notification steps. |
快速设置
- 添加 PDF4me 致你 n8n 工作流程。设置 资源 到 发票 和 发票操作 到 创建 SwissQR 账单。
- 在 用于连接的凭证请选择您的 PDF4me 凭证或点击 创建新凭证 并粘贴你的 API 钥匙。
- 放 输入数据类型连接前一个节点的二进制输出（二进制数据），并提供一个 Base64 字符串，提供一个公共 URL或者选择“无”以生成独立的二维码单。
- 进入 数量， 货币 （瑞士法郎用于支付瑞士法郎）， IBAN （有效的瑞士瑞士法郎） IBAN 以 CH 开头）。
- 请填写所有内容 债权人 字段：姓名、地址类型（建议使用结构化格式）、地址行 1、地址行 2、邮政编码和城市。
- 请填写所有内容 最终债务人 填写付款方全名和地址详细信息的字段。
- 放 参考类型 （默认情况下不引用） 语言类型 （英语、德语、法语或意大利语），以及 分离线 （剪刀线是瑞士标准）。
- 配置 格式类型 （PDF （推荐）和 分页选项 （在末尾添加页面，将二维码账单页附加到现有发票。）
- 放 输出文件名 到
swissqr_bill.pdf和 输出二进制字段名称 到data。 - 将输出连接到下一个节点：电子邮件发送器、云存储上传、数据库写入，并执行工作流。
工作流程示例
工作流程示例Common n8n workflow patterns using Create Swiss QR Bill.
月度发票批次 → 瑞士二维码账单 → 通过电子邮件发送给客户
- 每个月的第一天都会触发计划触发器，以开始计费运行。
- Google 云端硬盘节点列出了所有发票 PDF每月账单文件夹中，每位客户一份。
- “循环遍历项目”节点会遍历每个文件。对于每个文件，“Google 云端硬盘下载”节点会检索其二进制内容。
- PDF4me Create Swiss QR Bill 会使用客户的金额，在每张发票上附加一个符合规定的二维码付款单。 IBAN地址映射自 Google Sheets 客户记录。语言类型设置为德语。分页选项设置为“页末添加页”。
- Gmail节点发送二维码账单 PDF 以电子邮件附件的形式发送给每位客户。文件名使用客户 ID，以便于识别。
电子商务订单已确认 → 扫描二维码账单 → 保存 SharePoint
- 当电子商务平台确认订单时，Webhook 触发器就会触发。
- 一个 HTTP 请求节点生成发票 PDF 一个 HTML 使用订单数据创建模板。
- PDF4me 创建瑞士二维码账单会将符合规定的二维码单据附在发票上。 PDF金额和债务人详细信息均来自 webhook 有效负载。参考类型设置为“债权人参考”，用于对账。语言类型设置为法语，适用于瑞士法语区。
- 微软 SharePoint 节点上传已完成的二维码账单 PDF 移至订单存档文件夹。
- 一个 HTTP 请求节点将订单状态更新为“发票已发送”。 CRM 系统。
逾期订阅 → 独立二维码账单 → 付款提醒
- 系统会在每周一早上触发计划触发器，检查是否有逾期订阅帐户。
- PostgreSQL 节点查询所有超过 14 天未结清余额的账户。
- 循环遍历项目节点处理每个订阅者。 PDF4me 创建瑞士二维码账单的调用中，输入数据类型设置为“无”，没有后台运行。 PDF生成一张清晰独立的二维码账单。债务人姓名和地址均来自数据库记录。参考类型为“无参考”。语言类型为“意大利语”（适用于瑞士意大利语区）。
- 微软 Outlook 节点会向每位订阅者发送包含独立二维码账单的付款提醒邮件。 PDF 随附的。
- PostgreSQL 节点会记录提醒发送时间戳，并增加每个帐户的提醒计数。
常见问题解答
相关操作
分裂 PDF 瑞士二维码
分割 PDF 瑞士二维码位置的文件用于智能批量文件整理和单个发票提取。
阅读瑞士二维码
提取并解析瑞士二维码中嵌入的支付数据 PDF 用于自动对账和数据采集的发票。
创建 ZUGFeRD 发票
生成带有嵌入式结构的结构化电子发票 XML 用于符合欧盟标准的电子账单以及瑞士二维码工作流程。
在其他平台上执行相同任务
创建瑞士二维码账单（Make）
与瑞士二维码钞票操作方式相同 Make 模块，相同 SPS-符合规定的付款单生成， IBAN 验证，以及用于可视化场景构建器的结构化债权人/债务人字段。
创建瑞士二维码账单（Zapier）
与以下操作相同 Zapier 动作，非常适合 SaaS 计费平台通过 Gmail、Slack、会计工具和 webhook 驱动的管道触发 Swiss QR 发票。
创建瑞士二维码账单（Power Automate）
Power Automate / Microsoft 365 流量，非常适合 SharePoint 文档库 Outlook 发票邮件，以及 Dynamics 瑞士企业环境中的 365 个财务集成。