メインコンテンツへスキップ

ZUGFeRD請求書を作成する n8n

このノードの機能

PDF4me ツークフェルト請求書を作成する 完全に準拠した ZUGFeRDハイブリッド電子請求書 (構造化されたPDF/A-3文書) XML 請求書データは、 n8n ワークフローを変換します。 XML、 JSON、 または CSV 請求書データを単一のハイブリッドファイルにまとめ、 ドイツにおける企業間電子請求書発行義務化EU全域のEN 16931規格への準拠、またはドイツの公共部門向けプロファイルXRECHNUNGに対応しています。ZUGFeRDバージョン1.0から2.4まで、および6つの適合レベルすべてを1つのノードでサポートします。

関連ブログ記事(1)

認証 API リクエスト​

毎 PDF4me ノード n8n 有効な 接続するための認証情報. 作成または選択して、 PDF4me API ワークフローがZUGFeRDの請求書生成リクエストを安全に認証できるようにするためのキー。

見逃してはならない重要な事実​

ZUGFeRDはPDF/A-3+のハイブリッドです XML 形式ではなく、純粋な XML 標準
出力は単一のPDF/A-3アーカイブグレードファイルです。 PDF 構造化された XML 請求書が中に添付されています。人間は PDF機械は解析します XML送信する個別のファイルはありません。純粋な XML なしで PDF ラッパーの場合、出力モードを「XMLのみ」に設定します。ハイブリッドファイルを生成するには、「XMLとPDF」(デフォルト)に設定します。
ZUGFeRD 2.0+は、2025年から2028年までのドイツのB2B規制に必須である。
ドイツの成長機会法(Wachstumschancengesetz)は、2025年1月1日からすべてのB2B取引において電子請求書の受領を義務付け、2028年までに段階的に完全な送信義務を導入することを定めています。EN16931またはXRECHNUNGに準拠したZUGFeRDバージョン2.0以上は、この義務を満たしています。旧バージョンのZUGFeRD 1.0は準拠していません。
適合レベルはコンプライアンスを管理します:EN16931は安全なデフォルトです
EU全域における一般的なB2B請求書にはEN16931(欧州規格)を、ドイツの公共機関への請求書にはXRECHNUNGを、EN16931の基本範囲を超える業界固有の項目にはEXTENDEDを選択してください。MINIMUMとBASICWLは明細項目を省略するため、完全な請求書には使用できません。社内会計処理のみに使用できます。

パラメータ​

