物流・ラベル
倉庫・3PL ワークフローのためのパレットラベル API
SSCC、GS1-128、テキストブロック、再印刷でも安定するテンプレートで、倉庫、3PL、小売、物流ワークフロー向けのパレットラベルPDFを生成します。
主 API JSON Render
ENDPOINT
/api/v1/pdf/render 対象システム WMS / 3PL バックエンド / ERP エクスポートサービス / 倉庫印刷サービス
解決する業務課題
WMS、ERP、3PL データからパレットラベルPDFをレンダリングし、倉庫チームが入荷、出荷、在庫移動の中でパレットを識別し、SSCC または GS1 バーコードをスキャンし、必要に応じて同じラベルを再印刷できるようにします。
この API が合う場合
- WMS 側にパレット ID、SKU または GTIN データ、数量、ロット、行き先がすでにある場合。
- SSCC、GS1-128、その他対応バーコード形式を含む PDF ラベルが必要な場合。
- 同じ元データから再現性のある再印刷をしたい場合。
- レイアウトを安定した Template Render の仕様として扱いたい場合。
置き換えないもの
- gPdf に在庫、パレット化、倉庫タスクを管理させたい場合。
- PDF バーコードレンダリングではなく GS1 認定が必要な場合。
- プリンターコマンドを直接出力する必要がある場合。
呼び出す endpoint
/api/v1/pdf/render
JSON Render がこのワークフローの標準パスです。
/api/v1/template-render
関連 API パス、テンプレート契約、または機能確認が必要な場合に使います。
最小リクエスト
POST /api/v1/pdf/render - SSCC バーコード付きパレットラベル。
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 5,
"y": 7,
"content": "PALLET 12 / DOCK B",
"style": { "font_size": 13, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 5,
"y": 28,
"width": 92,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 5,
"y": 78,
"content": "GTIN 09506000134352\nQTY 48 CASES\nLOT L-2026-05",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf が担当すること
- テキスト、ボックス、バーコード要素を持つラベルサイズ PDF ページ。
- PDF 出力内の SSCC、GS1-128、Code 128、QR、その他対応バーコード形式。
- 承認済みパレットラベルレイアウト向けのテンプレート連携。
- 再印刷と監査証跡向けの再現性ある出力。
自社システムが担当すること
- パレット ID、商品データ、ロットデータ、数量、経路、倉庫ルール。
- バーコード値の正しさ、チェックデジット、スキャナーテスト、ラベル用紙の検証。
- 印刷ステーションへの振り分け、再印刷の承認、在庫ステータス。
本番前チェックリスト
- レンダリング前に SSCC または GS1 データを検証する。
- 入荷ステーションと出荷ステーションの本番スキャナーでラベルをスキャンする。
- 密なデータ、長い商品名、複数の倉庫向け言語要件をテストする。
- 再印刷のために template_id、元のパレット ID、リクエスト ID を記録する。
- 倉庫ステータスの遷移はレンダリング API の外側に置く。
対応範囲の境界
- gPdf はパレットラベルPDFをレンダリングしますが、パレットや倉庫在庫を管理しません。
- gPdf は GS1 認定機関ではありません。
- スキャナーで受け入れられることの確認と、倉庫プロセスの正しさは自社側に残ります。
パレットラベルは WMS データを印刷出力につなぐ
パレットラベルのワークフローは自社の WMS または ERP から始まります。どのパレット、商品、数量、ロット、経路のデータをラベルに載せるかを決めるのはそれらのシステムです。gPdf はそのデータを、倉庫の印刷ステーションが出力・再印刷できる PDF に変換します。
検索意図が特に SSCC-18 や GS1 物流ラベルに絞られている場合は、SSCC 専用ページを使います。このページは、より広いパレットラベルワークフロー向けです。
FAQ
- gPdf で SSCC パレットラベルを生成できますか?
- gPdf は PDF 出力内に SSCC バーコード要素をレンダリングできます。SSCC 値と GS1 としての業務上の意味は自社システム側で管理します。
- gPdf はパレット在庫を管理しますか?
- いいえ。在庫ステータスは WMS または ERP システムが管理します。gPdf はラベルPDFをレンダリングします。
- パレットラベルに Template Render を使えますか?
- はい。パレットラベルのレイアウトが承認されたあとは、通常 Template Render が本番経路になります。
- gPdf は GS1 ラベルを認定しますか?
- いいえ。gPdf はベクター PDF バーコードをレンダリングします。認定、スキャンテスト、受け入れ確認は自社側で行います。