跳转到主要内容
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 文件交互： 端口会根据提供的输入类型确定要执行的操作。

​
端口配置

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

​
设置选项卡

​
配置

与建立连接相关的设置。

​
高级设置

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

​
高级选项卡

​
消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置描述
保存到已发送文件夹选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

​
日志

用于管理日志创建和存储的设置。

设置描述
日志级别指定要记录在端口日志目录中的信息类型：
  • None - 不创建任何日志。
  • Error - 仅当端口遇到错误时才创建日志。
  • Warning - 仅当端口发出警告时才创建日志。
  • Info - 记录工作流的一般信息，包括任何错误和警告（如果适用）。
  • Debug - 记录成功和失败工作流的详细调试信息。
  • Trace - 记录成功和失败工作流的详细跟踪信息。
请注意：Debug 和 Trace 级别的日志可能会记录敏感信息，包括消息内容和 SSL 证书。尽管连接属性（例如密码）被屏蔽了，但在与您的组织外部共享它们之前，请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口，使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本指示端口在日志目录中保存最新消息副本的切换。请注意，端口每个子文件夹只保留一个消息，并且端口在再次运行时会覆盖以前保存的消息。

​
其他设置

​
杂项

特殊设置适用于特定用例。

设置描述
其他设置允许在以分号分隔的列表中配置隐藏的端口设置，例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

​
自动化选项卡

​
自动化设置

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

​
性能

与端口资源分配相关的设置。

设置描述
最大工作线程数此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置，则会覆盖 高级设置 页面的 性能设置 部分的默认设置。
最大文件数分配给端口的每个线程发送的最大文件数。如果设置，则会覆盖 高级设置 页面的 性能设置 部分的默认设置。

​
警报选项卡

​
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 中提取的发票数据。

​
宏

​
示例