必須 n8n UI: 接続に使用する認証情報、入力データタイプ、ドキュメント名(入力データタイプが「なし」の場合でも常に必須で、ドキュメント名のフォールバックとして使用されます)、出力モード、Zugferdバージョン、PDFへの請求書レンダリング、言語、入力フォーマット、および請求書データ入力タイプ。 適合レベル Zugferd バージョンブランチに基づいて表示され、必須となります。1.0、2.0/2.1/2.2/2.4、カスタムではフィールド名とオプション設定が異なります。一致する請求書データフィールド (請求書 XML/JSON/CSV データ、バイナリプロパティ、 Base64 請求書データ入力タイプに応じて、コンテンツ(またはデータURL)が必要です。実行時検証では、選択されたパスに空でないコンテンツが存在することを強制し、「請求書…データは必須です」または「請求書のbase64コンテンツは必須です」などのエラーが表示されます。

PDF4MEアカウントdevに接続するための認証情報、リソースInvoice、Invoice Operations Create Zugferd Invoice、入力データタイプバイナリデータ、バイナリプロパティdata、ドキュメント名invoice.pdf、出力モードXML With PDF、Zugferdバージョン2.0、適合レベルEN16931、言語ドイツ語、PDFへの請求書レンダリング有効、入力フォーマットJSON、請求書データ入力タイプ直接テキスト、出力ファイル名zugferd_invoice.pdf、出力バイナリフィールド名dataを含む完全なパラメータパネルを表示するZugferd Invoice n8nノードを作成します。

満杯 パラメータ 表示; 下記の表と併用して、ノード内の各フィールドを特定します。

パラメータ必須その機能例
Input Data TypeRequiredHow to provide the input document (optional - only needed if rendering invoice on PDF). Options: Base64 String, Binary Data, None, URL. Default is `None`.None
Base64 ContentConditionalBase64 encoded content of the file to process. Shown when Input Data Type is Base64 String.JVBERi0xLjQK...
Binary PropertyConditionalName of the binary property containing the file to process. Shown when Input Data Type is Binary Data. Default is `data`.data
File URLConditionalURL to the file to process. Shown when Input Data Type is URL.https://example.com/invoice.pdf
Document NameRequiredName of the input document sent to PDF4me. With Binary Data the file name of the binary data is used instead, with URL the last part of the URL. Default is `invoice.pdf`.invoice.pdf
Output ModeRequiredOutput format for the Zugferd invoice. Options: XML Only, XML With PDF. Default is `XML With PDF`.XML With PDF
Zugferd VersionRequiredZugferd version sent as ZugferdVersion in the API payload. Options: 1.0, 2.0, 2.1, 2.2, 2.4, Custom. Default is `2.0`.2.0
Conformance LevelConditionalFor ZUGFeRD 1.0 only (sent as ConformanceLevel). Shown when Zugferd Version is 1.0. Options: BASIC, COMFORT, EXTENDED. Default is `BASIC`.BASIC
Conformance LevelConditionalFor ZUGFeRD 2.0 and later: 2.0, 2.1, 2.2, 2.4 (sent as ConformanceLevel). MINIMUM: minimal machine-readable core. BASICWL: basic without line items. BASIC: line items, broader CII subset. EN16931: EU e-invoice baseline. EXTENDED: EN 16931 plus extensions. XRECHNUNG: German CIUS on EN 16931. Shown when Zugferd Version is 2.0. Options: MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Default is `EN16931`.EN16931
Conformance LevelConditionalFor ZUGFeRD 2.0 and later: 2.0, 2.1, 2.2, 2.4 (sent as ConformanceLevel). MINIMUM: minimal machine-readable core. BASICWL: basic without line items. BASIC: line items, broader CII subset. EN16931: EU e-invoice baseline. EXTENDED: EN 16931 plus extensions. XRECHNUNG: German CIUS on EN 16931. Shown when Zugferd Version is 2.1. Options: MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Default is `EN16931`.EN16931
Conformance LevelConditionalFor ZUGFeRD 2.0 and later: 2.0, 2.1, 2.2, 2.4 (sent as ConformanceLevel). MINIMUM: minimal machine-readable core. BASICWL: basic without line items. BASIC: line items, broader CII subset. EN16931: EU e-invoice baseline. EXTENDED: EN 16931 plus extensions. XRECHNUNG: German CIUS on EN 16931. Shown when Zugferd Version is 2.2. Options: MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Default is `EN16931`.EN16931
Conformance LevelConditionalFor ZUGFeRD 2.0 and later: 2.0, 2.1, 2.2, 2.4 (sent as ConformanceLevel). MINIMUM: minimal machine-readable core. BASICWL: basic without line items. BASIC: line items, broader CII subset. EN16931: EU e-invoice baseline. EXTENDED: EN 16931 plus extensions. XRECHNUNG: German CIUS on EN 16931. Shown when Zugferd Version is 2.4. Options: MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Default is `EN16931`.EN16931
Zugferd Version (Custom)ConditionalCustom version string for ZugferdVersion when Zugferd Version is Custom. Shown when Zugferd Version is Custom.2.3.1
Conformance (Custom Version)ConditionalWhich conformance levels apply to the custom version: the ZUGFeRD 1.0 levels (BASIC, COMFORT, EXTENDED) or the 2.0 and later levels (MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG). Shown when Zugferd Version is Custom. Options: ZUGFeRD 1.0 only (BASIC, COMFORT, EXTENDED), ZUGFeRD 2.0 and Newer (MINIMUM, BASICWL, EN16931, …). Default is `ZUGFeRD 2.0 and Newer (MINIMUM, BASICWL, EN16931, …)`.ZUGFeRD 2.0 and Newer (MINIMUM, BASICWL, EN16931, …)
Conformance LevelConditionalFor custom ZUGFeRD 1.0-style version only (sent as ConformanceLevel). Shown when Conformance (Custom Version) is ZUGFeRD 1.0 only (BASIC, COMFORT, EXTENDED). Options: BASIC, COMFORT, EXTENDED. Default is `BASIC`.BASIC
Conformance LevelConditionalFor custom ZUGFeRD 2.0+ version (sent as ConformanceLevel). MINIMUM: minimal machine-readable core. BASICWL: basic without line items. BASIC: line items, broader CII subset. EN16931: EU e-invoice baseline. EXTENDED: EN 16931 plus extensions. XRECHNUNG: German CIUS on EN 16931. Shown when Conformance (Custom Version) is ZUGFeRD 2.0 and Newer (MINIMUM, BASICWL, EN16931, …). Options: MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Default is `EN16931`.EN16931
LanguageRequiredLanguage for the Zugferd invoice. Options: Czech, Dutch, English, French, German, Italian, Polish, Portuguese, Spanish. Default is `German`.German
Render Invoice On PDFRequiredWhether to render the invoice visually on the PDF. Default is `Yes`.Yes
Input FormatRequiredFormat of the invoice data input. Options: CSV, JSON, XML. Default is `XML`.XML
Invoice Data Input TypeRequiredHow to provide the invoice data (XML/JSON/CSV). Options: Base64 String, Binary Data, Direct Text, URL. Default is `Direct Text`.Direct Text
Invoice Base64 ContentConditionalBase64 encoded invoice data content. Shown when Invoice Data Input Type is Base64 String.PGludm9pY2U+...
Invoice Binary PropertyConditionalName of the binary property containing the invoice data file. Shown when Invoice Data Input Type is Binary Data. Default is `data`.data
Invoice XML DataConditionalXML invoice data (paste directly). Shown when Invoice Data Input Type is Direct Text.__INVOICE_PAYLOAD_SAMPLES__
Invoice JSON DataConditionalJSON invoice data (paste directly). Shown when Invoice Data Input Type is Direct Text.__INVOICE_PAYLOAD_SAMPLES__
Invoice CSV DataConditionalCSV invoice data (paste directly). Shown when Invoice Data Input Type is Direct Text.__INVOICE_PAYLOAD_SAMPLES__
Invoice Data URLConditionalURL to the invoice data file (XML, JSON or CSV, matching Input Format). The node downloads the file and sends its content to PDF4me. Shown when Invoice Data Input Type is URL.https://example.com/invoice.json
Invoice Data URLConditionalURL to the invoice data file (XML, JSON or CSV, matching Input Format). The node downloads the file and sends its content to PDF4me. Shown when Invoice Data Input Type is URL.https://example.com/invoice.json
Invoice Data URLConditionalURL to the invoice data file (XML, JSON or CSV, matching Input Format). The node downloads the file and sends its content to PDF4me. Shown when Invoice Data Input Type is URL.https://example.com/invoice.json
Output File NameOptionalName for the output file. If empty, `zugferd_invoice.pdf` (or `zugferd_invoice.xml`) is used; with Output Mode XML Only the extension is changed to `.xml`. Default is `zugferd_invoice.pdf`.zugferd_invoice.pdf
Output Binary Field NameOptionalName of the binary property to store the output file. Default is `data`.data
Advanced OptionsOptionalOptional settings, collapsed behind Add Option.Add Option
Custom ProfilesOptionalUse "JSON" to adjust custom properties. Review Profiles at https://dev.pdf4me.com/apiv2/documentation/ to set extra options for API calls.

出力​

ノードが返すフィールド。

分野タイプ内容物
fileNameStringOutput file name that was used (see Output File Name).
dataBinaryThe ZUGFeRD invoice: a PDF with the invoice XML embedded (XML With PDF) or the XML file alone (XML Only).

サンプル請求書ファイル​

実際のデータソースを接続する前に、これらのサンプルファイルを使用して、各入力フォーマットでノードをテストしてください。ドイツのB2B生産ワークフローの場合は、まず以下から始めます。 sample-invoice-zugferd-2.0-en16931.json (ZUGFeRD 2.0、 EN16931 適合性)。

手錠 XML サンプル
ZUGFeRD 1.0 BASIC XML. と一緒に使用してください 入力形式: XML貼り付けまたはマップ 請求書 XML データ。
ZUGFeRD-invoice-sample.xml
ZUGFeRD 2.0
ZUGFeRD 2.0 XML サンプル(EN16931)
ZUGFeRD 2.0 EN16931 XML CrossIndustryInvoice形式で、売主/買主、明細項目、VAT、および金額合計を含む請求書を作成します。 入力形式: 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.json
JSON 請求書サンプル(基本)
よりシンプルに JSON 煙テスト用 ZUGFeRD 1.0 そして ベーシック 適合性。
sample-invoice.json
CSV 請求書サンプル
フラット CSV 行 入力形式: CSV貼り付けまたはマップ 請求書 CSV データ。
test-invoice.csv
ZUGFeRD 2.0
CSV 2.0 請求書サンプル
拡張22列 CSV: InvoiceId、IssueDate、seller/buyer address フィールド、SellerVatId、ProductId、Currency、PaymentReference、 IBANBIC。 入力形式: CSV、 ZUGFeRD 2.0。
zugferd-invoice-2.0.csv

詳細オプション​

すべてのフィールド 詳細オプション コレクションはオプションです。 オプションを追加 ノードのUIで。

プロフィール
カスタム PDF4me 処理プロファイル。高度な、または特殊なZUGFeRD請求書生成のために、事前に構成されたオプションセットを適用します(たとえば、カスタム検証ルール、代替スキーママッピング、またはセクター固有の出力調整など)。

入力データタイプのオプション​

制御方法 背景 PDF 書類 (ハイブリッド請求書の視覚レイヤー)がノードに供給されます。

n8n PDF4meの「Create Zugferd Invoice」ノードの入力データタイプのドロップダウンには、4つのオプションが表示されます。「なし」(説明:ドキュメントの入力は不要です(XML/JSON/CSVのみ))、「バイナリデータ」(強調表示、説明:前のノードのファイルを使用します)、「Base64文字列」(説明:ファイルの内容をBase64エンコードされた文字列として指定します)、「URL」(説明:ファイルのURLを指定します)。

入力データタイプのドロップダウン:背景の表示方法を制御します PDF ノードに到達する

なしXML/JSON/CSV形式のみ、背景PDFは不可
書類の入力は不要です。 PDF4me 視覚的にも視覚的にも生成する PDF 層と構造化された XML 請求書データのみから。請求書データのみが存在し、 PDF4me ハイブリッドファイル全体をレンダリングします。
バイナリデータ前のノードからのファイル(最も一般的)
背景情報を読む PDF バイナリを以前の出力から直接取得 n8n ノード: Google Drive ダウンロード、 HTTP バイナリファイルのリクエストまたは読み取り。バイナリプロパティフィールドは、読み取る出力フィールドを指定します(デフォルト)。 データ)
Base64文字列Base64エンコードされたファイルコンテンツ
背景を受け入れる PDF base64エンコードされた文字列として。ファイルが到着したときにこれを使用します。 API レスポンス、Webhookペイロード、またはドキュメントをbase64形式で保存するデータベース列。
URL公開リンクからダウンロード
一般にアクセス可能な URL 背景に PDF。 PDF4me ハイブリッド請求書を生成する前にファイルを直接ダウンロードします。 URL 認証を必要としてはならない。

