Enterprise エディション

請求書

概要

NextPDF Enterprise は、ZUGFeRD / Factur-X / Peppol-UBL の構造化ハイブリッドインボイスを生成し、インボイス XML を EN 16931 データモデルおよび Schematron ルールセットに照らして検証します。EN 16931 で定義されたデータモデルに準拠した構造化インボイスを生成しますが、税務当局のバリデーターではなく、いかなるドキュメントも認証しません。

提供状況とライセンス

この機能は NextPDF Enterprise（nextpdf/enterprise）で提供され、Enterprise ティアのライセンスエンベロープで有効化されます。その権限を持たないデプロイメントでは、この機能のクラスは読み込まれません。エディションを比較してライセンスを取得する。

インストール

composer require nextpdf/enterprise:^3

Schematron エンジンは PHP の ext-xsl 拡張モジュールを使用します。Schematron 検証を実行する前に、これをインストールして有効化してください。

概念の概要

Invoice モジュールには、3 つの独立したサーフェスがあります。構造化インボイスの埋め込み、EN 16931 の XML 検証、そして Schematron ルールの実行です。

埋め込み。 ZugferdEmbedder は、呼び出し元が提供する ZUGFeRD 2.4 / Factur-X 1.08 の UN/CEFACT CII XML ペイロードを PDF/A キャリアに添付し、ハイブリッドインボイスを生成します。2 つのキャリア形式がサポートされています。推奨されるモダンなキャリアである PDF/A-4f（ISO 19005-4:2020）と、後方互換性のための PDF/A-3b（ISO 19005-3:2012）です。ZugferdXmpSchema は、キャリアが必要とする Factur-X XMP 拡張スキーマ宣言を注入します。PeppolEmbedder は、呼び出し元が提供する Peppol BIS Billing 3.0 UBL 2.1 のインボイスまたはクレジットノート XML に対して同じ役割を果たし、正しい関連ファイル関係と MIME タイプで添付します。NextPDF はインボイス XML を合成しません。呼び出し元が有効な XML を提供し、インボイス発行者であり続けます。

検証。 InvoiceXmlValidator は、インボイス XML を EN 16931 セマンティックデータモデルおよび ZUGFeRD / Factur-X コンテナの想定に照らして検査します。これには、EN 16931 ビジネスルール BR-1 が義務付ける BT-24 仕様識別子も含まれます。2 つのモードのいずれかで動作します。COMPAT（デフォルト。境界的な EN 16931 のカーディナリティに関する所見は、既存のフィクスチャの後方互換性を維持するため、警告として報告されます）と STRICT（BT-24 のカーディナリティはハードエラーとなり、外部バリデーターのセマンティクスに準じます）です。モードは、呼び出しごと、環境によるオーバーライド、または適合性ポリシーによって選択できます。

Schematron。 SchematronValidator は、事前コンパイル済みの Schematron ルールセット（ビルド時に XSLT へコンパイルされた CEN EN 16931 の .sch ルール）を、インプロセスの PHP XSLT プロセッサを使ってインボイス XML に対して実行し、SVRL レポートを構造化された所見へと解析します。ZugferdProfile 列挙型は、適合性プロファイル — MINIMUM、BASIC WL、BASIC、EN 16931、EXTENDED、そして EN 16931 を基にしたドイツの XRechnung B2G CIUS — をモデル化します。

このモジュールが主張すること、しないこと

このモジュールは、構造化されたインボイスデータを生成し、検査します。いかなるドキュメントについても、法的に準拠したインボイスであること、税務当局の承認を受けていること、いかなる当局によっても受理されることが保証されていることを、主張しません。

バリデーターは、EN 16931 セマンティックモデルと ZUGFeRD / Factur-X / UBL コンテナのみを検査します。税務当局のバリデーターではありません。各国の拡張機能やクリアランスプラットフォーム — たとえばイタリアの SDI、フランスの Chorus Pro、ドイツの XRechnung トランスポート — は、トランスポートレベルでは対象外です。
EN 16931-1 自体が述べているように、コアセマンティックモデルは、電子インボイスが法的・財政的コンプライアンスをサポートするために必要とする本質的な情報を運びます。関連する法令の規則を満たす責任はインボイス発行者にあります。これは税務当局のバリデーターではありません。
ある標準をサポートすることは、その標準への適合性と同じではありません。お住まいの法域での規制上の十分性を判断するには、ご自身の税務およびコンプライアンスの助言者にご相談ください。

なぜこの仕組みなのか

