コンプライアンス・アーカイブ
ハイブリッド PDF/A-3b 電子請求書向け Factur-X API
公開 E-Invoice Render エンドポイントを使って、EN 16931 CII XML を埋め込んだ Factur-X PDF/A-3b 請求書を生成します。
主 API E-Invoice Render
ENDPOINT
/api/v1/e-invoice/render 対象システム ERP / 請求処理基盤 / コンプライアンスワークフロー / 財務自動化サービス
解決する業務課題
ERP または請求システムが正しい構造化請求書データを生成したあと、レンダリング済みの請求書PDFを EN 16931 CII XML が埋め込まれた Factur-X PDF/A-3b としてパッケージします。
この API が合う場合
- 公開 E-Invoice Render エンドポイントからネイティブの Factur-X 出力が必要な場合。
- 自社システムが請求書向けの有効な EN 16931 CII XML をすでに持っている場合。
- Factur-X メタデータと関連ファイルの接続設定を持つ PDF/A-3b パッケージングが必要な場合。
- 現在公開されている電子請求書の仕様を capabilities エンドポイントで確認したい場合。
置き換えないもの
- gPdf に請求書の業務上の意味づけや税務判断を作らせたい場合。
- OpenAPI に記載されていない XRechnung、FatturaPA、KSeF、Peppol、ZATCA、NF-e、その他標準のネイティブ対応が必要な場合。
- Chorus Pro または別の政府ポータルへの直接送信が必要な場合。
呼び出す endpoint
/api/v1/e-invoice/render
E-Invoice Render がこのワークフローの標準パスです。
/api/v1/e-invoice/capabilities
関連 API パス、テンプレート契約、または機能確認が必要な場合に使います。
最小リクエスト
POST /api/v1/e-invoice/render - 最小の Factur-X パッケージ形状。
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "factur_x",
"profile": "en16931",
"document_type": "invoice",
"xml": {
"format": "cii",
"encoding": "utf8",
"content": "<rsm:CrossIndustryInvoice>...</rsm:CrossIndustryInvoice>"
}
}
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Factur-X invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf が担当すること
- E-Invoice Render による Factur-X パッケージング。
- ハイブリッド請求書 PDF 向けの PDF/A-3b プロファイル処理。
- 標準メタデータ付きの関連ファイルとして CII XML を埋め込む処理。
- ドキュメントに記載されたインライン PDF 配信またはオブジェクト配信ジョブの挙動。
自社システムが担当すること
- 正しい EN 16931 CII XML、請求書番号、税務ロジック、買い手/売り手データ、適用可否。
- 外部検証、受信者ルール、ポータル送信、法的解釈。
- 保存、監査証跡、リトライロジック、顧客またはポータルへの配信。
本番前チェックリスト
- CII XML を gPdf に送る前に検証する。
- settings.profile を pdfa-3b に設定するか、省略して電子請求書のデフォルトを適用する。
- settings.e_invoice.standard = factur_x、settings.e_invoice.profile = en16931 を使う。
- 返ってきた PDF を自社の Factur-X 検証ワークフローに通す。
- 送信と受信者ルーティングは Render API の外側に保つ。
対応範囲の境界
- ネイティブの公開電子請求書出力は、EN 16931 CII XML を含む Factur-X または ZUGFeRD です。
- gPdf は政府ポータルや買い手ポータルへ請求書を送信しません。
- 業務、税務、XML の正しさは自社システム側で管理します。
Factur-X は電子請求書のパッケージングワークフロー
Factur-X は、人が読める PDF と機械可読な EN 16931 CII XML を組み合わせます。公開 gPdf エンドポイントは、その組み合わせを PDF/A-3b 出力としてパッケージします。請求書の意味づけを決めたり、ファイルをポータルへ送信したりはしません。
FAQ
- Factur-X はどのエンドポイントでレンダリングしますか？
- settings.e_invoice.standard を factur_x に設定して POST /api/v1/e-invoice/render を使います。
- gPdf は EN 16931 XML を生成しますか？
- CII XML は自社システムが提供し、その業務上の正しさも自社側で管理します。gPdf はそれをハイブリッド PDF にパッケージします。
- このページで gPdf は XRechnung に対応していますか？
- いいえ。このページは OpenAPI に記載された公開 Factur-X 仕様に限定しています。
- gPdf は Factur-X 請求書をポータルへ送信しますか？
- いいえ。送信と受信者ルーティングは Render API の外側に残ります。