在 ZUGFeRD 中创建发票 n8n
此节点的功能
PDF4me 创建 Zugferd 发票 生成完全合规的 ZUGFeRD 混合电子发票 （结构化的PDF/A-3文档） XML 发票数据（嵌入在内）直接在您的 n8n 工作流程。转换 XML， JSON， 或者 CSV 将发票数据合并到一个混合文件中，以便于使用。 德国B2B电子发票强制令符合欧盟 EN 16931 标准或德国 XRECHNUNG 公共部门规范。支持 ZUGFeRD 1.0 至 2.4 的所有版本，并在一个节点中支持所有六个合规级别。
相关博客文章(1)
验证您的身份 API 要求
每一个 PDF4me 节点 n8n 需要有效 用于连接的凭证创建或选择一个可以容纳您的 PDF4me API 关键在于确保工作流程能够安全地验证 ZUGFeRD 发票生成请求。
您不容错过的重要事实
ZUGFeRD 是一种混合型 PDF/A-3+ XML 格式，而非纯粹的 XML 标准
输出文件为单个 PDF/A-3 格式的存档级文件。 PDF 结构化 XML 发票附在里面。人们会阅读它。 PDF机器解析 XML无需发送单独的文件。生成纯文件 XML 没有 PDF 将 wrapper 的输出模式设置为“仅 XML”；要生成混合文件，请将其设置为“XML 与 PDF”（默认值）。
ZUGFeRD 2.0+ 是 2025-2028 年德国 B2B 指令的必要条件。
德国《增长机会法案》（Wachstumschancengesetz）规定，自2025年1月1日起，所有B2B交易必须接收电子发票，并于2028年全面实施电子发票发送义务。符合EN16931或XRECHNUNG标准的ZUGFeRD 2.0或更高版本满足此项要求。旧版ZUGFeRD 1.0不符合要求。
符合性级别控制合规性：EN16931 为安全默认值
对于欧盟范围内的通用 B2B 发票，请选择 EN16931（欧洲标准）；对于德国公共部门实体的发票，请选择 XRECHNUNG；对于超出 EN 16931 基准范围的行业特定字段，请选择 EXTENDED。MINIMUM 和 BASICWL 会省略行项目，不能用于完整发票；仅适用于内部会计归档。
参数
必需 n8n 用户界面： 连接凭证、输入数据类型、文档名称（即使输入数据类型为 None 也始终需要，用作文档名称回退）、输出模式、Zugferd 版本、在 PDF 上渲染发票、语言、输入格式和发票数据输入类型。 符合性级别 根据 Zugferd 版本分支显示和必填项，1.0、2.0/2.1/2.2/2.4 和自定义版本具有不同的字段名称和选项集。匹配的发票数据字段（发票） XML/JSON/CSV 数据，二进制属性， Base64 根据发票数据输入类型，需要提供内容（或数据 URL）。运行时验证会强制要求所选路径包含非空内容，并会显示“发票…数据为空”或“发票 base64 内容为空”之类的错误。
满的 参数 查看；与下表一起使用，以定位节点中的每个字段。
| 范围 | 必需的 | 它的作用 | 例子 |
|---|---|---|---|
| Input Data Type | Conditional | How the background PDF (the visual layer of the hybrid invoice) is supplied. None creates the PDF from invoice data alone. Binary Data reads from a previous n8n node. Base64 String accepts encoded 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. | data |
| Base64 Content | Conditional | Base64-encoded PDF string. Required when Input Data Type is Base64 String. | JVBERi0xLjQK... |
| File URL | Conditional | Public URL to the source PDF. Required when Input Data Type is URL. | https://example.com/invoice.pdf |
| Document Name | Yes | Filename of the source PDF document. Always required in the UI, including when Input Data Type is None (used as document name fallback in the payload). Include the .pdf extension. | invoice.pdf |
| Output Mode | Yes | XML Only generates a pure XML file. XML With PDF generates the full hybrid ZUGFeRD file: a PDF/A-3 document with structured XML embedded inside. XML With PDF is the canonical ZUGFeRD output. | XML With PDF |
| Zugferd Version | Yes | ZUGFeRD specification version. 1.0 is legacy and does not satisfy the German B2B mandate. 2.0 through 2.4 all support EN 16931. 2.2 and 2.4 add the latest XRECHNUNG profile updates. Custom enables advanced version handling. | 2.0 |
| Zugferd Version Custom | Conditional | Custom ZUGFeRD version identifier. Shown and required only when Zugferd Version is Custom (the execute step throws if empty). | 2.3.1 |
| Conformance Level | Conditional | Profile controlling which invoice fields are required. Shown when Zugferd Version is 1.0 (legacy options). Switches to Conformance Level (Above 2) for versions 2.0/2.1/2.2/2.4 and Custom (MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG). | EN16931 |
| Language | Yes | Display language for invoice labels in the rendered PDF. Options: German, French, Italian, English, Spanish, Dutch, Polish, Portuguese. The XML data itself remains language-neutral. | German |
| Render Invoice On PDF | Yes | Toggle (ON/OFF). When enabled, PDF4me visually renders the invoice content on the PDF using your invoice data. When disabled, only the structured XML is generated and embedded, useful when you supply a pre-designed background PDF. | true |
| Input Format | Yes | Format of the invoice data you are providing. XML for pre-built ZUGFeRD XML or UBL data. JSON for structured invoice objects. CSV for tabular batch exports. | XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 sample |
| Invoice Data Input Type | Yes | How the invoice data reaches the node. Direct Text accepts pasted or mapped data inline. Binary Data reads from a previous file node. Base64 String for encoded payloads. URL downloads from a public link. | Direct Text |
| Invoice XML / JSON / CSV Data | Conditional | The actual invoice content. Appears as Invoice XML Data, Invoice JSON Data, or Invoice CSV Data, matching the chosen Input Format. Required when Invoice Data Input Type is Direct Text. Runtime also throws "Invoice … data is required" if empty. | XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 samplePaste, map, or load via Binary / Base64 / URL to match the format you chose above. |
| Invoice Binary Property Name | Conditional | Name of the binary field holding the invoice data file. Required when Invoice Data Input Type is Binary Data. | data |
| Invoice Base64 Content | Conditional | Base64-encoded invoice data. Required when Invoice Data Input Type is Base64 String. Runtime also throws "Invoice base64 content is required" if empty. | PGludm9pY2U+... |
| Invoice Data URL | Conditional | Public URL to the invoice data file. Required when Invoice Data Input Type is URL. | https://example.com/invoice.json |
| Output File Name | No | Filename for the generated ZUGFeRD invoice. Default provided and normalized in execute (e.g. extension matched to Output Mode). Use .pdf for XML With PDF and .xml for XML Only. | zugferd_invoice.pdf |
| Output Binary Field Name | No | Name of the binary field holding the generated ZUGFeRD file. Defaults to data. Used to reference the file in subsequent workflow nodes. | data |
发票样本文件
在连接实际数据源之前，请使用这些示例文件测试节点对每种输入格式的兼容性。对于德国 B2B 生产工作流程，请从以下示例开始： sample-invoice-zugferd-2.0-en16931.json （ZUGFeRD 2.0， EN16931 符合性）。
手铐 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高级选项
所有字段都位于 高级选项 收藏是可选的。可通过以下方式添加： 添加选项 在节点用户界面中。
简介风俗 PDF4me 处理配置文件。应用预配置的选项集，以生成高级或专门的 ZUGFeRD 发票（例如自定义验证规则、替代模式映射或特定行业的输出调整）。
输入数据类型选项
控制如何 背景 PDF 文档 （混合发票的视觉层）提供给节点。
输入数据类型下拉菜单：控制后台显示方式 PDF 到达节点
没有任何仅支持 XML/JSON/CSV，不支持背景 PDF无需输入任何文件。 PDF4me 生成视觉效果 PDF 层和结构化 XML 仅使用发票数据。当只有发票数据且您只想获取发票信息时，请使用此选项。 PDF4me 渲染完整的混合文件。
二进制数据来自上一个节点的文件（最常见）阅读背景 PDF 直接从先前的输出中提取二进制数据 n8n 节点：Google 云端硬盘下载 HTTP 请求或读取二进制文件。二进制属性字段指定要读取的输出字段（默认值）
数据）。Base64字符串Base64编码的文件内容接受背景 PDF 以 base64 编码字符串的形式。当文件来自……时，请使用此格式。 API 响应、webhook 有效负载或以 base64 格式存储文档的数据库列。
URL从公共链接下载提供公开访问 URL 到背景 PDF。 PDF4me 在生成混合发票之前直接下载文件。 URL 不得要求身份验证。
输出模式选项
控制节点是否产生纯 XML 文件或完整的 ZUGFeRD 混合格式（PDF/A-3 + 嵌入式） XML）。
输出模式下拉菜单有两个选项：纯 XML 或混合 PDF/A-3 XML 嵌入式
仅限 XML纯的 XML， 不 PDF 包装纸仅输出结构化数据。 XML 发票数据。用于接收系统处理发票时。 XML 直接丢弃视觉内容，适用于 XRechnung 纯 XML 提交，或用于单独测试数据层。设置输出文件名扩展名。
.xml。XML 和 PDF默认值：完整的 ZUGFeRD 混合文件生成标准的 ZUGFeRD 混合发票：PDF/A-3 格式，符合存档标准 PDF 结构化 XML 发票数据以附件形式嵌入其中。由人阅读。 PDF机器解析 XML这是用于生产 B2B 电子发票的标准 ZUGFeRD 输出。
ZUGFeRD 版本选项
生成的发票中嵌入了 ZUGFeRD 规范版本。
ZUGFeRD 版本下拉菜单提供六个版本选项，包括旧版 1.0 和最新版 2.4。
1.0遗留问题：不符合2025年的要求2014 年原始规格。仅兼容旧款接收系统。 不是 符合德国自 2025 年起生效的 B2B 电子发票强制规定。避免用于新的工作流程。
2.0默认值：广泛兼容性首个符合 EN 16931 标准的版本（2019 年）。满足德国 B2B 强制性要求，是通用 B2B 发票的安全默认选项。与 Factur-X 1.0 完全兼容。
2.1细微改进在 2.0 版本的基础上增加了一些细微的架构改进和说明。当您的接收系统明确要求 2.1 版本时，请使用此版本。
2.2XRECHNUNG 简介已更新与更新后的 XRECHNUNG 配置文件版本 2.x 一致。在向需要使用较新配置文件的德国公共部门实体开具发票时，请选择此选项。
2.4最新消息：最新的 XRECHNUNG 支持最新发布的规范。包含对最新 XRACHNUNG 配置文件和架构增强功能的支持。请根据接收方需要的最新版本进行选择。
风俗高级版本处理当特定接收系统需要非标准版本标识符时，启用自定义版本处理功能。仅在您的发票对方明确指示时使用。
一致性级别选项
合规性配置文件控制哪些发票字段是必填和可验证的，这是合规性方面最关键的选择。
合规级别下拉菜单包含从最低到最高六个级别，用于控制现场要求和合规范围。
最低限度仅包含抬头，并非有效发票仅包含表头数据：参与方、总计、单据参考信息。 没有明细项目。 不能用作正式发票；仅供内部会计交单或状态通知使用。
基本工作流基本款（不含线条）：仅含增值税在最低限额的基础上，增加了增值税/税费明细。 没有明细项目。 用于仅用于预订的场景，其中发票与订单进行核对，而不是作为独立的法律发票。
基本的最低法定发票在 BASICWL 的基础上增加了明细项目。满足欧盟电子发票指令的最低要求。适用于简单的发票，但对于完整的 B2B 合规性而言，EN16931 是更稳妥的默认标准。
EN16931默认值：欧洲标准欧洲标准 EN 16931 完整版。 欧盟范围内B2B发票的推荐默认设置 并符合德国2025年强制性规定所参考的合规级别。包含合规商业发票所需的所有字段。
扩展行业特定附加功能除了 EN 16931 标准之外，还添加了行业特定字段，例如额外的物流、货运或特定领域的参考信息。当您的行业协议或贸易伙伴要求使用扩展字段时，请使用此标准。
XRECHARGE德国公共部门强制性德国 XRechnung CIUS 概况， 向德国联邦、州和市级政府机构开具发票是强制性的。 比 EN16931 更严格的验证标准。适用于接收方为德国公共部门实体的情况。
语言选项
渲染后的发票标签的显示语言 PDF 层。 XML 数据本身与语言无关。
语言：渲染结果的本地化标签 PDF （德语是德国B2B和B2G的典型特征）。
德语默认，德语 B2B/B2G英语国际发票法语Factur-X 工作流程意大利语意大利B2B西班牙语西班牙B2B荷兰语荷兰/比利时抛光波兰B2B葡萄牙语葡萄牙/巴西输入格式选项
您提供给节点的发票数据格式。
输入格式： 选择 XML， JSON， 或者 CSV 与您的发票有效载荷匹配。
XML预制件 XML 发票提供已格式化的符合 ZUGFeRD 标准的数据 XML 或 UBL XML 数据。当您使用时 ERP 已生产标准 XML 只需用混合包装纸包装的发票 PDF。
JSON默认值：现代 API 来源供应发票数据结构化 JSON 对象。当发票数据通过 webhook 到达时，最常见的选择是对象类型。 REST API或者现代会计软件。 PDF4me 地图 JSON ZUGFeRD 的场 XML 自动构建模式。
CSV表格形式的批量发票数据供应发票数据 CSV适用于从电子表格、旧系统或批量计费场景中批量导出发票。 PDF4me 地图 CSV 将列添加到 ZUGFeRD 模式。
发票数据输入类型选项
控制发票数据（ XML， JSON， 或者 CSV 内容）到达节点。
发票数据输入类型如何 XML， JSON， 或者 CSV 有效载荷以内联形式提供（来自先前节点的二进制数据、base64 编码或其他形式）。 URL）。
直接文本默认值：粘贴或内联映射将发票数据直接粘贴或映射到“发票数据”字段中。最适合 JSON 或更小 CSV 来自上游节点的有效载荷。使用 n8n 使用表达式语法动态构建数据。
二进制数据来自上一个节点的文件读取发票数据文件（XML， JSON， 或者 CSV直接从先前的二进制输出中获取 n8n 节点：Google 云端硬盘下载、读取二进制文件或 HTTP 请求。最适合大尺寸。 XML 文件。
Base64字符串Base64编码数据接受以 base64 编码字符串形式传入的发票数据。用于发票内容从以下位置传入的情况： API 以 base64 格式存储文件的响应或数据库字段。
URL从公共链接下载提供公开访问 URL 添加到发票数据文件。 PDF4me 下载文件并根据所选输入格式解析内容。
输出字段
| 场地 | 类型 | 它包含什么 |
|---|---|---|
fileName | String | Filename of the generated ZUGFeRD invoice, for example zugferd_invoice.pdf for XML With PDF output or zugferd_invoice.xml for XML Only output. |
mimeType | String | MIME type of the output file: application/pdf for hybrid output, application/xml for XML Only. Useful for content type validation in downstream HTTP or storage nodes. |
fileSize | Number | Size of the generated ZUGFeRD file in bytes. Useful for storage planning, bandwidth monitoring, and conditional routing in the workflow. |
success | Boolean | True when the ZUGFeRD invoice was generated successfully. False if validation failed or input data was malformed. Use this field to route error handling branches. |
message | String | Human-readable status message confirming success or describing the validation/parsing error encountered. Useful for logging and error notification steps. |
快速设置
- 添加 PDF4me 致你 n8n 工作流程。设置 资源 到 发票 和 发票操作 到 创建 Zugferd 发票。
- 在 用于连接的凭证请选择您的 PDF4me 凭证或点击 创建新凭证 并粘贴你的 API 钥匙。
- 放 输入数据类型：连接先前的节点（二进制数据），提供一个 Base64 字符串或 URL 背景 PDF或者选择“无”。 PDF4me 应该渲染 PDF 仅根据发票数据。
- 进入 文档名称 （例如
invoice.pdf）。 - 放 输出模式： XML 和 PDF 对于标准混合 ZUGFeRD 输出，或 仅限 XML 纯粹 XML。
- 选择 祖格费尔德版本 （使用 2.0 作为安全默认值； 2.4 （适用于最新的 XRECHNUNG 配置文件）。
- 选择 符合性级别： EN16931 对于一般的B2B业务， XRECH 针对德国公共部门的开票， 扩展 针对特定行业领域。
- 放 语言 对于渲染 PDF 标签（默认为德语）。
- 使能够 将发票渲染成 PDF 文件 如果你想 PDF4me 以可视化方式呈现发票内容；如果提供预先设计的背景，则禁用此功能。 PDF。
- 选择 输入格式 （JSON， XML， 或者 CSV） 和 发票数据输入类型 （直接文本、二进制数据、Base64字符串或URL）。将发票数据粘贴或映射到“发票数据”字段。
- 放 输出文件名 到
zugferd_invoice.pdf和 输出二进制字段名称 到data。 - 将输出连接到下一个节点（电子邮件发送器、云存储上传、政府门户网站）。 HTTP POST）并执行工作流。
工作流程示例
工作流程示例Common n8n workflow patterns using Create Zugferd Invoice.
会计软件 → ZUGFeRD 2.0 EN16931 发票 → 通过电子邮件发送给客户
- 当发票在会计平台（DATEV、sevDesk、lexoffice）中最终确定时，Webhook 触发器会触发。
- webhook 有效负载包含结构化的发票数据。 JSON 目的。
- PDF4me 创建 Zugferd 发票会生成混合发票。输入数据类型为 None（PDF4me 渲染 PDF 从 JSON输出模式为 XML（带 PDF），Zugferd 版本为 2.0，符合性级别为 EN16931，语言为德语，输入格式为 JSON发票数据输入类型为直接从 webhook 有效负载映射的文本。
- Gmail 节点向 ZUGFeRD 发送电子邮件 PDF 寄送到客户的应付账款地址，满足德国 B2B 接收授权要求。
- PostgreSQL 节点会记录发票号、ZUGFeRD 版本和合规级别，以便进行审计和合规性报告。
ERP XML 发票 → ZUGFeRD XRECHNUNG → 上传至公共部门门户网站
- 每个工作日 16:00 都会触发计划触发器来处理公共部门发票。
- SFTP 节点拉取新生成的 ERP XML 从导出文件夹中找到发票文件。
- PDF4me 创建 Zugferd 发票会生成符合 XRECHNUNG 标准的发票。输入数据类型为“无”，输出模式为 XML（带 PDF），Zugferd 版本为 2.4（最新 XRECHNUNG 配置文件），合规级别为 XRECHNUNG，语言为德语，输入格式为 [此处应填写输入格式]。 XML发票数据输入类型为从 SFTP 文件内容映射而来的二进制数据。
- 一个 HTTP 请求节点将 XRECHNUNG 发票上传到联邦 ZRE（联邦政府中央发票接收平台）或相关州门户网站。
- 微软 Outlook 节点向采购团队发送确认信息，PostgreSQL 节点记录提交参考信息。
月度 CSV 账单批次 → ZUGFeRD 发票 → 归档 SharePoint
- 每月1日，系统会触发计划触发器来处理每月账单。
- Google 云端硬盘节点下载合并后的数据。 CSV 账单导出，每行对应一张客户发票。
- “拆分批次”节点遍历每个批次。 CSV 排。 PDF4me 创建 Zugferd 发票会为每个客户生成一张 ZUGFeRD 发票。输入数据类型为“无”，输出模式为 XML（带 PDF），Zugferd 版本为 2.0，符合性级别为 EN16931，语言因客户所在地区而异，输入格式为 CSV发票数据输入类型为直接文本，内容为每行 CSV 文件。
- 微软 SharePoint 节点上传每个 ZUGFeRD PDF 到客户的账单存档文件夹。
- Gmail 节点会向每位客户发送混合发票；最终的 PostgreSQL 汇总行会记录批处理运行情况，包括发票数量和总金额。
常见问题解答
相关操作
创建瑞士二维码钞票
生成嵌入发票中的瑞士二维码付款单 PDFs 适用于瑞士银行支付标准。可与 ZUGFeRD 配合使用，实现跨境 DACH 发票处理。
创造 PDF/A
转变 PDFs 到 PDF/A 存档格式，在准备背景资料时很有用 PDFs 适用于必须符合 PDF/A-3 标准的 ZUGFeRD 混合发票。
AI发票解析器
从传入数据中提取结构化发票数据 PDFs. 与 Create Zugferd Invoice 配合使用，将旧版发票转换为符合 ZUGFeRD 格式。
在其他平台上执行相同任务
创建 ZUGFeRD 发票（生成）
与 Make 模块相同的电子发票操作：相同的参数模型和一致性级别，非常适合连接 Dropbox、Google Drive 等的视觉场景构建器。 ERP 出口。
创建 ZUGFeRD 发票（Zapier）
操作方式与 Zapier 操作相同，非常适合 SaaS由 Webhook 触发的 B2B 发票管道向 Gmail 发送数据， Salesforce以及会计工具。
创建 ZUGFeRD 发票（Power Automate）
Power Automate / Microsoft 365 流量，非常适合 SharePoint， Outlook以及在受监管的 DACH 环境中基于 Dataverse 的企业发票。