出力モードオプション​

ノードが純粋な XML ファイルまたは ZUGFeRD ハイブリッド全体 (PDF/A-3 + 埋め込みファイル) XML)

n8n PDF4meの「Create Zugferd Invoice」ノードの出力モードドロップダウンには、2つのオプションが表示されます。「XMLのみ」(説明付き)と「XMLとPDF」(説明付き)の2つのオプションが表示されます。「XMLのみ」(説明付き)は「XMLファイルのみを生成」、そして「PDFに埋め込まれたXMLを生成」です。

出力モードのドロップダウンには、次の 2 つのオプションがあります: pure 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仕様のバージョン。

n8n PDF4meの「Zugferd請求書の作成」ノードにあるZugferdバージョンのドロップダウンリストには、1.0、2.0(ハイライト表示)、2.1、2.2、2.4、およびカスタムのオプションが表示され、ツールチップには「パラメーター: zugferdVersion」と表示されます。

ZUGFeRD バージョン選択ドロップダウンには、旧バージョン 1.0 と最新バージョン 2.4 を含む 6 つのバージョンオプションがあります。

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サポート
最新の仕様がリリースされました。最新のXRECHNUNGプロファイルとスキーマ拡張機能に対応しています。受信側が最新バージョンを必要とする場合に選択してください。
カスタム高度なバージョン管理
特定の受信システムで標準以外のバージョン識別子が必要な場合に、カスタムバージョン処理を有効にします。請求相手から明示的に指示された場合にのみ使用してください。