このモジュールは、意図的にインボイス XML を一切合成しません。埋め込み、EN 16931 検証、Schematron 実行は、呼び出し元が提供し所有する XML に対する 3 つの独立したサーフェスです。これにより、NextPDF はプロデューサーおよびチェッカーであり続け、決して発行者にはなりません。法的責任はライブラリに委譲できないからです。検証はデフォルトで COMPAT となるため、境界的なカーディナリティの所見はリグレッションではなく警告になります。STRICT は、外部バリデーターのセマンティクスが必要なときにオプトインで使用します。その結果、きれいな分離が実現します。NextPDF は観測した内容を報告し、そのドキュメントが法を満たすかどうかは発行者が判断します。設計背景: インボイスと電子インボイス。

API サーフェス

クラス	責務
`ZugferdEmbedder`	ZUGFeRD / Factur-X CII XML を PDF/A-4f または PDF/A-3b キャリアに添付。
`ZugferdXmpSchema`	Factur-X XMP 拡張スキーマ宣言を注入。
`ZugferdProfile`	適合性プロファイル列挙型（MINIMUM … EXTENDED、XRECHNUNG）。
`PeppolEmbedder`	Peppol BIS 3.0 UBL のインボイス/クレジットノート XML を PDF/A キャリアに添付。
`InvoiceXmlValidator`	XML を EN 16931 データモデルに照らして検査。COMPAT または STRICT モード。
`InvoiceValidatorMode`	検証モード列挙型: `COMPAT`（デフォルト）または `STRICT`。
`SchematronValidator`	事前コンパイル済みの Schematron ルールセットを実行。SVRL 所見を解析。
`InvoiceValidationResult` / `SchematronResult`	構造化された結果: プロファイル、所見、重大度。

コードサンプル — クイックスタート

use NextPDF\Enterprise\Invoice\ZugferdEmbedder;
use NextPDF\Enterprise\Invoice\ZugferdProfile;

$pdf = ZugferdEmbedder::basic($pdfAManager, $fileAttachment, $ciiXml)
    ->embed(ZugferdProfile::EN16931);

コードサンプル — 本番

use NextPDF\Enterprise\Invoice\InvoiceXmlValidator;
use NextPDF\Enterprise\Invoice\InvoiceValidatorMode;

$result = $validator->validate($ciiXml, InvoiceValidatorMode::STRICT);

foreach ($result->findings as $finding) {
    $logger->warning('invoice.finding', [
        'rule'     => $finding->ruleId,
        'severity' => $finding->severity->value,
    ]);
}
// A clean result is one input to your decision, not a compliance verdict.
// The invoice issuer remains responsible for relevant legislation.

エッジケースと注意点

認識可能なインボイスペイロードを運ばない整形式の PDF は、例外をスローするのではなく「インボイスではない」という結果を返します。
COMPAT がデフォルトの検証モードです。BT-24 仕様識別子が欠落している場合は警告として報告されるため、ブール値の有効性フラグでゲートする呼び出し箇所がリグレッションすることはありません。BT-24 を、外部の KoSIT / Mustang のセマンティクスに一致するハードエラーにするには、STRICT を使用してください。
インボイス XML は呼び出し元が提供します。NextPDF はそれを生成も修正もしません。所見リストが空であっても、非準拠のペイロードが準拠したものになるわけではありません。
Schematron エンジンには ext-xsl が必要です。ルールセットはビルド時にコンパイルされ、実行時には事前コンパイル済みの XSLT のみが実行されます。

パフォーマンス

検証コストは、埋め込まれた XML のサイズと Schematron ルールの数に応じて増減します。埋め込みコストはキャリアのサイズに応じて増減し、PDF/A シリアライゼーションによって支配されます。ページのパフォーマンス予算は、インボイスのスループットではなく、ドキュメントのレンダリングを反映したものです。

セキュリティに関する注意

すべての XML 解析は、堅牢化された XML ガードを経由します。外部エンティティの解決は無効化され（XXE 安全）、DOCTYPE は拒否され、伸長は範囲が制限されます。XSLT プロセッサは、ネットワークおよびファイルシステムのリソース読み込みを無効化した状態で実行され、PHP 関数を一切登録しません。そのため、document()、xsl:include、xsl:import、result-document がネットワークやディスクに到達することはできません。信頼できないソースからのインボイス XML は、敵対的なものとして扱ってください。

データレジデンシーと PII の緩和策

インボイス XML には、個人情報、商取引情報、財務情報が含まれる場合があります。処理はインプロセスかつローカルで行われ、モジュールは埋め込みや検証の間にアウトバウンドのネットワーク呼び出しを行いません。抽出された XML と所見には、ご自身の保持および最小化の管理策を適用してください。

安全なテレメトリとログのスクラブ

所見と検証ログには、ルール識別子とタグの値が含まれる場合があります。インボイスのペイロード全体は含まれません。それらの値が機微である場合は、ログを共有シンクへ転送する前にフィールド値をスクラブまたは編集してください。

適合性

