创建 SwissQR 账单
条形码 → 创建 SwissQR 账单
这 创建 SwissQR 账单 API 生成瑞士 QR-账单 PDF 符合瑞士官方标准。您寄送一个底座 PDF （docContent， docName），债权人详情（IBAN（姓名、地址），债务人详细信息， 数量， 货币， referenceType， languageType， seperatorLine，并且（可选） IsAsync。 这 API 返回一个 PDF 附上 SwissQR 纸币。请使用下方的测试工具进行测试；更多详情请参见后续章节。
尝试创建 SwissQR 账单 API
:::备注 快速参考
终点： POST /api/v2/CreateSwissQrBill · 必需的： api-key， docContent， docName， iban， crName， crAddressType， crStreetOrAddressLine1/2， crPostalCode， crCity金额、货币 udName， udAddressType， udStreetOrAddressLine1/2， udPostalCode， udCity， referenceType， languageType， seperatorLine， IsAsync
:::
使用下方表格提交您的 API 钥匙， PDF （Base64），以及所有债权人/债务人和付款字段。响应是 PDF 与瑞士人 QR-账单。无需代码，填写字段并点击 发送请求.
概述、参数和用例
- Overview
- Parameters
- Use cases
什么是创建 SwissQR 账单？
这个端点创建了一个瑞士 QR-账单 PDF 符合瑞士官方标准（2020年6月）。您提供一个基础 PDF 以及完整的付款数据：债权人（IBAN（姓名、地址）、最终债务人、金额、货币、参考类型、语言和分隔符样式。 API 返回一个 PDF 与瑞士人 QR账单已附上，可直接进行银行转账和电子支付。
主要特点
- 符合瑞士标准结构化支付信息、债权人/债务人详细信息、嵌入式 QR code以及合理的布局。
- 完整付款数据： IBAN金额，货币（CHF， EUR， USD），参考类型（QRR， NON， SCOR），语言（英语、德语、法语、意大利语）。
- 分隔符选项： seperatorLine: LineWithScissor、DashedLineWithScissor 或 SolidLine 用于剪切/撕裂。
:::提示 最佳用途
适用于瑞士发票、账单或任何必须带有瑞士印记的文件。 QR-账单。与 读取 SwissQR 码 从现有的瑞士银行账户中验证或提取支付数据 QR账单。
:::
API 参数
| 范围 | 类型 | 必需的 | 描述 |
|---|---|---|---|
| api-key | 细绳 | 是的 | 你的 PDF4me API 钥匙， Base64 已编码。从……获取 仪表板。 |
| docContent | base64 | 是的 | PDF 文件内容（Base64）。 |
| docName | 细绳 | 是的 | PDF 文件名，扩展名为.pdf。 |
| iban | 细绳 | 是的 | 瑞士 IBAN 对于债权人（例如 CH0200700110003765824）。 |
| crName， crAddressType， crStreetOrAddressLine1， crStreetOrAddressLine2， crPostalCode， crCity | 细绳 | 是的 | 债权人名称、地址类型（S/K）、街道、邮政编码、城市。 |
| 数量 | 细绳 | 是的 | 付款金额（不含前导零）。 |
| 货币 | 细绳 | 是的 | CHF， EUR， 或者 USD。 |
| udName， udAddressType， udStreetOrAddressLine1， udStreetOrAddressLine2， udPostalCode， udCity | 细绳 | 是的 | 最终债务人姓名和地址。 |
| referenceType | 细绳 | 是的 | QRR， NON， 或者 SCOR。 |
| languageType | 细绳 | 是的 | 英语、德语、法语或意大利语。 |
| seperatorLine | 细绳 | 是的 | 直线（带剪刀）、虚线（带剪刀）或实线。 |
| IsAsync | 布尔值 | 是的 | 启用异步处理。 |
何时使用 Create SwissQR Bill
- 发票和账单添加瑞士 QR-瑞士数字支付的账单到发票。
- 支付处理生成符合自动化支付流程要求的账单。
- 银行和会计：整合瑞士 QR-将账单创建到银行或 ERP 系统。
- 监管合规：符合瑞士银行和支付标准，采用官方布局和 QR code。
需要完整信息 API？
有关请求/响应模式和代码示例，请参阅 创建 SwissQR 账单 在 PDF4me API 文档。
:::
先决条件
使用此端点之前，请确保您已具备以下条件：
- 有效的 PDF4me API 钥匙 （获得你的 API 钥匙）
- A PDF 用于附上 SwissQR 账单的文件
- 所有必需的付款信息（IBAN（债权人详情、债务人详情、金额、币种）
- 这 PDF 文件编码为 Base64 格式
回复格式
这 API 返回一个 PDF 文件包含 SwissQR 账单。 状态 200 返回 PDF 在回复正文中； 状态 202 表示处理是异步的，轮询 Location 标题 URL 直到 PDF 准备好了。