適合レベルオプション​

適合性プロファイルは、請求書のどの項目が必須で検証されるかを制御するものであり、コンプライアンスにおいて最も重要な選択です。

n8n PDF4meの「Create Zugferd Invoice」ノードにある適合レベルドロップダウンには、MINIMUM、BASICWL、BASIC、EN16931(強調表示)、EXTENDED、XRECHNUNGの6つのオプションが表示されます。

適合レベルのドロップダウンメニューには、MINIMUMからXRECHNUNGまでの6つのプロファイルがあり、現場の要件と適合範囲を制御します。

最小ヘッダーのみで、有効な請求書ではありません。
ヘッダーデータのみ:関係者、合計、文書参照。 明細項目はありません。 法的請求書として使用することはできません。社内会計上の提出書類またはステータス通知のみに使用できます。
ベーシックWL基本料金(ラインなし):消費税のみ
最低価格に加えてVAT/税金の内訳を追加します。 明細項目はありません。 請求書を注文書と照合する予約専用のシナリオで使用され、独立した法的請求書としては使用されません。
ベーシック法定最低請求書金額
BASICWLに明細項目を追加します。EU電子請求書指令の最低限の要件を満たしています。シンプルな請求書には適していますが、B2Bの完全なコンプライアンスを確保するにはEN16931が安全な標準規格です。
EN16931デフォルト: 欧州規格
欧州規格EN 16931の完全なプロファイル。 EU全域におけるB2B請求書発行の推奨デフォルト設定 また、ドイツの2025年指令が参照する適合レベルも示しています。法令遵守に基づくビジネス請求書作成に必要なすべての項目が含まれています。
拡張版業界特有の特典
EN 16931規格を超える業界固有の項目(例えば、物流、貨物輸送、またはセクター固有の参照項目など)を追加します。業界協定や取引先が拡張項目を要求する場合に使用してください。
XRECHARGEドイツの公共部門は義務的
ドイツの XRechnung CIUS プロファイル、 ドイツ連邦政府、州政府、地方自治体への請求書には必須です。 EN16931よりも厳格な検証基準。受信者がドイツの公共機関である場合に使用します。

