ZUGFeRD請求書を作成する Zapier
このアクションが何をするか
PDF4me ZUGFeRD請求書を作成する 完全に準拠した ZUGFeRDハイブリッド電子請求書、 PDF/構造化されたA-3文書 XML 請求書データは、 Zapier ワークフローを変換します。 XML、 JSON、 または CSV 請求書データを単一のハイブリッドファイルにまとめ、 ドイツにおける企業間取引（B2B）向け電子請求書義務化（2025年以降）EU全域のEN 16931準拠、またはドイツの公共部門プロファイルXRECHNUNGに対応。ZUGFeRDバージョン1.0から2.xまで、BASIC、COMFORT、EXTENDED、EN16931、XRECHNUNGのすべての適合レベルを1つのZapアクションでサポート。Adobe Acrobat、JustOn、またはZUGFeRD Managerの手動ワークフローの代替としてそのまま使用できます。
関連ブログ記事(2)
認証 API リクエスト
アクセスするには PDF4me ウェブ API を通して Zapierすべてのアクションは認証される必要があります。クリック 新しいアカウントを接続する 初めて貼り付けて PDF4me API キーにより、後続のZapは接続を自動的に再利用します。
見逃してはならない重要な事実
2025年のドイツB2B指令にはZUGFeRD 2.0+が必要
成長促進法（Wachstumschancengesetz）により、2025年1月1日から電子請求書の受領が義務付けられ、2028年までに完全な送信義務が課せられました。EN16931またはXRECHNUNGに準拠したZUGFeRD 2.0以上であればこの義務を満たしますが、ZUGFeRD 1.0は準拠していません。一部のシステムではデフォルトで1.0が使用されますが、本番環境では明示的に2.0以上に切り替えてください。
実行ごとに1つのデータフィールドに入力してください。2つ入力しないでください。
地図 のみ 入力フォーマットに一致する請求書データフィールド、請求書XMLデータ XML請求書JSONデータ JSON請求書CSVデータ CSV念のため複数のフィールドに入力すると、検証が失敗し、実行時に Zap ステップが失敗します。
適合レベルEN16931は、2.xの安全なデフォルトです。
選ぶ EN16931 EUの一般的なB2B請求書発行（ZUGFeRD 2.x）の場合、 XRECHARGE ドイツの公共部門の組織にとって、 拡張版 業界固有の分野向け。ZUGFeRD 1.0では、BASICが最低限の法的請求書レベルです。MINIMUMとBASICWLは明細項目を省略しており、それ自体では法的請求書として認められません。
Zapier アクション 設定する タブ、マップ ファイル / ファイル名、 セット 入力形式 そして、一致する請求書データフィールド、 出力モード、 ツークフェルト版、 適合レベル、 PDF形式で請求書を作成する、 そして 言語。
パラメータ
必須 Zapier UI （アスタリスク付き）： 入力フォーマット、出力モード、Zugferdバージョン、および適合レベル。 条件付き: 入力フォーマットに基づいて、一致する請求書データフィールド（請求書XMLデータ、請求書JSONデータ、または請求書CSVデータ）を選択します。 XmlWithPdfの出力の場合： ファイルとファイル名（テンプレートPDF）は、すべてのレイアウトでアスタリスクが付いているわけではありませんが、通常はコネクタで必須となります。 オプション： PDF形式で請求書を作成する（言語）。
| パラメータ | 必須 | その機能 | 例 |
|---|---|---|---|
| File | Optional | Template/layout PDF that will hold the embedded XML in XmlWithPdf output. Map from a previous step (Dropbox, Google Drive, HTTP). Not required when Output Mode is XmlOnly. | 3. File: (Exists but not shown) |
| File Name | Optional | Filename of the template PDF (filename + extension). Required alongside File for XmlWithPdf output. Map both `File Name` and `File Ext` from the prior step. | 3. File Name: 10 page + 3. File Ext: .pdf |
| Input Format | Required | Format of the invoice payload: XML, JSON, or CSV. Determines which invoice data field below must be filled. Asterisked in the Zapier UI. Defaults to XML. | XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 sample |
| Invoice Xml Data | Conditional | XML invoice payload. Required when Input Format is XML. Map from a previous file step that produced XML content. Leave empty for JSON/CSV inputs. | XML sampleXML 2.0 sample4. File: (Exists but not shown) |
| Invoice Json Data | Conditional | JSON invoice payload. Required when Input Format is JSON. Best for webhook-driven or API-driven invoice data. | JSON 2.0 EN16931 sampleJSON (basic)4. Body |
| Invoice Csv Data | Conditional | CSV invoice payload. Required when Input Format is CSV. Best for batch invoice exports from spreadsheets or legacy ERP exports. | CSV sampleCSV 2.0 sample4. File |
| Output Mode | Required | XmlWithPdf produces the hybrid PDF/A-3 + embedded XML (canonical ZUGFeRD). XmlOnly produces pure XML with no PDF wrapper. Asterisked. Defaults to XmlWithPdf. | XmlOnly |
| Zugferd Version | Required | ZUGFeRD specification version. 1.0 is legacy. 2.0+ aligns with EN 16931 and satisfies the German B2B mandate. Asterisked. Defaults to 1.0. | 1.0 |
| Conformance Level | Required | Profile controlling required invoice fields. For 1.0: BASIC, COMFORT, EXTENDED. For 2.x: MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Asterisked. Defaults to BASIC. | BASIC |
| Render Invoice On Pdf | Optional | Toggle (True / False). When True, PDF4me visually renders invoice content on the PDF. When False, only the XML is embedded: useful when the template PDF already shows the invoice layout. Defaults to Yes. | True |
| Language | Optional | Two-letter locale code for printed invoice labels: de (German, default), en (English), fr (French), it (Italian), es (Spanish), nl (Dutch), pl (Polish), pt (Portuguese). The XML data itself remains language-neutral. | de |
入力フォーマットオプション
請求書ペイロードで使用するデータ形式と、以下の請求書データフィールドに入力する必要がある項目を制御します。
XML組み立て済み XML 請求書最高の時は ERP 既にZUGFeRD準拠の製品を生産しています XML またはUBL XML ハイブリッドで包むだけでいい PDFファイルをマッピングして 請求書のXMLデータ。
JSONモダンな API-ソースデータウェブフック駆動のワークフローに最適または SaaS 請求システムが発信する JSON。 PDF4me 地図 JSON ZUGFeRDへのフィールド XML スキーマを自動的にマッピングします。 請求書のJSONデータ。
CSVスプレッドシートまたはバッチエクスポートGoogleスプレッドシート、Excel、レガシーシステムからの請求書の一括エクスポート、または行ごとの請求シナリオに最適です。 PDF4me 地図 CSV スキーマに列をマッピングします。 請求書CSVデータ。
出力モードオプション
標準的なZUGFeRDハイブリッドファイルを生成するか、純粋なXMLを生成するかを制御します。
XmlWithPdfデフォルト、完全なZUGFeRDハイブリッドファイル標準的なZUGFeRDハイブリッドを生成します。 PDF/A-3 アーカイブ PDF 構造化された XML 請求書は添付ファイルとして埋め込まれています。人間は PDF機械は解析します XMLB2B電子請求書の標準出力。ファイルとファイル名のマッピングが必要です。
XMLのみ純粋な XML、 いいえ PDF ラッパー構造化されたものだけを生成する XML 請求書。XRechnung pure- に使用XML 公共部門の提出物、EDIパイプライン、データレイヤーのテスト、またはデータのみを取り込むシステム XML 視覚的な表現なしに。
Zugferd バージョンオプション
生成された請求書に埋め込まれるZUGFeRD仕様のバージョン。ドロップダウンリストに表示される適合レベルオプションを決定します。
1.0レガシー、EN 16931以前2014年版オリジナル仕様。適合オプション： ベーシック、コンフォート、エクステンデッド2025年以降のドイツのB2B電子請求書発行義務化要件を満たしていません。バージョン1.0を明示的に要求する既存の受信側でのみ使用してください。
2.0+推奨、EN 16931準拠欧州規格EN 16931に準拠し、ドイツのB2B義務を満たしています。適合オプションには以下が含まれます。 最小、基本、基本、EN16931、拡張、XRECHNUNG2025年以降の生産請求とFactur-Xとの相互運用性にとって最適な選択肢です。
適合レベルオプション
適合性プロファイルは、請求書のどの項目が必須であり、検証されるかを制御します。 利用可能なオプションは、選択したツークフェルトのバージョンによって異なります。
最小2.xのみ、ヘッダーのみヘッダーデータのみで、明細項目はありません。有効な法的請求書ではありません。社内経理部門への提出専用です。
ベーシックWL2.xのみ、VATのみVATの内訳は追加されますが、明細項目は追加されません。注文と照合された予約のみのシナリオ向けです。
ベーシックどちらのバージョンも、最低限の法的請求書明細項目を追加します。EU電子請求書指令の最低限の要件を満たしています。バージョン1.0と2.xの両方で利用可能です。
快適1.0のみ、拡張参照BASICに加えて、参照データと追加フィールドを追加します。ZUGFeRD 1.0のみに対応し、最新の2.xではEN16931に相当します。
EN169312.x、推奨B2Bデフォルト欧州規格EN 16931のフルプロファイル。EUにおけるB2B請求書発行の推奨デフォルト設定であり、ドイツの指令で参照されているレベルです。ZUGFeRD 2.xのみ対応。
拡張版両バージョンとも、業界関係者向けの特典付き基本機能に加え、業界固有のフィールド（物流、貨物輸送、セクター固有の参照項目など）を追加します。バージョン1.0と2.xの両方で利用可能です。
XRECHARGE2.x、ドイツの公共部門で義務化ドイツのXRechnung CIUSプロファイルは、連邦政府、州政府、地方自治体への請求書に必須です。EN16931よりも厳格な検証基準が適用されます。ZUGFeRD 2.xのみ対応。
出力フィールド
| 分野 | タイプ | 内容物 |
|---|---|---|
documentId | Text | ID PDF4me gives the resulting document. |
Error Message | Text | Error message when PDF4me could not process the file; empty otherwise. |
fileAlternateUrl | Text | Alternative download link of the resulting file, with the file name at the end of the URL. |
fileExtension | Text | Extension of the resulting file, for example `.pdf`. |
fileName | Text | Name of the resulting file, without extension. |
fileUrl | Text | Download link of the result: the PDF with the embedded ZUGFeRD XML (XmlWithPdf) or the XML invoice file (XmlOnly). Map it into any later step that needs the file. |
fullFileName | Text | Name of the resulting file, with extension. |
jobId | Text | ID of the PDF4me job that processed the request. |
TraceId | Text | Trace ID of the request, when PDF4me returns one. Give it to PDF4me support when reporting a problem. |
サンプル請求書ファイル
ライブデータソースを接続する前に、これらのサンプルファイルを使用して各入力フォーマットでアクションをテストしてください。ドイツのB2B生産ワークフローの場合は、まず sample-invoice-zugferd-2.0-en16931.json （ZUGFeRD 2.0、 EN16931 適合性）。
ZUGFeRD XMLサンプル
ZUGFeRD 1.0 BASIC XML. と一緒に使用してください 入力形式: XML. マップ 請求書のXMLデータ。
ZUGFeRD-invoice-sample.xmlZUGFeRD 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.jsonJSON形式の請求書サンプル（基本版）
よりシンプルに JSON 煙テスト用 ZUGFeRD 1.0 そして ベーシック 適合性。
sample-invoice.jsonCSV請求書サンプル
フラット CSV 行 入力形式: CSV. マップ 請求書CSVデータ。
test-invoice.csvZUGFeRD 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クイックセットアップ
- で Zapier、 クリック + 新しいアクションを追加して選択する PDF4me。
- 選ぶ ZUGFeRD請求書を作成する アクションイベントとして。
- 接続 PDF4me アカウントまたは貼り付け API 指示されたらキーを押します。
- のために XmlWithPdf 出力、マップ ファイル そして ファイル名 レイアウトに合わせて PDF （多くの場合、DropboxまたはGoogle Driveからのダウンロード手順が先行しています）。 XMLのみこれらは空欄のままで構いません。
- セット 入力形式 に XML、 JSON、 または CSV データソースによって異なります。
- 埋める のみ 該当する請求書データフィールド（請求書XMLデータ、請求書JSONデータ、または請求書CSVデータ）を指定してください。他の2つのフィールドは空欄のままにしてください。
- セット 出力モード に XmlWithPdf （ハイブリッドファイル、正規のZUGFeRD）または XMLのみ （純粋な XML)
- 選ぶ ツークフェルト版: 2.0+ 2025年以降のドイツのB2B義務化への準拠のために、 1.0 旧型受信機のみ対応。
- 選ぶ 適合レベル: EN16931 一般的なB2B（2.x）の場合、 XRECHARGE ドイツの公共部門向け ベーシック ZUGFeRD 1.0 のレガシー版向け。
- 切り替え PDF形式で請求書を作成する に 真実 あなたが望むなら PDF4me 請求書の内容を視覚的にレンダリングするために PDF; 間違い テンプレート PDF 既にレイアウトが表示されています。
- セット 言語 購入者の地域に一致するロケールコードへ（
de、en、fr、it、es、nl、pl、pt) - クリック テストアクション出力を確認し、Zapをオンにします。
ワークフローの例
ワークフローの例Common Zapier workflow patterns using Create ZUGFeRD Invoice.
SaaSウェブフックJSON → ZUGFeRD 2.x EN16931 → 顧客へのメール
- あなたの SaaS 課金システムがウェブフックを発火し、 Zapier ドイツのB2B顧客に請求書を発行する際。
- PDF4me ZUGFeRD請求書の作成実行: 入力フォーマット = JSON、Webhook ペイロードからマッピングされた請求書 Json データ、出力モード = XmlWithPdf、Zugferd バージョン = 2.0、適合性 = EN16931、言語 = de。
- ハイブリッド PDF （人間が読める形式と機械が解析できる形式の両方）がGmailのステップに添付され、顧客の支払先アドレスに送信されるため、2025年以降のB2B電子請求書発行義務化に対応できます。
- Googleスプレッドシートの各行には、監査報告のために請求書ID、顧客名、金額、タイムスタンプが記録されます。
- A SharePoint ZUGFeRDのコピーをアーカイブとしてアップロードします PDF コンプライアンス維持のため。
ERP CSVエクスポート → XRECHNUNG → ドイツ公共部門ポータル
- 公共部門の未払い請求書を処理するため、スケジュールされたZapが平日の毎日16:00に実行されます。
- Dropboxのトリガーが最新の ERP CSV エクスポートとレイアウト PDF。
- PDF4me ZUGFeRD請求書の作成実行: 入力フォーマット = CSV請求書CSVデータ = CSV ファイル、出力モード = XmlWithPdf、Zugferd バージョン = 2.0、適合性 = XRECHNUNG、言語 = de。
- 準拠したXRECHNUNGハイブリッド PDF Webhookステップを介して、連邦政府のZREポータルまたは関連する州の電子請求書エンドポイントにPOSTされます。
- 提出参照番号が記載された確認メールがARチームに送信され、PostgreSQLログに監査証跡が記録されます。
事前構築済み XML → XmlOnly → EDI パートナー統合
- あなたの ERP 既にZUGFeRD準拠のものを生成しています XML エクスポートモジュールを介して請求書を抽出し、Googleドライブのフォルダに保存します。
- Zapier 新しいトリガーが毎回起動します XML ファイル。 PDF4me ZUGFeRD請求書の作成実行: 入力フォーマット = XML、請求書XMLデータ = XML ファイル、出力モード = XmlOnly、Zugferd バージョン = 2.0、適合規格 = EN16931。
- 検証済みの純粋なXML 請求書はSFTP経由で取引相手のEDIエンドポイントに送信されます。 PDF システム間ハンドオフにはラッパーが必要です。
- Slackの通知でEDI配信が確認され、Airtableのレコードにはパートナー情報と送信タイムスタンプが更新されます。
よくある質問
関連アクション
スイスQR紙幣を作成する
スイスを生成する QR 請求書に埋め込まれた支払伝票 PDFsドイツ、オーストリア、スイスを対象としたDACH地域における国境を越えた請求書発行には、ZUGFeRDと組み合わせる。
作成する PDF/A
変換する PDFs に PDFレイアウト作成時に便利なアーカイブ形式 PDFs ZUGFeRDのハイブリッド請求書は、以下の条件を満たす必要があります。 PDF/A-3準拠。
文書を分類する
受信メールを自動分類する PDFs 請求書作成前または作成後に、請求書、契約書、領収書を適切な下流のZapブランチにルーティングします。
他のプラットフォームでの同じタスク
ZUGFeRD請求書の作成（作成）
同じ電子請求書発行業務 Make シナリオ、パラメータモデル、適合レベルはすべて同じです。
ZUGFeRD請求書の作成（Power Automate）
Power Automate / Microsoft 365 流れに最適 SharePoint そして Outlook-駆動型請求。
ZUGFeRD請求書の作成（n8n）
セルフホスティング n8n ワークフロー、開発者に優しい電子請求書自動化 JSON 表現のサポート。