物流・ラベル
ラベル、納品書、倉庫書類のための物流 PDF API
WMS、OMS、3PL データから、配送ラベル、納品書、運送状、マニフェスト、倉庫書類などの構造化された物流 PDF を生成します。
主 API JSON Render
ENDPOINT
/api/v1/pdf/render 対象システム WMS / OMS / 3PL バックエンド / 配送会社オペレーション
解決する業務課題
構造化された WMS、OMS、3PL、フルフィルメントデータから現場運用向けの物流書類をレンダリングし、配送会社とのトランザクション、出荷ルーティング、倉庫ステータス、業務ルールは呼び出し側システムに保持します。
この API が合う場合
- 配送ラベル、納品書、マニフェスト、運送状、倉庫帳票向けの PDF が必要な場合。
- 物流システム側に出荷、注文、在庫、経路、配送会社データがすでにある場合。
- 再現性のある再印刷と大量 API レンダリングが必要な場合。
- ラベルや倉庫業務のより具体的なワークフローへユーザーを案内する広いハブページが必要な場合。
置き換えないもの
- gPdf に出荷運賃を計算させる、送料を購入させる、配送会社と直接通信させる必要がある場合。
- WMS、OMS、TMS、または在庫管理機能が必要な場合。
- PDF 生成の外側にあるネイティブ EDI、通関申告、貨物仲介業務のワークフローが必要な場合。
呼び出す endpoint
/api/v1/pdf/render
JSON Render がこのワークフローの標準パスです。
/api/v1/template-render
関連 API パス、テンプレート契約、または機能確認が必要な場合に使います。
最小リクエスト
POST /api/v1/template-render - 構造化データから繰り返し使う物流書類を生成。
{
"template_id": "packing_list",
"data": [
{
"order_number": "SO-8421",
"warehouse": "LAX-01",
"ship_to": "Example Retailer, 88 Harbor Rd, Long Beach, CA",
"items": [
{ "sku": "CASE-001", "description": "Widget case", "quantity": 4 },
{ "sku": "CASE-002", "description": "Replacement kit", "quantity": 1 }
]
}
]
}
gPdf が担当すること
- 構造化された物流書類の PDF レンダリング。
- ラベルサイズのページ、A4/letter 文書、バーコード、表、住所ブロック、メタデータ。
- 承認済みの倉庫・フルフィルメント書類レイアウト向け Template Render。
- 再印刷と監査記録向けの再現性ある出力。
自社システムが担当すること
- 出荷ステータス、配送会社サービス、ルーティングルール、在庫ステータス、書類の発行可否。
- WMS、OMS、TMS、ERP、3PL システムからの業務データマッピング。
- プリンターへの振り分け、保存、配信、リトライロジック、運用上の例外処理。
本番前チェックリスト
- どの書類を直接 JSON Render にし、どれをテンプレートにするか決める。
- 書類タイプごとに、バーコード、住所、表がはみ出すケースを検証する。
- 再印刷と監査要件に従って、元データまたは PDF を保存する。
- 配送会社 API 呼び出しとレンダリング API 呼び出しは、別々の連携ステップとして保つ。
- 配送ラベルや倉庫ラベルの内容を重複させず、より具体的なページへリンクする。
対応範囲の境界
- gPdf は物流 PDF を生成しますが、配送会社、WMS、OMS、TMS、送料プロバイダーではありません。
- 出荷運賃の計算、ラベル購入、在庫ステータス、配送会社オペレーションは gPdf の外側に残ります。
- この広いページは、具体的なワークフロー意図に合う、より焦点の絞られた個別ページへリンクするための入口です。
物流書類はひとつのクラスター
物流 PDF 生成は、配送ラベル、倉庫ラベル、納品書、マニフェスト、運送状、ピッキングリスト、社内引き渡し書類など、複数の書類タイプを含みます。このページは広い入口です。ラベルやバーコード中心のワークフローに対する正確な検索意図は、より具体的なページが担います。
API の使い方
ほとんどの物流書類は JSON Render または Template Render のどちらかを使います。JSON Render は、システムが生成するレイアウトや個別性の高い書類に向いています。Template Render は、運用チームが安定したレイアウトと少数のデータフィールドを期待する繰り返し書類に向いています。
運用システムを正本に保つ
WMS、OMS、TMS、3PL プラットフォーム、ERP、または配送会社連携が、出荷ステータスと業務ルールの信頼できる情報源であり続けます。gPdf は最終的な書類データを受け取り、PDF 出力を生成します。
FAQ
- このページは配送ラベルページと違いますか？
- はい。これは物流書類全体の広い入口ページです。配送ラベルと倉庫ラベルには、ラベルとバーコードに特化したより具体的なページがあります。
- gPdf は配送会社を呼び出しますか？
- いいえ。配送会社 API、送料、出荷運賃の計算、ルーティングは自社の物流スタックが扱います。gPdf は受け取ったデータから PDF をレンダリングします。
- 物流書類にはどのエンドポイントが合いますか？
- カスタムレイアウトには JSON Render を、納品書や倉庫ラベルのような承認済みの繰り返し書類には Template Render を使います。
- 物流ページにバーコードを含められますか？
- はい。gPdf は PDF 内にバーコード要素をレンダリングしますが、エンコードする値と運用上の検証は自社システム側で管理します。