言語オプション​

レンダリングされた請求書ラベルの表示言語 PDF 層。 XML データ自体は言語に依存しない。

n8n Create Zugferd Invoiceの言語ドロップダウンメニューには、ドイツ語、フランス語、イタリア語、英語、スペイン語、オランダ語、ポーランド語、ポルトガル語が表示されます。

言語: レンダリングされたローカライズされたラベル PDF (ドイツ語は、ドイツのB2BおよびB2Gにおいて典型的な例です。)

ドイツ語デフォルト、ドイツ語 B2B/B2G
英語国際請求書
フランス語Factur-Xのワークフロー
イタリア語イタリアのB2B
スペイン語スペイン語圏のB2B
オランダ語オランダ/ベルギー
研磨ポーランドのB2B
ポルトガル語ポルトガル/ブラジル

入力フォーマットオプション​

ノードに提供する請求書データのフォーマット。

n8n Create Zugferd Invoiceの入力フォーマットドロップダウンにXML、JSON、CSVのオプションが表示され、JSONが選択されている。

入力形式: 選ぶ XML、 JSON、 または CSV 請求書のペイロードに合わせるため。

XML組み立て済み XML 請求書
既にフォーマット済みのZUGFeRD準拠の製品を提供する XML またはUBL XML データ。 ERP すでに標準を生産しています XML ハイブリッド包装が必要な請求書 PDF。
JSONデフォルト: モダン API ソース
請求書データを構造化して供給する JSON オブジェクト。請求書データがウェブフックから届いたときに最も一般的な選択肢です。 REST APIまたは、最新の会計ソフトウェア。 PDF4me 地図 JSON ZUGFeRDへのフィールド XML スキーマを自動的に作成します。
CSV表形式のバッチ請求書データ
請求書データを提供する CSVスプレッドシート、レガシーシステム、または一括請求シナリオからの請求書の一括エクスポートに役立ちます。 PDF4me 地図 CSV ZUGFeRDスキーマへの列の追加。

