跳转到主要内容
ZUGFeRD 端口从 PDF 和 XML 发票文件生成 ZUGFeRD 文件,或从 ZUGFeRD 文件中提取发票 XML 文件。

核心功能

  • 德国电子发票标准,结合 PDF 与 XML,并支持双向处理(提取 XML 或生成 ZUGFeRD 文件)
  • 支持版本 1.0、2.0、2.1,以及多种一致性级别(MINIMUM、BASIC、EN 16931、EXTENDED 和 XRECHNUNG)
  • 支持 PDF/A-3 格式,可在人工可读 PDF 中嵌入机器可读 XML,并支持批处理组处理

概述

ZUGFeRD 端口通过集成 ZUGFeRD(Zentraler User Guide des Forums elektronische Rechnung Deutschland)标准来促进电子发票交换,该标准将人类可读和机器可读的数据结合在单个文档中。它基于 PDF/A-3 标准,允许将 XML 数据嵌入 PDF 文件。这种混合格式确保发票既可以被人轻松阅读,也可以由计算机系统自动处理。ZUGFeRD 端口允许你通过两种方式与 ZUGFeRD 文件交互: 端口会根据提供的输入类型确定要执行的操作。

端口配置

本节包含所有可配置的端口属性。

设置选项卡

配置

与建立连接相关的设置。

高级设置

前述类别中未包含的设置。

高级选项卡

消息

日志

其他设置

杂项

自动化选项卡

自动化设置

与端口自动处理文件相关的设置。

性能

警报选项卡

SLA 选项卡

解析 ZUGFeRD 文件

端口期望接收 PDF 文件作为输入,并读取该文件以提取附加的 XML,然后发送到工作流下游。

处理多个附件

你可能会收到包含多个附件的 PDF 文件。默认情况下,端口会将所有附件传递到工作流下游,并为每条消息添加消息头:
  • ZUGFeRD-File-Index:每个附件的附件编号
  • ZUGFeRD-File-Count:电子邮件中的附件总数
  • ZUGFeRD-File-Name:原始 PDF 文件名
  • ZUGFeRD-File-Description:发票 XML 和附件的说明
  • ZUGFeRD-File-Parameters:发票 XML 和附件的其他文件参数
  • ZUGFeRD-File-Relationship:发票 XML 和附件的文件关系。发票 XML 通常为 “Alternative”,附件通常为 “Data”、“Supplement” 等。
  • ZUGFeRD-File-Subtype:发票 XML 和附件的文件子类型。这通常是文件的 MIME-Type,例如 text\xml 或 application\pdf。

生成 ZUGFeRD 文件

端口期望接收一个批处理组,其中恰好包含一条 PDF 批处理消息和一条 XML 批处理消息。在工作流中将这些批处理组发送到 ZUGFeRD 端口之前,请使用 Batch Create 端口创建它们。如果包含多于一条 PDF 或 XML 批处理消息,或者批处理组中缺少其中任意一种消息,则会引发错误。 UI 中所有 ZUGFeRD 特定设置(版本、一致性级别和发票说明)仅用于生成 ZUGFeRD 文件。解析完全不涉及这些设置。
  • 版本:控制生成文件时使用的 ZUGFeRD 版本。 支持版本 1.0、2.0 和 2.1。
  • 一致性级别:ZUGFeRD 标准主要包括以下一致性级别:
    • MINIMUM
      • 包含最基本的发票信息,例如发票号、日期和金额。
      • 数据以 PDF/A-3 格式嵌入,便于人类阅读和简单系统处理。
    • BASIC
      • 在 MINIMUM 级别的基础上包含更多结构化数据,例如买方和卖方详细信息、税务信息和付款条件。
      • 适用于需要适度自动化的场景。
    • BASIC WL
      • 与 BASIC 类似,但针对特定用例定制,通常包含某些行业或地区的附加字段。
      • 增强专门场景中的互操作性。
    • EN 16931 (COMFORT)
      • 符合欧盟标准 EN 16931,为高度自动化处理提供完整的结构化数据。
      • 适合复杂业务流程和系统集成。
    • EXTENDED
      • 在 EN 16931 的基础上扩展,允许包含行业或公司特定的附加信息。
      • 专为具有独特需求的企业设计。
    • XRECHNUNG
      • 基于 ZUGFeRD 的德国特定配置文件,符合公共部门发票的 XRechnung 标准。
      • 确保符合德国公共采购法规。
  • 发票说明:PDF 阅读器会显示 PDF 附件的可选说明。此设置控制 XML 附件使用的说明。

生成示例文件

若要生成可用于测试的示例文件,请导航到端口的 交易 选项卡,然后点击 生成示例文件 生成示例文件 按钮。这会在 Send 文件夹中创建一个 PDF 文件。端口处理该 PDF 时,会生成一个 XML 输出文件,其中包含从 PDF 中提取的发票数据。

示例