Skip to main content
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 中提取的發票資料。

範例