請求書データ入力タイプのオプション​

請求書データ( XML、 JSON、 または CSV コンテンツ)がノードに到達します。

n8n Create Zugferd Invoiceの請求書データ入力タイプドロップダウンには、直接テキスト、バイナリデータ、Base64文字列、URLのオプションが表示されます。

請求書データ入力タイプ: どのように XML、 JSON、 または CSV ペイロードが提供されます(インライン、前のノードからのバイナリ、base64、または URL)

直接テキストデフォルト: インラインで貼り付けまたはマップ
請求書データを請求書データフィールドに直接貼り付けるかマッピングします。 JSON またはそれより小さい CSV アップストリームノードからのペイロード。 n8n データを動的に構築するための式構文。
バイナリデータ前のノードからのファイル
請求書データファイルを読み込む(XML、 JSON、 または CSV) 以前のバイナリ出力から直接 n8n ノード: Googleドライブのダウンロード、バイナリファイルの読み取り、または HTTP リクエスト。大規模に最適 XML ファイル。
Base64文字列Base64エンコードされたデータ
請求書データをbase64エンコードされた文字列として受け入れます。請求書の内容が API レスポンスまたはデータベースのフィールドで、ファイルをbase64形式で保存します。
URL公開リンクからダウンロード
一般にアクセス可能な URL 請求書データファイルへ。 PDF4me ファイルをダウンロードし、選択された入力フォーマットに従って内容を解析します。

出力フィールド​

分野タイプ内容物
fileNameStringFilename of the generated ZUGFeRD invoice, for example zugferd_invoice.pdf for XML With PDF output or zugferd_invoice.xml for XML Only output.
mimeTypeStringMIME 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.
fileSizeNumberSize of the generated ZUGFeRD file in bytes. Useful for storage planning, bandwidth monitoring, and conditional routing in the workflow.
successBooleanTrue when the ZUGFeRD invoice was generated successfully. False if validation failed or input data was malformed. Use this field to route error handling branches.
messageStringHuman-readable status message confirming success or describing the validation/parsing error encountered. Useful for logging and error notification steps.