挙動	参照	ステータス
コアインボイスセマンティックモデル	EN 16931-1:2026 §4	準拠して構築。発行者が関連法令に対する責任を負う
仕様識別子（BT-24）	EN 16931-1:2026 BR-1	検査済み（COMPAT では警告、STRICT ではエラー）
UN/CEFACT CII 構文バインディング	CEN/TS 16931-3-3:2020	埋め込みサポート
UBL 2.1 構文バインディング	CEN/TS 16931-3-2:2020	埋め込みサポート
PDF/A-3 関連ファイル	ISO 19005-3:2012 §6.7.8	キャリアサポート
PDF/A-4f 埋め込みファイル	ISO 19005-4:2020 Annex A	キャリアサポート

この表は、NextPDF Enterprise が準拠して構築されている仕様と、検査する内容を記録したものです。認証、税務当局の承認、規制上の十分性についての言明ではありません。関連する法令の規則を満たす責任はインボイス発行者にあります。これは税務当局のバリデーターではありません。

FIPS モードの挙動

このモジュールは暗号署名を実行しません。ハイブリッドインボイスへの署名と FIPS モードでの鍵の保管は、ここでは対象外です。Signature モジュールを参照してください。

脅威モデル

信頼できないインボイス XML が主要な入力です。緩和策: XXE 安全な解析、DOCTYPE の拒否、範囲が制限された伸長、ネットワークおよびファイルのリソース読み込みを無効化した XSLT プロセッサ、そして主張の合成を行わないこと — インボイスの内容は呼び出し元が提供し、所有します。

挙動コントラクト

ZugferdEmbedder / PeppolEmbedder は、呼び出し元が提供するインボイス XML を PDF/A-4f または PDF/A-3b キャリアに添付します。NextPDF はインボイス XML を一切合成しません。
InvoiceXmlValidator は COMPAT（デフォルト。境界的な EN 16931 のカーディナリティは警告）または STRICT（BT-24 のカーディナリティはハードエラー）で動作します。
SchematronValidator は、インプロセスの XSLT プロセッサを通じて事前コンパイル済みのルールセットを実行し、SVRL 所見を解析します。所見リストが空であっても、非準拠のペイロードが準拠したものになるわけではありません。
すべての XML 解析は XXE 安全です。外部エンティティの解決は無効化され、DOCTYPE は拒否され、伸長は範囲が制限されます。

公開範囲

このページは、外部から観測可能な挙動とサポートされるパブリック API サーフェスのみを説明します。内部の名前空間パス、ヘルパークラス、メカニズムの表、ランブックのファイル名、チケットプレフィックスは対象外です。

Core フォールバック

NextPDF Core は、構造化インボイスの生成も検証も行いません。Core のみのデプロイメントは PDF を生成できますが、ZUGFeRD / Factur-X / Peppol の埋め込み、EN 16931 バリデーター、Schematron エンジンはありません。

Pro フォールバック

Pro のみのデプロイメントでは、サポートされるサーフェスは、Factur-X / ZUGFeRD ペイロードの Pro ティアの電子インボイス検出と検証です。Pro は、ZUGFeRD / Factur-X または Peppol-UBL ハイブリッドキャリアを生成せず、XRechnung CIUS プロファイルを追加せず、インプロセスの Schematron エンジンを実行しません。Pro のみのデプロイメントで生成、XRechnung CIUS プロファイル、または Schematron を要求する構成には、それを満たす Enterprise コンポーネントがありません。Pro の検出・検証サーフェスについては Pro Compliance を参照してください。

Enterprise の境界に関する注記

内部メカニズムの詳細は、ソースリポジトリの内部ドキュメントに留まり、本マニュアルの対象外です。

デプロイの境界

Schematron エンジンには ext-xsl PHP 拡張モジュールが必要です。そのプロビジョニングと有効化はオペレーターの責任です。処理はインプロセスかつローカルで行われ、モジュールは埋め込みや検証の間にアウトバウンドのネットワーク呼び出しを行いません。各国の電子インボイストランスポート、クリアランスプラットフォーム、アーカイブシステムは、このモジュールの外部にあり、オペレーターの責任です。

法令遵守の境界

NextPDF は、EN 16931 で定義されたデータモデルに準拠した構造化インボイスを生成し、ルール所見を報告します。「法的に準拠したインボイス」を生成せず、「税務当局の承認を受けた」出力を提供せず、いかなるインボイスも税務当局、裁判所、登記機関によって受理されることを保証しません。関連する法令の規則を満たす責任はインボイス発行者にあります。これは税務当局のバリデーターではありません。各国の電子インボイスプラットフォーム、クリアランスモデル、アーカイブの義務、デジタル署名の要件は法域によって異なり、発行者の責任です。ご自身の税務および法務の助言者にご相談ください。