在 Power Automate 中创建 ZUGFeRD 发票
创建 ZUGFeRD 发票 是一个 Power Automate 采取行动 PDF4me 生成符合 ZUGFeRD 标准的混合电子发票，单个 PDF/A-3 文件结构化 XML 内置于系统中。可用于满足德国B2B电子发票要求，并可与任何系统交换符合EN 16931标准的电子发票。 ERP或者将一个文件存档，该文件既可供人类读取，也可供机器读取。
此操作的作用
PDF4me 创建 ZUGFeRD 发票 构建 符合 ZUGFeRD 标准的混合电子发票单个 PDF/A-3 档案 PDF 带有结构化发票 XML 嵌入内部，直接嵌入 Power Automate 流程。人类解读 PDF； ERPs 和清算平台解析 XML该行为满足了 德国的B2B电子发票强制令 （自2025年1月1日起生效，2028年之前全部寄出）以及相关内容 16931年 欧洲标准。将发票数据映射为 XML， JSON， 或者 CSV 从 SharePoint， OneDrive， Outlook或者 Dataverse，并将混合输出路由到您的归档，您的 ERP或者一步到位地满足您的客户需求。
相关博客文章(2)
如何验证我的 Power Automate 流程？
致电 PDF4me 通过 Power Automate流程需要一个有效的 PDF4me API 关键在于 PDF4me 连接 连接器。身份验证可确保通信安全，并验证您的身份是否为授权用户。您可以从开发者控制面板获取或轮换密钥。
您不容错过的重要事实
ZUGFeRD 是一种混合型 PDF/A-3 + 嵌入式 XML并非纯粹的 XML 格式
默认值
XmlWithPdf 输出结果为一个文件：一个归档文件 PDF/A-3 具有结构化的 ZUGFeRD XML 附着在里面。人类打开 PDFAP系统解析 XML。 放 XmlOnly 只有当接收系统消耗纯净物时 XML。2025 年德国 B2B 指令要求采用 ZUGFeRD 2.0 或更高版本。
德国的《增长机会法》规定，电子发票收据必须从……开始使用。 2025年1月1日，并分阶段全面履行发送义务 2028ZUGFeRD 2.0 及以上版本（符合 EN 16931 标准）满足要求；旧版 1.0 不符合要求。请选择您的连接器支持的最高版本（ZUGFeRD 版本 + 输入格式下拉列表会列出该版本）。
映射一个发票数据字段，绝不映射两个。
行动表明
发票 XML 数据， 发票 JSON 数据， 或者 发票 CSV 数据 根据组合下拉菜单的格式部分进行匹配。仅映射匹配项。在同一次运行中填充两个数据字段是导致验证失败的最常见原因。
主要的 参数 标签。 ZUGFeRD 版本和输入格式 是一个组合下拉菜单（此处）。 2.0-XML）。
高级参数。 语言 默认值 的也接受 英语、法语、意大利语、西班牙语、荷兰语、波兰语、葡萄牙语、捷克语。
ZUGFeRD、Factur-X 和 XRechnung：选择合适的配置文件
| 格式 | 它的使用场景 | 输出类型 | 何时选择 |
|---|---|---|---|
| ZUGFeRD | Germany, EU B2B, supplier-to-buyer invoicing | Hybrid PDF/A-3 + embedded XML | General B2B; you want one file for humans and machines. |
| Factur-X | France (sister format, technically identical to ZUGFeRD 2.x) | Hybrid PDF/A-3 + embedded XML | Cross-border FR<>DE invoicing; the same hybrid file works on both sides. |
| XRechnung | German public sector (federal, state, municipal) | Strict pure XML profile | You invoice a German public-sector authority; switch to an XRechnung-aligned profile when the receiver demands pure XML. |
参数
操作中需要： ZUGFeRD 版本和输入格式、输出模式的匹配 发票 XML / JSON / CSV 数据 字段和一致性级别。 PDF 文件内容 和 文件名 仅当输出模式为 XmlWithPdf。 输出文件名 设置生成的混合文件的文件名。 开具发票 PDF 默认值为真。 语言 生活在 高级参数 并默认为 的。
| 范围 | 必需的 | 它的作用 | 例子 |
|---|---|---|---|
| ZUGFeRD version and Input Format | Required | Combined dropdown that picks both the ZUGFeRD specification version (1.0, 2.0, etc.) and the shape of your invoice data (XML, JSON, CSV) in a single setting. The value drives which Invoice Data field appears below and which Conformance Level set is offered. | 2.0-XML |
| Output Mode | Required | XmlWithPdf returns the canonical hybrid PDF/A-3 file with the XML embedded inside. XmlOnly returns the XML invoice file alone. PDF File Content and File Name are only required for XmlWithPdf. | XmlWithPdf |
| Invoice XML Data | Conditional | Required when the Input Format part of the combined dropdown is XML. Map your ZUGFeRD XML payload from a previous action (Get file content, Compose, etc.). | File Content |
| Invoice JSON Data | Conditional | Required when the Input Format part is JSON. Map a structured invoice JSON object that PDF4me converts to the ZUGFeRD XML schema before embedding. | File Content |
| Invoice CSV Data | Conditional | Required when the Input Format part is CSV. Map a tabular CSV row that PDF4me converts to the ZUGFeRD XML schema before embedding. | File Content |
| Conformance Level | Required | Profile that controls how rich the invoice data must be. BASIC is the entry-level profile with line items, suitable for most B2B receivers. COMFORT adds additional fields for richer content. EXTENDED is the largest set, used for industry-specific scenarios beyond the EN 16931 baseline. | BASIC |
| Render Invoice on PDF | Required | When set to Yes (default), PDF4me visually renders the invoice content on the PDF pages using your invoice data. Set to No when you supply a pre-designed background PDF and only need the XML embedded without redrawing the content. | Yes |
| PDF File Content | Conditional | Required when Output Mode is XmlWithPdf. Map the background PDF bytes from a previous action (Get file content from SharePoint / OneDrive / Outlook / Dataverse). Skip for XmlOnly. | File Content |
| File Name | Conditional | Required when Output Mode is XmlWithPdf. The source PDF filename with extension. Used for trace and naming context. | abc.pdf |
| Output File Name | Optional | Filename of the generated hybrid file or XML. Use .pdf for XmlWithPdf and .xml for XmlOnly. Helps when the downstream Create file action expects an explicit name. | Zugferd-output.pdf |
| Language | Optional | Advanced parameter. Locale used for invoice labels in the rendered PDF. Default de. Accepted codes: de, en, fr, it, es, nl, pl, pt, cs. The XML data itself stays language-neutral. | de |
输出模式选项
XmlWithPdf默认的规范 ZUGFeRD 混合文件一 PDF包含结构化发票的 A-3 文件 XML 附于其内。用于向客户开具发票，存档。 SharePoint附着于 Outlook 电子邮件，或者任何需要单个文档同时服务于人类和机器读者的场合。
XmlOnly独立版 XML 发票返回 ZUGFeRD 发票 XML 单独使用。接收时使用。 ERP清算所或中间件摄取 XML 直接和视觉 PDF 生成于其他地方或不需要。 PDF 文件内容/文件名并非必填项。
符合性等级阶梯
基本的默认值。最广泛的接收器兼容性入门级电子发票模板，包含明细项目、税务明细和交易方信息。符合欧盟电子发票最低指令要求，并被大多数B2B收款方接受。从这里开始进行兼容性测试。
舒适更丰富的发票内容在基本字段的基础上添加了更多结构化字段。当您的买家或 ERP 需要比最低要求更完整的发票信息。从基本模式切换到此模式前，请确认是否支持。
扩展规模最大的行业特定套装在 EN 16931 标准基线之外，增加了行业特定字段。仅当接收方明确要求时才使用；否则，更丰富的有效载荷会增加验证阻力。
语言选项（高级）
“高级参数”部分仅显示一个字段， 语言它仅控制绘制在视觉元素上的标签所使用的语言环境。 PDF; 这 XML 数据保持语言中立。默认值为 de。
| 代码 | 语言 | 典型用途 |
|---|---|---|
de | German | Default. German domestic invoicing. |
en | English | Cross-border B2B in English-speaking markets. |
fr | French | France or French-speaking Switzerland (also pairs with Factur-X workflows). |
it | Italian | Italy or Italian-speaking Switzerland. |
es | Spanish | Spain and Spanish-speaking partners. |
nl | Dutch | Netherlands and Flemish Belgium. |
pl | Polish | Poland. |
pt | Portuguese | Portugal and Portuguese-speaking partners. |
cs | Czech | Czechia. |
发票样本文件
在连接实际数据源之前，请使用这些工具测试每种输入格式的流程。对于符合 2025 年要求的德国 B2B 生产工作流程，请从以下方面开始： JSON 2.0 EN16931 样本。
手铐 XML 样本
ZUGFeRD 1.0 基本版 XML。 挑选 1.0-XML 在组合下拉菜单中，然后将其映射到 发票 XML 数据。
ZUGFeRD-invoice-sample.xmlZUGFeRD 2.0
ZUGFeRD 2.0 XML 样品（EN16931）
ZUGFeRD 2.0 EN16931 XML 包含买卖双方信息、明细项目、增值税和金额汇总，采用跨行业发票格式。 2.0-XML。
ZUGFeRD-invoice-sample-2.0.xml受到推崇的
JSON 2.0 EN16931 样品
完整结构化发票 ZUGFeRD 2.0 EN16931。 挑选 2.0-JSON然后映射到 发票 JSON 数据。
sample-invoice-zugferd-2.0-en16931.jsonJSON 发票样本（基本版）
更简单 JSON 用于烟雾测试 ZUGFeRD 1.0 和 基本的 符合性。
示例发票.jsonCSV 发票样本
平坦的 CSV 用于批量测试的行。选择 1.0-CSV然后映射到 发票 CSV 数据。
测试发票.csvZUGFeRD 2.0
CSV 2.0 发票样本
扩展的 22 列 CSV：发票编号、开票日期、卖家/买家地址字段、卖家增值税号、产品编号、货币、付款参考号 IBAN，BIC。选择 2.0-CSV。
zugferd-invoice-2.0.csv输入输出决策矩阵
| 如果您选择 | 然后地图 | 你得到 |
|---|---|---|
| ZUGFeRD version and Input Format = 2.0-XML | Invoice XML Data | ZUGFeRD 2.0 hybrid output (or XML-only) from your existing XML payload |
| ZUGFeRD version and Input Format = 2.0-JSON | Invoice JSON Data | ZUGFeRD 2.0 hybrid from a structured JSON object converted to the schema |
| ZUGFeRD version and Input Format = 2.0-CSV | Invoice CSV Data | ZUGFeRD 2.0 hybrid from a flat CSV row converted to the schema |
| Output Mode = XmlWithPdf | PDF File Content + File Name (background PDF) | PDF/A-3 hybrid file with embedded XML |
| Output Mode = XmlOnly | Invoice data only (no PDF bytes needed) | Standalone ZUGFeRD XML invoice |
如何在 Power Automate 中设置创建 ZUGFeRD 发票？
- 添加 创建 ZUGFeRD 发票 将你的工作流程增加一个新的步骤。
- 登录 PDF4me 与您的 API 钥匙。
- 挑选 ZUGFeRD 版本和输入格式 （例如 2.0-XML， 2.0-JSON， 或者 2.0-CSV）。
- 放 输出模式 到 XmlWithPdf 对于混合文件或 XmlOnly 纯粹 XML。
- 地图 仅有的 匹配的发票数据字段（XML， JSON， 或者 CSV）来自之前的操作。
- 放 符合性级别 （基本的 用于兼容性测试， 舒适 或者 扩展 当您的接收器确认支持时）。
- 离开 以 PDF 格式渲染发票 作为 是的 除非你提供预先设计好的背景。 PDF。
- 为了 XmlWithPdf， 地图 PDF 文件内容 和 文件名 来自之前的操作（获取文件内容）。
- 放 输出文件名 （
Zugferd-output.pdf或者Zugferd-output.xml）。 - 在下面 高级参数， 放 语言 如果您需要非德语语言环境下的标签。
- 路线 文件内容 输出到 SharePoint 创建文件， OneDrive 创建文件， Outlook 发送电子邮件或 Dataverse 记录。可选择链接 证实 PDF/一个 存档之前。
输出
该操作会返回生成的文件内容以及您的流程可以向下游传递的元数据。
| 场地 | 类型 | 描述 |
|---|---|---|
| File Content | Binary | The generated PDF/A-3 hybrid file (XmlWithPdf) or the standalone XML invoice (XmlOnly). |
| FileName (header) | String | Suggested output filename returned in the response headers. |
| PageCount (header) | String | Page count of the generated PDF, returned when Output Mode is XmlWithPdf. |
故障排除
发票数据映射到了错误的格式字段
如果组合下拉菜单中的“输入格式”部分是 CSV仅地图 发票 CSV 数据不要填写 XML / JSON 同一运行中的字段。每次调用选择一种格式。
PDF 当输出模式为 XmlWithPdf 时出现输出错误
PDF 文件内容 必须来自返回完整文件字节的步骤（从……获取文件内容） SharePoint / OneDrive / Outlook 附件），而不是仅包含元数据的引用，例如缺少文件有效负载的 GET 请求。
接收方拒绝了一致性级别。
首先 基本的 进行兼容性测试后，只有在接收系统确认支持后才能升级。 扩展 特别是对于针对 EN 16931 基线调谐的接收器，可能无法通过验证。
选择 Legacy 1.0 是为了符合强制性流程。
ZUGFeRD 1.0 不符合 2025 年德国 B2B 指令的要求。请选择 2.0 对于任何对强制性要求敏感的工作流程，请在 ZUGFeRD 版本和输入格式下拉菜单中选择 family（或更高版本）。
工作流程示例
工作流程示例Open by default. Four common ZUGFeRD automation patterns in a 2x2 grid.
数据宇宙到混合 PDF 档案
- 当 Dataverse 中发票行被标记为“已批准”时触发（或 ERP）。
- 撰写发票 JSON 从行列和子行项目表中。
- 获取布局 PDF 一个 SharePoint 文档库模板。
- 跑步 创建 ZUGFeRD 发票 和
2.0-JSON，XmlWithPdf，16931年对齐一致性。 - 将返回的文件内容保存到记录库中；链 证实 PDF/一个 保留前。
影响： 一个文件，既适用于人也适用于机器，非常适合审计和长期存储。
CSV 来自批次 SharePoint
- 触发新文件到达 SharePoint 舞台 文件夹。
- 阅读 CSV 发票行文件内容。
- 挑选
2.0-CSV在组合下拉菜单中；地图发票 CSV 数据。 - 放
XmlWithPdf将结果路由到 已批准的发票 图书馆。
影响： 无需手动桌面工具即可重复批量生成。
XmlOnly 到 SAP 或中间件
- 上游系统生成发票 JSON。
- 运行该操作
XmlOnly; 跳过 PDF 文件内容。 - POST 返回 XML 发送至 SAP、EDI 经纪商或电子发票清算机构。
- 用于支持追溯的日志关联 ID。
影响： 交接顺利进行 PDF shell 是在其他地方生成的。
Outlook 发送和 SharePoint 档案
- 在您的计费系统中完成发票的生成。
- 生成 ZUGFeRD 混合文件（
XmlWithPdf）。 - Outlook 发送一封包含以下内容的电子邮件 PDF/A-3 附在客户身上。
- SharePoint 在记录库中创建包含元数据列（发票编号、金额、到期日）的文件。
影响： 客户自助服务，减少“格式错误”的支持工单。
行业应用案例及应用
行业应用案例及应用Expand to see manufacturing, finance, public sector, and SaaS scenarios.
制造业和B2B
- 供应商发票适用于有严格应付账款规定的买家的混合 PDF/A-3 + XML 格式
- 订单到收款. 从 ERP 事件自动生成发票包
- 审计跟踪每次发货或里程碑交付一件产品
财务与会计
- 应收账款符合2025年要求的合规出境电子发票
- 月末从合并发票数据批量输出混合输出
- 存档在记录保留之前，请配合 PDF/A 验证。
公共部门及受监管部门
- 结构化交易所.XmlOnly 仅用于强制清算通道
- 透明度嵌入式 XML 支持自动验证
- 保留符合内部记录政策
SaaS 和平台
- 账单导出从您已发布的 JSON/CSV 文件生成 ZUGFeRD
- 多租户在您的流程中，为每个客户单独生成 JSON/XML/CSV 格式或模板的发票。
- 客户成功减少手动“再次发送发票”的循环
常见问题解答
相关操作
证实 PDF/一个
验证生成的归档文件是否符合规定。 PDF/A-3 混合文件，然后再存储到您的记录库中。
解析文档
从传入数据中提取发票数据 PDF首先，将结果输入到“创建 ZUGFeRD 发票”中，用于出站流。
生成EPC QR 代码
添加符合SEPA标准的接口 QR 支付代码至渲染结果 PDF 与 ZUGFeRD 一起 XML 嵌入。
在其他平台上执行相同任务
在 Make 中创建 ZUGFeRD 发票
同一种杂交品种 PDF/A-3 + XML 一代人 Make 模块，具有相同的一致性级别阶梯和版本+格式组合。
在 ZUGFeRD 中创建发票 Zapier
从 6000 多种方法中的任何一种触发 ZUGFeRD 生成 SaaS 应用程序和 Webhook。符合 EN 16931 标准。
在 ZUGFeRD 中创建发票 n8n
自托管或云工作流程，采用相同的发票数据输入模式和合规性等级。
创建 ZUGFeRD 发票 REST API
用于自定义后端代码或 Postman 测试的原始 POST 端点。