クイックセットアップ​

  1. 追加 PDF4me あなたの n8n ワークフローを設定します。 リソース に 請求書 そして 請求書処理 に ツークフェルト請求書を作成する。
  2. で 接続するための認証情報選択してください PDF4me 認証情報またはクリック 新しい認証情報を作成する そしてあなたの API 鍵。
  3. セット 入力データタイプ: 前のノード (バイナリ データ) に接続し、 Base64 文字列または URL 背景 PDFまたは、None を選択してください。 PDF4me レンダリングするべき PDF 請求書データのみから。
  4. 入力 文書名 (例えば invoice.pdf)
  5. セット 出力モード: XMLとPDF 標準ハイブリッドZUGFeRD出力の場合、または XMLのみ 純粋な XML。
  6. 選ぶ ツークフェルト版 (使用 2.0 安全なデフォルト設定として。 2.4 最新のXRECHNUNGプロファイルについてはこちらをご覧ください。
  7. 選ぶ 適合レベル: EN16931 一般的なB2B向け、 XRECHARGE ドイツの公共部門の請求書作成の場合、 拡張版 業界特有の分野向け。
  8. セット 言語 レンダリングされたもの PDF ラベル(デフォルトはドイツ語)。
  9. 有効にする 請求書をPDF形式でレンダリングする あなたが望むなら PDF4me 請求書の内容を視覚的に表示する。あらかじめデザインされた背景を指定する場合は無効にする。 PDF。
  10. 選ぶ 入力形式 (JSON、 XML、 または CSV) そして 請求書データ入力タイプ (テキスト、バイナリデータ、Base64文字列、またはURL)請求書データを「請求書データ」フィールドに貼り付けるか、マッピングしてください。
  11. セット 出力ファイル名 に zugferd_invoice.pdf そして 出力バイナリフィールド名 に data。
  12. 出力先を次のノード(メール送信者、クラウドストレージへのアップロード、政府ポータル)に接続します。 HTTP POST)を実行し、ワークフローを実行します。

ワークフローの例​

ワークフローの例Common n8n workflow patterns using Create Zugferd Invoice.
会計ソフトウェア → ZUGFeRD 2.0 EN16931 請求書 → 顧客へのメール送信
  1. Webhookトリガーは、会計プラットフォーム(DATEV、sevDesk、lexoffice)で請求書が確定されたときに発火します。
  2. ウェブフックのペイロードには、構造化された請求書データが含まれています。 JSON 物体。
  3. PDF4me Create Zugferd Invoice はハイブリッド請求書を生成します。入力データタイプは None (PDF4me レンダリングする PDF から JSON) 出力モードは XML with PDF、Zugferd バージョンは 2.0、適合レベルは EN16931、言語はドイツ語、入力フォーマットは JSON請求書データの入力タイプは、Webhookペイロードからマッピングされた直接テキストです。
  4. GmailノードがZUGFeRDにメールを送信する PDF 顧客の支払先住所宛てに送付し、ドイツのB2B受領委任要件を満たす。
  5. PostgreSQLノードは、監査およびコンプライアンス報告のために、請求書番号、ZUGFeRDバージョン、および適合レベルをログに記録します。
ERP XML 請求書 → ZUGFeRD XRECHNUNG → 公共部門ポータルにアップロード
  1. スケジュールトリガーは、公共部門の請求書を処理するために、平日の毎日16:00に起動します。
  2. SFTPノードは新しく生成された ERP XML エクスポートフォルダから請求書ファイルを取得します。
  3. PDF4me Create Zugferd Invoice は、準拠した XRECHNUNG 請求書を生成します。入力データタイプは None、出力モードは XML With PDF、Zugferd バージョンは 2.4 (最新の XRECHNUNG プロファイル)、適合レベルは XRECHNUNG、言語はドイツ語、入力フォーマットは XML請求書データの入力タイプは、SFTPファイルの内容からマッピングされたバイナリデータです。
  4. 1 HTTP リクエストノードは、XRECHNUNG請求書を連邦政府のZRE(連邦政府中央請求書受領プラットフォーム)または関連する州のポータルにアップロードします。
  5. マイクロソフト Outlook ノードは調達チームに確認を送信し、PostgreSQLノードは提出参照をログに記録します。
月刊 CSV 請求バッチ → ZUGFeRD請求書 → アーカイブ先 SharePoint
  1. スケジュールトリガーは毎月1日に起動し、月次請求処理を実行します。
  2. Google Driveノードが統合されたデータをダウンロードします CSV 請求書のエクスポート、顧客請求書ごとに1行。
  3. Split In Batches ノードは各バッチを反復処理します CSV 行。 PDF4me Create Zugferd Invoice は、顧客ごとに 1 つの ZUGFeRD 請求書を生成します。入力データタイプは None、出力モードは XML with PDF、Zugferd バージョンは 2.0、適合レベルは EN16931、言語は顧客のロケールによって異なります、入力フォーマットは CSV請求書データの入力タイプは、行ごとのCSVコンテンツを含む直接テキストです。
  4. マイクロソフト SharePoint ノードは各ZUGFeRDをアップロードします PDF 顧客の請求書アーカイブフォルダへ。
  5. Gmailノードは各顧客にハイブリッド請求書を送信し、最終的なPostgreSQLのサマリー行には、請求書の件数と合計金額を含むバッチ実行結果が記録されます。

