バーコード・小売
GS1 物流ラベル向け SSCC ラベル API
物流、パレット、カートン、倉庫ワークフロー向けに、SSCC-18 バーコードラベルを PDF としてレンダリングし、GS1 データの正しさは自社システム側で管理します。
主 API JSON Render
ENDPOINT
/api/v1/pdf/render 対象システム WMS / 3PL バックエンド / 小売物流システム / 倉庫印刷サービス
解決する業務課題
自社システムが SSCC（Serial Shipping Container Code）を割り当て、その GS1 仕様上の意味を検証したあと、パレット、カートン、物流単位向けの SSCC-18 バーコードラベルをベクター PDF 出力としてレンダリングします。
この API が合う場合
- 自社システムがすでに SSCC 値と関連するアプリケーション識別子を管理している場合。
- スキャン可能な SSCC バーコードと人間可読テキストを含む PDF ラベルが必要な場合。
- 倉庫または 3PL 印刷ステーション向けに、繰り返し使う SSCC ラベルレイアウトが必要な場合。
- SSCC ラベルを、より広いパレットまたは倉庫ラベルワークフローにつなげたい場合。
置き換えないもの
- gPdf から GS1 事業者コードの発行、チェックデジット作成、コンプライアンス認証が必要な場合。
- 在庫または出荷状態の管理が必要な場合。
- 配送業者ラベルの購入または運賃計算が必要な場合。
呼び出す endpoint
/api/v1/pdf/render
JSON Render がこのワークフローの標準パスです。
/api/v1/template-render
関連 API パス、テンプレート契約、または機能確認が必要な場合に使います。
最小リクエスト
POST /api/v1/pdf/render - SSCC-18 ラベルバーコード。
{
"pages": [
{
"size": "label_100_150",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "SSCC",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 6,
"y": 28,
"width": 86,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
gPdf が担当すること
- PDF ページ内でのベクター SSCC バーコードレンダリング。
- テキスト、ボックス、バーコードテキスト、任意のテンプレートバインディングを含むラベルレイアウト。
- 印刷、保存、倉庫再印刷ワークフロー向けの PDF 出力。
- リクエスト検証に失敗した場合の共通エラー形式。
自社システムが担当すること
- GS1 事業者コード、拡張桁、シリアル参照、チェックデジット、符号化データ。
- 倉庫プロセスルール、スキャナーでの読取合格、ラベル用紙の検証。
- SSCC を利用する EDI、ASN、配送業者、取引先ワークフロー。
本番前チェックリスト
- gPdf を呼ぶ前に SSCC 値とチェックデジットを検証する。
- 本番スキャナーとラベル用紙で出力をスキャンする。
- どの倉庫イベントが SSCC ラベルを作成・再印刷するかを文書化する。
- 承認済み SSCC ラベルレイアウトには Template Render を使う。
- 取引先コンプライアンスチェックはレンダリング呼び出しの外側に保つ。
対応範囲の境界
- gPdf は SSCC バーコードを PDF としてレンダリングしますが、SSCC 値を発行または認証しません。
- GS1 と取引先のコンプライアンスは自社の責任です。
- SSCC ラベルは配送業者側の出荷作成を意味しません。
SSCC ラベルは焦点の絞られたバーコードワークフロー
SSCC ラベルは、一般的なパレットラベルよりも範囲の絞られたワークフローです。重要なのは SSCC（Serial Shipping Container Code）そのものです。gPdf はそのコードを PDF 内にレンダリングします。コードの割り当て、GS1 ルール、取引先要件は自社システム側で管理します。
FAQ
- gPdf は SSCC 番号を作成できますか？
- いいえ。SSCC 値は自社システムが作成・検証します。gPdf はそれを PDF 内のバーコードとしてレンダリングします。
- どのバーコード形式を使うべきですか？
- SSCC バーコード要素をレンダリングするときは、sscc-18 などの対応 SSCC エイリアスを使います。
- これはテンプレートにできますか？
- はい。ほとんどの SSCC ラベルは、レイアウトとフィールドマッピングが承認されたあと Template Render に移すべきです。
- これは GS1 コンプライアンスを認証しますか？
- いいえ。gPdf はベクターバーコード出力をレンダリングします。コンプライアンスとスキャナーでの読取合格は別の責任です。