EC プラットフォーム
セラー業務と倉庫バックエンド向けの Amazon FBA ラベル API
販売事業者や倉庫のデータから、Amazon FBA 形式の商品・輸送箱・出荷ラベルPDFを、ベクターバーコードとテンプレート出力で生成します。
主 API JSON Render
ENDPOINT
/api/v1/pdf/render 対象システム セラーツール / 倉庫バックエンド / FBA 納品準備サービス / EC 運用システム
解決する業務課題
セラー、納品準備、または倉庫システム側で正しい識別子、バーコードデータ、ラベルルールを確定したあと、Amazon FBA の納品準備ワークフロー向けに商品・輸送箱・出荷ラベルPDFを生成します。
この API が合う場合
- 自社システムがすでに FNSKU、輸送箱、出荷、または納品準備サービス用のラベルデータを持っている場合。
- セラーまたは倉庫の印刷ステーション向けに、ベクターバーコード付きの PDF ラベル出力が必要な場合。
- 繰り返し使うラベルレイアウトを Template Render の安定したインターフェイスにしたい場合。
- 納品準備、監査、例外対応のために、再現性のある再印刷が必要な場合。
置き換えないもの
- gPdf に公式の Amazon 連携、アプリ、または SP-API コネクタを求めている場合。
- Amazon によるラベル認定を gPdf 経由で受ける必要がある場合。
- 在庫、出品、または出荷プランの管理が必要な場合。
呼び出す endpoint
/api/v1/pdf/render
JSON Render がこのワークフローの標準パスです。
/api/v1/template-render
関連 API パス、テンプレート契約、または機能確認が必要な場合に使います。
最小リクエスト
POST /api/v1/pdf/render - FNSKU 形式のバーコードデータを持つ商品ラベル。
{
"pages": [
{
"width": 70,
"height": 35,
"elements": [
{
"type": "text",
"x": 4,
"y": 4,
"content": "FNSKU X00ABC1234",
"style": { "font_size": 8, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "code128",
"content": "X00ABC1234",
"x": 4,
"y": 12,
"width": 60,
"height": 12,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 4,
"y": 29,
"content": "SKU: ACME-FILTER-01",
"style": { "font_size": 6, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf が担当すること
- JSON Render の送信データから、ラベルサイズの PDF を生成すること。
- ベクターバーコード、テキスト、SKU ブロック、枠線、テンプレートへのバインド。
- Template Render による繰り返しラベル出力。
- 印刷ステーション、セラーツール、倉庫ワークフロー向けの PDF レスポンス。
自社システムが担当すること
- Amazon アカウント連携、SP-API 呼び出し、出荷プランデータ、FNSKU 値、マーケットプレイスのルール。
- 正しいバーコードデータ、ラベル寸法、商品データ、スキャン可否の受け入れ確認。
- セラー向け UX、納品準備ワークフロー、保存、再印刷の認可。
本番前チェックリスト
- レンダリング前に、対象マーケットプレイスとフルフィルメント要件を確認する。
- バーコードデータと実際の印刷品質を、本番用ラベル用紙で検証する。
- Amazon 連携と認証情報の取り扱いは gPdf の外側に保つ。
- 再印刷が同じ内容になるよう、元のラベルデータを保存する。
- 承認済みレイアウトは、印刷ステーション連携向けに Template Render へ移す。
対応範囲の境界
- gPdf は公式の Amazon アプリでも SP-API コネクタでもありません。
- gPdf は PDF を生成します。Amazon コンプライアンスとセラー業務のルールは自社側で管理します。
- PDF レンダリングを Amazon ラベル認定として扱わないでください。
FBA ラベルはデータで決まる PDF ラベル
Amazon FBA の納品準備ワークフローでは、商品、輸送箱、出荷ラベルが必要になることがよくあります。レンダリング上の課題は単純です。自社システムが識別子とラベルルールを渡し、gPdf が PDF を生成します。
マーケットプレイス連携はレンダリングと分けてください。正しい識別子はセラーまたは倉庫システムで取得または計算し、最終的なラベルデータを gPdf に送ります。
FAQ
- gPdf は公式の Amazon FBA アプリですか？
- いいえ。セラー、納品準備、または倉庫バックエンドから gPdf を呼び出すことはできますが、gPdf は公式の Amazon アプリや SP-API 連携をうたっていません。
- gPdf で FNSKU ラベルを生成できますか？
- gPdf はバーコード要素を持つ PDF ラベルを生成できます。FNSKU 値、ラベルルール、Amazon ワークフローは自社システム側で管理します。
- FBA ラベルにはテンプレートを使うべきですか？
- 座標をテストしている間は JSON Render を使います。ラベルデザインとフィールド仕様が承認されたら Template Render を使います。
- gPdf は Amazon 向けにラベルを認定しますか？
- いいえ。印刷品質、スキャン受け入れ、マーケットプレイスのコンプライアンスは自社の責任です。