よくある質問​

What is ZUGFeRD and how does it differ from XRechnung and Factur-X?+
ZUGFeRD is the German hybrid e-invoicing standard: a PDF/A-3 archival-grade PDF with structured XML invoice data embedded inside as an attachment. Humans read the visual PDF and machines parse the embedded XML, so a single file serves both audiences. XRechnung is the German public-sector profile, mandatory when invoicing federal, state, or municipal authorities; it can be issued as pure XML or as a ZUGFeRD conformance level. Factur-X is the French sister format that uses the identical hybrid PDF/A-3 + XML structure as ZUGFeRD 2.x and is fully interoperable. Use ZUGFeRD 2.x with EN16931 for general B2B, XRECHNUNG conformance for German public sector, and ZUGFeRD/Factur-X for cross-border French-German invoicing.
Which ZUGFeRD version should I use in 2025 for the German B2B e-invoicing mandate?+
ZUGFeRD 2.0 or higher is required to comply with the German B2B e-invoicing mandate. The mandate, enacted under the Wachstumschancengesetz (Growth Opportunities Act), made e-invoice receipt mandatory from 1 January 2025 and phases in full sending obligations by 2028. Versions 2.0 through 2.4 all comply with EN 16931, the European standard the mandate references. ZUGFeRD 2.2 and 2.4 add support for the newer XRECHNUNG profile updates. Legacy ZUGFeRD 1.0 does not satisfy the mandate. Default to 2.0 for broad compatibility across receiving systems, or 2.4 when the latest XRECHNUNG profile is required.
What is the difference between MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, and XRECHNUNG conformance levels?+
MINIMUM contains only the absolute minimum invoice header data (totals and parties) and cannot serve as a legal invoice; it is for internal accounting drop-offs only. BASICWL (Basic Without Lines) adds VAT and tax breakdowns but still has no line items. BASIC adds line items and meets the absolute minimum of the EU e-invoicing directive. EN16931 is the European Standard EN 16931 profile, recommended as the default for B2B invoicing across the EU and the level the German mandate references. EXTENDED adds industry-specific fields beyond EN 16931. XRECHNUNG is the German public-sector mandatory profile, required when invoicing federal, state, or municipal authorities. Use EN16931 for general B2B, XRECHNUNG for public sector, EXTENDED for industry-specific scenarios.
What is the difference between XML Only and XML With PDF output modes?+
XML Only generates a pure XML file containing the structured invoice data, useful when the receiving system processes only the XML and discards visual content, for XRechnung pure-XML submissions, or for testing the data layer in isolation. XML With PDF generates the full ZUGFeRD hybrid invoice: a PDF/A-3 archival document with the XML embedded as an attachment inside the PDF. The hybrid format is the canonical ZUGFeRD output and is required when both human readability and machine processing must be supported by a single file. Choose XML With PDF for production e-invoicing workflows and XML Only for data-layer integration testing or pure-XML public-sector submissions.
Can I generate ZUGFeRD invoices from CSV data, and what does Invoice Data Input Type control?+
Yes. The Input Format parameter supports XML, JSON, and CSV; pick the format matching your data source. Invoice Data Input Type then controls how the data reaches the node: Direct Text lets you paste or map the data inline (best for JSON or small CSV from upstream nodes), Binary Data reads from a previous file node (best for large XML files), Base64 String accepts encoded content (best for API payloads), and URL downloads the data file from a public link. CSV input is automatically mapped to the ZUGFeRD XML schema by PDF4me before being embedded in the output PDF; no manual XML construction is required.

関連アクション​

他のプラットフォームでの同じタスク​

ヘルプが必要な場合​