物流・ラベル
フルフィルメント業務のための納品書PDF API
EC、3PL、OMS、倉庫フルフィルメント向けに、注文、出荷、カートン、品目データから納品書PDFを生成します。
主 API Template Render
ENDPOINT
/api/v1/template-render 対象システム OMS / WMS / 3PL バックエンド / Shopify アプリバックエンド
解決する業務課題
出荷、届け先、品目、カートンのデータから納品書をレンダリングし、フルフィルメントチームが出荷する注文ごとに一貫した同梱書類を印刷または添付できるようにします。
この API が合う場合
- OMS や WMS 側に注文品目、数量、届け先データ、出荷識別子がすでにある場合。
- 倉庫の印刷ステーション向け、または顧客への小包同梱用に納品書PDFが必要な場合。
- 承認済みの 1 つのレイアウトを、複数の倉庫、ブランド、販売チャネルで再利用したい場合。
- 注文照会や返品受付のために、バーコードや QR コードが必要になる可能性がある場合。
置き換えないもの
- 送料の購入、出荷運賃の計算、配送会社ラベルの作成が必要な場合。
- ドキュメントのレンダリングではなく、倉庫の在庫管理が必要な場合。
- 法的な請求書や電子インボイスとしての業務上の意味が必要な場合。
呼び出す endpoint
/api/v1/template-render
Template Render がこのワークフローの標準パスです。
/api/v1/pdf/render
関連 API パス、テンプレート契約、または機能確認が必要な場合に使います。
最小リクエスト
POST /api/v1/template-render - 出荷 1 件の packing_list テンプレート。
{
"template_id": "packing_list",
"data": [
{
"shipment": {
"number": "PL-2026-1001",
"date": "2026-05-29"
},
"shipper": {
"name": "Acme Warehouse",
"address": "1200 Logistics Pkwy"
},
"consignee": {
"name": "Receiver Inc.",
"address": "123 Main St"
},
"items": [
{
"item_no": "1",
"description": "Replacement filter",
"quantity": "2",
"unit": "pcs",
"gross_weight": "1.2 kg",
"net_weight": "1.0 kg"
}
]
}
]
}
gPdf が担当すること
- 公開済みの納品書レイアウト向けの Template Render。
- 設計中や一度きりの業務向けの、カスタム納品書ページの JSON Render。
- 表、品目行、住所ブロック、任意のバーコード、PDF 出力。
- 同じデータとテンプレートを使ったときの再現性のある再印刷。
自社システムが担当すること
- 注文データ、品目数量、出荷ステータス、倉庫内の振り分け、顧客向けメッセージ。
- テンプレートのフィールドマッピング、印刷ステーションへの振り分け、再印刷ポリシー。
- 小包に同梱または付随させる必要がある、配送会社、通関、請求関連のドキュメント。
本番前チェックリスト
- 最も長い SKU、品名、住所の組み合わせをテストする。
- 1 品目、複数カートン、バックオーダー、分割出荷のケースを検証する。
- 納品書のレイアウトが承認されたら Template Render を使う。
- フルフィルメントの印刷リクエストごとに template_id と X-Request-Id をログに記録する。
- 配送会社ラベルの生成は、納品書のレンダリングと分けて扱う。
対応範囲の境界
- gPdf は納品書PDFをレンダリングします。在庫やフルフィルメントのステータスは管理しません。
- 納品書は、自動的に税務上の請求書や通関書類になるわけではありません。
- 配送会社ラベルの購入と出荷運賃の計算は、gPdf の外側にとどまります。
納品書はテンプレート経路に向いている
納品書は通常、荷送人、届け先、出荷番号、品目行、必要に応じた備考という安定した構造を持ちます。そのため、レイアウトが承認されたあとは Template Render がよく合います。
JSON Render は設計中にも有効です。安定した template_id のインターフェイスを公開する前に、列、間隔、バーコード配置、改ページをチームが調整できます。
FAQ
- 納品書は専用の gPdf エンドポイントですか？
- いいえ。承認済みの納品書テンプレートには Template Render を、システムがレイアウトを直接記述する場合は JSON Render を使います。
- 納品書にバーコードを入れられますか？
- はい。gPdf は PDF にバーコード要素をレンダリングできます。注文、カートン、返品に関してエンコードする値は自社システム側で管理します。
- gPdf は配送会社ラベルを作りますか？
- いいえ。配送会社ラベルは別のワークフローです。gPdf は、配送会社または出荷システムが提供するデータから PDF をレンダリングします。
- 1 つのリクエストで複数の納品書をレンダリングできますか？
- Template Render は、そのエンドポイントについて文書化された公開 API の上限内で、複数項目を含む data 配列を受け取れます。