物流・ラベル
WMS と ERP の印刷ワークフローのための倉庫ラベル API
WMS または ERP のデータから、パレット、ケース、棚番、在庫、倉庫オペレーション用ラベル PDF を生成し、再印刷でも同じ結果を再現します。
主 API JSON Render
ENDPOINT
/api/v1/pdf/render 対象システム WMS / ERP / 倉庫印刷サービス / 在庫ワークフロー
解決する業務課題
WMS または ERP のデータから、パレット、カートン、棚番、資産、ロケーション、在庫移動向けの倉庫ラベルをレンダリングし、在庫ステータス、ピッキングルール、倉庫オペレーションは呼び出し元システム側に保持します。
この API が合う場合
- パレット、カートン、棚番、ロケーション、在庫、資産ラベルを PDF として生成する必要がある場合。
- WMS または ERP が SKU、ロット、ロケーション、SSCC、在庫データをすでに管理している場合。
- ラベルの破損や印刷ステーションの再試行時に、再現性のある再印刷が必要な場合。
- 承認済みのラベルレイアウトを Template Render で再利用したい場合。
置き換えないもの
- gPdf に在庫管理、ロケーション割り当て、倉庫ワークフローの実行を任せたい場合。
- gPdf からスキャナーアプリ、印刷ステーションエージェント、ラベル振り分けシステムを提供してほしい場合。
- バーコード描画ではなく 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": 6,
"y": 8,
"content": "PALLET LAX-01-2026-00042",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "012345678901234567",
"x": 6,
"y": 30,
"width": 88,
"height": 26,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 6,
"y": 70,
"content": "SKU: CASE-001\nQTY: 48\nLOCATION: A-14-02",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf が担当すること
- 倉庫印刷ワークフロー向けの PDF ラベル。
- ベクターバーコード、テキスト、枠、ラベル用ページサイズ、テンプレート連携。
- 再印刷と監査ワークフローに向いた再現性のある出力。
- カスタムレイアウト向けの JSON Render と、承認済みラベル仕様向けの Template Render。
自社システムが担当すること
- 在庫ステータス、SKU データ、ロット/シリアルデータ、SSCC 値、ロケーションの業務上の意味。
- プリンターへの振り分け、ステーション設定、スキャナー検証、倉庫プロセスのルール。
- テンプレート選択、再試行、生成済み PDF または元データの保存。
本番前チェックリスト
- 実際のプリンターとラベル用紙に合わせてラベル寸法を検証します。
- 倉庫プロセスで使用するすべてのバーコード形式をスキャンして確認します。
- WMS/ERP を正とし、最終的なラベルデータだけを gPdf に送ります。
- 複数のシステムやステーションで印刷するラベルには Template Render を使います。
- 再印刷の追跡性を確保するため、元文書 ID と request ID を記録します。
対応範囲の境界
- gPdf は倉庫ラベル PDF をレンダリングします。在庫や倉庫ステータスは管理しません。
- バーコードにエンコードする値の業務上の意味と、スキャナーで受け入れられることの確認は呼び出し元の責任です。
- Template Render はラベルレイアウトの安定化に使えますが、WMS のルールを置き換えるものではありません。
倉庫ラベルは業務記録です
倉庫ラベルは、パレット、ケース、棚番、資産、在庫移動、ロケーションを識別します。これらは WMS または ERP 内の業務ステータスと結びついています。gPdf が受け取るべきなのは最終的なラベルデータであり、それをレンダリングします。在庫の意味づけや倉庫プロセスの状態を gPdf が判断するものではありません。
Template Render で印刷ステーションをシンプルに保つ
複数のステーションで使うラベルは、承認済みレイアウトとしてテンプレート公開します。印刷サービスは、各呼び出し側で座標を組み直す代わりに、template_id と WMS データを送るだけで済みます。
再印刷の再現性
倉庫ではラベルの再印刷が発生します。ラベルの破損、プリンター詰まり、ステーションの再試行によって、少し違う文書が作られてはいけません。元のラベルデータを倉庫レコードに紐づけ、再印刷には再現性のあるレンダリング入力を使います。
FAQ
- gPdf は倉庫在庫を管理しますか？
- いいえ。WMS または ERP が在庫ステータス、ロケーション、SKU、ロット、プロセスルールを管理します。gPdf は最終データからラベル PDF をレンダリングします。
- 倉庫ラベルに GS1 や SSCC バーコードを使えますか？
- はい。gPdf は対応しているバーコード形式を PDF 出力内にレンダリングできます。バーコード値とスキャナーで受け入れられることの確認は自社システム側で管理します。
- 繰り返し使う倉庫ラベルにはテンプレートを使うべきですか？
- 多くの場合は、はい。Template Render を使うと、ラベルレイアウト承認後に印刷ステーションへ安定した template_id とデータ仕様を渡せます。
- 再印刷はどう扱うべきですか？
- 元のラベルデータまたは生成済み PDF を倉庫レコードと一緒に保存し、元の業務 ID を使って同じラベルを再レンダリングまたは取得します。