物流・ラベル

倉庫・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 がこのワークフローの標準パスです。

補助経路 1

/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、商品データ、ロットデータ、数量、経路、倉庫ルール。
  • バーコード値の正しさ、チェックデジット、スキャナーテスト、ラベル用紙の検証。
  • 印刷ステーションへの振り分け、再印刷の承認、在庫ステータス。

本番前チェックリスト

  1. レンダリング前に SSCC または GS1 データを検証する。
  2. 入荷ステーションと出荷ステーションの本番スキャナーでラベルをスキャンする。
  3. 密なデータ、長い商品名、複数の倉庫向け言語要件をテストする。
  4. 再印刷のために template_id、元のパレット ID、リクエスト ID を記録する。
  5. 倉庫ステータスの遷移はレンダリング 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 バーコードをレンダリングします。認定、スキャンテスト、受け入れ確認は自社側で行います。