Invoice PDF

Create beautiful PDF invoices just from JSON data with valid e-invoice data included

原始信息汇总

Invoice PDF API 数据集概述

基本描述

Invoice PDF API 允许用户通过发送JSON数据，以最简单的方式创建美观的PDF发票。该API可生成包含有效电子发票数据的高质量PDF发票，并可选择添加EPC QR码或瑞士QR发票。目前提供四种不同的模板。

核心功能

• 通过JSON数据创建PDF发票。
• 生成的发票包含有效的ZUGFeRD 2.3 XML文档（符合德国电子发票标准，自版本2起与法国Factur-X标准相同）。
• 支持添加EPC QR码或瑞士QR发票。
• 提供四种发票模板：默认（DEFAULT）、经典（CLASSIC）、现代（MODERN）、极简（MINIMALISTIC）。

主要参数

必需参数

• sender: 发票发送方的联系信息（对象）。
• recipient: 发票接收方的联系信息（对象）。
• items: 待开票项目列表（数组），至少需提供一个项目。

可选参数

• template: 发票渲染模板，默认为DEFAULT。
• logo: 发票发送方的Logo（base64编码的数据URL）。
• feeTaxItems: 税费项目列表（数组）。
• contextItems: 上下文信息项目列表（数组）。
• footerItems: 页脚信息项目列表（数组）。
• locale: 用于格式化值的国家或语言，默认为de-AT。
• currency: 货币（ISO 4217标准），默认为EUR。
• notice: 打印在发票末尾的备注。
• currencyFormat: 货币格式（SYMBOL、CODE或NAME），默认为CODE。
• labels: 用于覆盖标准发票文本的对象。
• epcQrCode: 用于创建EPC QR码的信息对象。
• swissQrInvoice: 用于创建瑞士QR发票的信息对象。
• zugferdDisabled: 禁用ZUGFeRD/Factur-X电子发票的自动创建和集成，默认为false。
• metadata: 用于ZUGFeRD/Factur-X电子发票的发票元数据（如issueDate、dueDate、number）。

参数对象详情

sender 与 recipient 对象

• name: 公司名称（字符串）。
• contact: 联系人姓名（字符串）。
• street: 街道地址（字符串）。
• city: 城市（字符串）。
• postalCode: 邮政编码（字符串）。
• country: 国家代码（ISO 3166-1 alpha-2，如AT或US）。
• vatNumber: 公司增值税号。
• iban: 国际银行账号。
• bic: 银行识别码。

items 对象

• description: 发票项目描述（字符串，必需）。
• amount: 数量（浮点数，默认为1）。
• unit: 单位（字符串，可选）。
• unitPrice: 单价（浮点数）。
• sumPrice: 总价（浮点数）。
• vat: 增值税率（百分比，浮点数）。

定价计划

• BASIC: $0.00 / 月
• PRO: $6.99 / 月
• ULTRA: $17.99 / 月
• MEGA: $45.99 / 月

错误代码

• message.unknownCurrency: currency参数必须是有效的ISO 4217货币代码。
• message.unitPriceOrSumPriceMustNotBeNull: items中的unitPrice或sumPrice为必填项。
• message.descriptionMustNotBeNull: items中的description为必填项。
• message.templateMustNotBeNull: template参数为必填项。
• message.itemsMustNotBeEmpty: items参数必须至少包含一个元素。
• message.senderMustNotBeNull: sender参数为必填项。
• message.recipientMustNotBeNull: recipient参数为必填项。
• message.percentOrValueMustNotBeNull: feeTaxItems中的percent或value为必填项。
• message.swissQrInvoiceSupportsOnlyCertainCurrencies: 瑞士QR发票仅支持CHF或EUR货币。
• message.nameMustNotBeEmpty: name参数为必填项。
• message.vatMustBeBetween0And100: 发票项目中的vat值必须是0到100之间的百分比。
• message.bodyMustNotBeNull: POST请求中缺少请求体。

提供商信息

• API创建者: APIstax
• 订阅者数量: 1
• 类别: Payments

搜集汇总

背景与挑战

背景概述

该数据集提供从JSON数据生成美观PDF发票的功能，支持包含有效的电子发票数据。