在 ZUGFeRD 中创建发票 Zapier
此操作的作用
PDF4me 创建 ZUGFeRD 发票 生成完全合规的 ZUGFeRD 混合电子发票，一个 PDF/A-3 文件结构化 XML 发票数据直接嵌入在您的发票数据中 Zapier 工作流程。转换 XML， JSON， 或者 CSV 将发票数据合并到一个混合文件中，以便于使用。 德国B2B电子发票强制令（2025年及以后）符合欧盟 EN 16931 标准或德国 XRECHNUNG 公共部门规范。支持 ZUGFeRD 1.0 至 2.x 版本以及所有合规级别（BASIC、COMFORT、EXTENDED、EN16931、XRECHNUNG），只需一次 Zap 操作即可完成。可直接替代手动 Adobe Acrobat、JustOn 或 ZUGFeRD Manager 工作流程。
相关博客文章(1)
验证您的身份 API 要求
要访问 PDF4me 网站 API 通过 Zapier所有操作都必须经过身份验证。点击 连接新帐户 第一次粘贴你的 PDF4me API 关键在于，后续的 Zap 会自动重用该连接。
您不容错过的重要事实
ZUGFeRD 2.0+ 是 2025 年德国 B2B 指令的必要条件。
《增长法》规定，自 2025 年 1 月 1 日起强制要求接收电子发票，并于 2028 年前全面强制发送。符合 EN16931 或 XRECHNUNG 标准的 ZUGFeRD 2.0 或更高版本满足此项要求：ZUGFeRD 1.0 不符合要求。部分系统默认使用 1.0 版本；生产环境中必须明确切换到 2.0 或更高版本。
每次运行只填写一个数据字段，绝不能填写两个。
地图 仅有的 与您的输入格式匹配的发票数据字段，发票 XML 数据 XML发票 JSON 数据 JSON发票 CSV 数据 CSV. “以防万一”填写多个字段会破坏验证，并在运行时导致 Zap 步骤失败。
对于 2.x 版本，EN16931 符合性等级是安全的默认值。
挑选 EN16931 适用于欧盟一般B2B发票（ZUGFeRD 2.x）， XRECH 对于德国公共部门实体而言， 扩展 适用于特定行业领域。对于 ZUGFeRD 1.0，BASIC 是最低合法发票级别。MINIMUM 和 BASICWL 省略了明细项目，本身不属于合法发票。
Zapier 行动 配置 标签页，地图 文件 / 文件名， 放 输入格式 以及匹配的发票数据字段，然后 输出模式， 祖格费尔德版本， 符合性级别， 在 PDF 上渲染发票， 和 语言。
参数
必需 Zapier UI （带星号）： 输入格式、输出模式、Zugferd 版本和一致性级别。 条件： 根据输入格式匹配发票数据字段（发票 XML 数据、发票 JSON 数据或发票 CSV 数据）。 对于 XmlWithPdf 输出： 即使并非每个布局都标有星号，连接器通常也需要文件和文件名（模板 PDF）。 选修的： 在 PDF 上渲染发票，语言。
| 范围 | 必需的 | 它的作用 | 例子 |
|---|---|---|---|
| File | Conditional | Template/layout PDF that will hold the embedded XML in XmlWithPdf output. Map from a previous step (Dropbox, Google Drive, HTTP). Not required when Output Mode is XmlOnly. | 3. File: (Exists but not shown) |
| File Name | Conditional | Filename of the template PDF (filename + extension). Required alongside File for XmlWithPdf output. Map both `File Name` and `File Ext` from the prior step. | 3. File Name: 10 page + 3. File Ext: .pdf |
| Input Format | Yes | Format of the invoice payload: XML, JSON, or CSV. Determines which invoice data field below must be filled. Asterisked in the Zapier UI. | XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 sample |
| Invoice Xml Data | Conditional | XML invoice payload. Required when Input Format is XML. Map from a previous file step that produced XML content. Leave empty for JSON/CSV inputs. | XML sampleXML 2.0 sample4. File: (Exists but not shown) |
| Invoice Json Data | Conditional | JSON invoice payload. Required when Input Format is JSON. Best for webhook-driven or API-driven invoice data. | JSON 2.0 EN16931 sampleJSON (basic)4. Body |
| Invoice Csv Data | Conditional | CSV invoice payload. Required when Input Format is CSV. Best for batch invoice exports from spreadsheets or legacy ERP exports. | CSV sampleCSV 2.0 sample4. File |
| Output Mode | Yes | XmlWithPdf produces the hybrid PDF/A-3 + embedded XML (canonical ZUGFeRD). XmlOnly produces pure XML with no PDF wrapper. Asterisked. | XmlOnly |
| Zugferd Version | Yes | ZUGFeRD specification version. 1.0 is legacy. 2.0+ aligns with EN 16931 and satisfies the German B2B mandate. Asterisked. | 1.0 |
| Conformance Level | Yes | Profile controlling required invoice fields. For 1.0: BASIC, COMFORT, EXTENDED. For 2.x: MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Asterisked. | BASIC |
| Render Invoice On Pdf | No | Toggle (True / False). When True, PDF4me visually renders invoice content on the PDF. When False, only the XML is embedded: useful when the template PDF already shows the invoice layout. | True |
| Language | No | Two-letter locale code for printed invoice labels: de (German, default), en (English), fr (French), it (Italian), es (Spanish), nl (Dutch), pl (Polish), pt (Portuguese). The XML data itself remains language-neutral. | de |
输入格式选项
控制发票有效负载使用的数据格式，以及您必须在下面填写的发票数据字段。
XML预制件 XML 发票最佳时机 ERP 已生产符合 ZUGFeRD 标准的产品。 XML 或 UBL XML 只需要用混合材料包裹起来即可 PDF将文件映射到 发票 XML 数据。
JSON现代的 API来源数据最适合 webhook 驱动的工作流程或 SaaS 发出计费系统的 JSON。 PDF4me 地图 JSON ZUGFeRD 的场 XML 自动映射到模式 发票 JSON 数据。
CSV电子表格或批量导出最适合从 Google Sheets、Excel、旧系统批量导出发票，或按行计费场景。 PDF4me 地图 CSV 列映射到模式。 发票 CSV 数据。
输出模式选项
控制是生成规范的 ZUGFeRD 混合文件还是纯 XML 文件。
XmlWithPdf默认的完整 ZUGFeRD 混合文件生产标准 ZUGFeRD 混合物： PDF/A-3 档案 PDF 结构化 XML 发票以附件形式嵌入其中。人们会阅读该发票。 PDF机器解析 XML这是B2B电子发票的标准输出格式。需要映射文件和文件名。
XmlOnly纯的 XML， 不 PDF 包装纸仅生成结构化数据。 XML 发票。用于 XRechnung pure-XML 公共部门提交、EDI管道、数据层测试或仅接收数据的系统 XML 没有视觉呈现。
Zugferd 版本选项
生成的发票中嵌入了 ZUGFeRD 规范版本。它决定了下拉列表中显示的“一致性级别”选项。
1.0传统，EN 16931 之前的版本2014 年原始规格。符合性选项： 基本款、舒适款、加长款不符合德国2025年及以后的B2B电子发票强制要求。仅适用于明确要求使用1.0版本的旧版接收方。
2.0+推荐，符合 EN 16931 标准符合欧洲标准 EN 16931，并满足德国 B2B 要求。符合性选项包括 最低限度、基本工作负荷、基本、EN16931、扩展、XRECHNUNG. 2025 年及以后的生产发票和 Factur-X 互操作性的正确选择。
一致性级别选项
一致性规范控制哪些发票字段是必填项并需要验证。 可用选项取决于所选的 Zugferd 版本。
最低限度仅限 2.x 版本，仅头部信息仅包含抬头数据，不包含明细项目。并非有效法律发票。仅供内部会计交接使用。
基本工作流仅限 2.x 版本，仅限增值税添加增值税明细，但不包含明细项目。仅适用于与订单核对的预订场景。
基本的两种版本，最低法定发票添加商品明细。符合欧盟电子发票指令的最低要求。适用于 1.0 和 2.x 版本。
舒适仅限 1.0 版本，扩展引用在 BASIC 的基础上添加参考数据和附加字段。仅限 ZUGFeRD 1.0，相当于现代 2.x 中的 EN16931。
EN169312.x，推荐的 B2B 默认值欧洲标准 EN 16931 完整规范。欧盟 B2B 发票的推荐默认规范，也是德国强制性规范所参考的级别。仅适用于 ZUGFeRD 2.x 版本。
扩展两个版本均包含行业额外内容在基本字段的基础上增加了行业特定字段（物流、货运、行业特定参考信息）。1.0 和 2.x 版本均可用。
XRECH2.x，德国公共部门强制性德国 XRechnung CIUS 规范，是向联邦、州和市政府开具发票的强制性要求。其验证标准比 EN16931 更为严格。仅适用于 ZUGFeRD 2.x 版本。
输出字段
| 场地 | 类型 | 它包含什么 |
|---|---|---|
File Content | Binary | Generated ZUGFeRD invoice file: hybrid PDF/A-3 for XmlWithPdf output or pure XML for XmlOnly output. Map into the next Zap step (upload, email, ERP POST). |
File Url | String | Direct URL to access the generated file: useful for sharing or downstream HTTP processing. |
File Name | String | Output filename without extension. |
Full File Name | String | Complete output filename with extension (.pdf for hybrid, .xml for XmlOnly). |
发票样本文件
在连接实际数据源之前，请使用这些示例文件测试每种输入格式的操作。对于德国 B2B 生产工作流程，请从以下示例文件开始： sample-invoice-zugferd-2.0-en16931.json （ZUGFeRD 2.0， EN16931 符合性）。
ZUGFeRD XML 示例
ZUGFeRD 1.0 基本版 XML配合使用 输入格式：XML映射到 发票 XML 数据。
ZUGFeRD-invoice-sample.xmlZUGFeRD 2.0
ZUGFeRD 2.0 XML 示例 (EN16931)
ZUGFeRD 2.0 EN16931 XML 包含买卖双方信息、明细项目、增值税和金额汇总，采用跨行业发票格式。可与以下产品一起使用： 输入格式：XML， ZUGFeRD 版本：2.0， 符合性：EN16931。
ZUGFeRD-invoice-sample-2.0.xml受到推崇的
JSON 2.0 EN16931 示例
完整结构化发票 ZUGFeRD 2.0 和 EN16931 符合性。与……一起使用 输入格式： JSON， Zugferd 版本：2.0， 符合性等级：EN16931映射到 发票 JSON 数据。
sample-invoice-zugferd-2.0-en16931.jsonJSON 发票示例（基础版）
更简单 JSON 用于烟雾测试 ZUGFeRD 1.0 和 基本的 符合性。
示例发票.jsonCSV格式发票样本
平坦的 CSV 行 输入格式：CSV映射到 发票 CSV 数据。
测试发票.csvZUGFeRD 2.0
CSV 2.0 发票示例
扩展的 22 列 CSV：发票编号、开票日期、卖家/买家地址字段、卖家增值税号、产品编号、货币、付款参考号 IBAN，BIC。与 输入格式：CSV， ZUGFeRD 2.0。
zugferd-invoice-2.0.csv快速设置
- 在 Zapier， 点击 + 添加新操作并选择 PDF4me。
- 选择 创建 ZUGFeRD 发票 作为行动事件。
- 连接您的 PDF4me 帐户或粘贴您的 API 出现提示时按下按键。
- 为了 XmlWithPdf 输出，映射 文件 和 文件名 到您的布局 PDF （通常是之前通过 Dropbox 或 Google Drive 下载文件的步骤）。 XmlOnly这些可以留空。
- 放 输入格式 到 XML， JSON， 或者 CSV 取决于您的数据来源。
- 充满 仅有的 匹配的发票数据字段：发票 XML 数据、发票 JSON 数据或发票 CSV 数据。其他两个字段留空。
- 放 输出模式 到 XmlWithPdf （混合文件，规范的 ZUGFeRD）或 XmlOnly （纯的 XML）。
- 选择 祖格费尔德版本： 2.0+ 针对2025年及以后的德国B2B强制性合规要求， 1.0 仅适用于旧款接收器。
- 选择 符合性级别： EN16931 对于一般的 B2B（2.x）， XRECHARGE 对于德国公共部门而言， 基本的 适用于 ZUGFeRD 1.0 旧版本。
- 切换 在 PDF 上渲染发票 到 真的 如果你想 PDF4me 在屏幕上以可视化的方式呈现发票内容 PDF； 错误的 如果你的模板 PDF 已显示布局。
- 放 语言 匹配买家所在地区的区域代码（
de，en，fr，it，es，nl，pl，pt）。 - 点击 测试操作验证输出结果，然后打开 Zap。
工作流程示例
工作流程示例Common Zapier workflow patterns using Create ZUGFeRD Invoice.
SaaS webhook JSON → ZUGFeRD 2.x EN16931 → 电子邮件客户
- 你的 SaaS 计费系统向……发送 webhook Zapier 当向德国 B2B 客户开具发票时。
- PDF4me 创建 ZUGFeRD 发票运行：输入格式 = JSON，发票 JSON 数据映射自 webhook 有效负载，输出模式 = XmlWithPdf，Zugferd 版本 = 2.0，符合性 = EN16931，语言 = de。
- 混合型 PDF （人可读 + 机器可解析）附加到 Gmail 步骤并发送到客户的应付账款地址，满足 2025 年及以后的 B2B 电子发票要求。
- Google Sheets 中的一行记录发票 ID、客户、金额和时间戳，用于审计报告。
- A SharePoint 上传 ZUGFeRD 的副本存档 PDF 为了合规保留。
ERP CSV 导出 → XRECHNUNG → 德国公共部门门户网站
- 每个工作日 16:00 都会运行一个定时 Zap 程序来处理待处理的公共部门发票。
- Dropbox 触发器会获取最新内容 ERP CSV 导出和布局 PDF。
- PDF4me 创建 ZUGFeRD 发票运行：输入格式 = CSV发票 CSV 数据 = CSV 文件，输出模式 = XmlWithPdf，Zugferd 版本 = 2.0，一致性 = XRACHNUNG，语言 = de。
- 符合规范的 XRECHNUNG 混合型 PDF 通过 Webhook 步骤向联邦 ZRE 门户或相关的州电子发票端点发送 POST 请求。
- 系统会向 AR 团队发送一封确认邮件，其中包含提交参考编号；PostgreSQL 日志会记录审计跟踪信息。
预构建 XML → 仅 XML → EDI 合作伙伴集成
- 你的 ERP 已生成符合 ZUGFeRD 标准的文档 XML 通过其导出模块导出发票并将其放入 Google 云端硬盘文件夹。
- Zapier 每个新触发器 XML 文件。 PDF4me 创建 ZUGFeRD 发票运行：输入格式 = XML发票 XML 数据 = XML 文件，输出模式 = XmlOnly，Zugferd 版本 = 2.0，符合性 = EN16931。
- 经过验证的纯-XML 发票通过SFTP发送到交易伙伴的EDI端点，没有。 PDF 系统间交接需要封装器。
- Slack 通知确认 EDI 交付；Airtable 记录更新，包含合作伙伴和提交时间戳。
常见问题解答
相关操作
创建瑞士二维码钞票
瑞士制造 QR 发票中嵌入了付款单 PDFs与 ZUGFeRD 配合使用，可实现涵盖德国、奥地利和瑞士的跨境 DACH 发票处理。
创造 PDF/一个
转变 PDFs 到 PDF一种存档格式，在准备布局时很有用。 PDFs 对于必须满足以下条件的 ZUGFeRD 混合发票 PDF/A-3 合规性。
分类文件
自动分类传入数据 PDFs 在创建发票之前或之后，将发票、合同和收据路由到正确的下游 Zap 分支机构。
在其他平台上执行相同任务
创建 ZUGFeRD 发票（生成）
相同的电子发票操作 Make 场景相同，参数模型相同，一致性级别相同。
创建 ZUGFeRD 发票（Power Automate）
Power Automate / Microsoft 365 流量，非常适合 SharePoint 和 Outlook-驱动的开票。
创建 ZUGFeRD 发票 (n8n)
自托管 n8n 工作流程，同样的电子发票自动化，对开发者友好 JSON 表达式支持。