コンプライアンス・アーカイブ
アーカイブ用PDF生成のための PDF/A API
アーカイブ業務向けに JSON Render リクエストから PDF/A 出力を生成し、PDF/A プロファイルと電子請求書パッケージングの境界を明確にします。
主 API JSON Render
ENDPOINT
/api/v1/pdf/render 対象システム コンプライアンス基盤 / アーカイブサービス / ERP エクスポート基盤 / 文書自動化サービス
解決する業務課題
業務ワークフローでアーカイブに適したPDFが必要なとき、構造化された文書リクエストから PDF/A プロファイルの出力を生成します。XML請求書の埋め込みパッケージングが必要な場合に限り、E-Invoice Render を選択します。
この API が合う場合
- ワークフローでレンダリング設定として PDF/A プロファイルを選択する必要がある場合。
- 請求書、明細書、レポート、その他の文書をアーカイブ向けに出力したい場合。
- PDF/A-3b の電子請求書パッケージングに限定されない、より広い PDF/A 用途を扱う場合。
- 生成ファイルを自社のアーカイブ受け入れプロセスで検証できる場合。
置き換えないもの
- EN 16931 CII XML を埋め込んだ Factur-X または ZUGFeRD が必要な場合。E-Invoice Render を使います。
- 検証だけを行うワークフローが必要な場合。検証の前提確認には validator ページを使います。
- 暗号化された出力と PDF/A を同じリクエストで必要とする場合。公開 Render API では、セキュリティ設定と PDF/A プロファイル設定は相互排他として扱われます。
呼び出す endpoint
/api/v1/pdf/render
JSON Render がこのワークフローの標準パスです。
/api/v1/e-invoice/render
関連 API パス、テンプレート契約、または機能確認が必要な場合に使います。
最小リクエスト
POST /api/v1/pdf/render - 通常の PDF/A 出力設定。
{
"settings": {
"profile": "pdfa-2b"
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Archive-ready document",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf が担当すること
- JSON Render リクエストでの PDF/A プロファイル設定。
- テキスト、表、画像、バーコード、メタデータ、プロファイル出力を含む文書レンダリング。
- E-Invoice Render 経路でのみ提供される PDF/A-3b 電子請求書パッケージング。
- 共通エラー挙動を持つバイナリ PDF レスポンス。
自社システムが担当すること
- アーカイブポリシー、プロファイル選択、検証ワークフロー、保持、法的な受け入れ判断。
- 文書上の意味づけ、業務データ、必要な外部証跡。
- 保存、アクセス制御、将来の移行ポリシー。
本番前チェックリスト
- アーカイブまたは顧客が要求する PDF/A プロファイルを選ぶ。
- 出力を検証ツールと保持受け入れワークフローに通す。
- 公開ドキュメントで互換性のある仕様が追加されない限り、PDF/A とセキュリティ設定は別々のレンダリングフローに分ける。
- 埋め込み CII XML が必要な場合は E-Invoice Render を使う。
- 保持ポリシーに従って、ソースデータまたは返ってきた PDF を保存する。
対応範囲の境界
- PDF/A 出力は、法的な電子請求書パッケージングと同じではありません。
- gPdf は自社のアーカイブ受け入れワークフローや検証ワークフローを置き換えません。
- 保持とコンプライアンス解釈は自社システム側で管理します。
PDF/A はプロファイルの選択です
通常のアーカイブ文書では、PDF/A はレンダリング設定で選択します。これにより、ワークフローは JSON Render に近い形のまま保てます。自社システムが文書を記述し、必要なプロファイルを設定します。
電子請求書のパッケージングは別です。文書に埋め込み CII XML 付きの Factur-X または ZUGFeRD が必要な場合は、E-Invoice Render エンドポイントを使います。
FAQ
- 一般的な PDF/A 出力にはどのエンドポイントを使うべきですか？
- 通常の PDF/A 出力には、適切な settings.profile 値を指定して POST /api/v1/pdf/render を使います。
- E-Invoice Render はいつ必要ですか？
- 文書が CII XML を埋め込んだ Factur-X または ZUGFeRD の PDF/A-3b パッケージである必要がある場合は、E-Invoice Render を使います。
- gPdf はアーカイブ受け入れを検証しますか？
- いいえ。gPdf は PDF/A 出力をレンダリングします。出力は自社システム側で、アーカイブまたは顧客の受け入れポリシーに照らして検証してください。
- PDF/A とセキュリティ設定を組み合わせられますか？
- 現在の公開 Render API ではできません。settings.profile と settings.security は相互排他であり、無効な組み合わせは検証で失敗します。