品番
品番と、その色・サイズ（SKU）を登録・参照します。
品番は /v1/products です。参照には kikan_products_read、登録と更新には kikan_products_write が必要です。
| メソッド | パス | 結果 |
|---|---|---|
| GET | /products | 一覧 |
| GET | /products/{品番} | 1件 |
| PUT | /products/{品番} | 作成（201）または更新（200） |
id は品番です。単体の PUT では、品番はパスだけに書きます。本文に product_code を入れると 422 です。一括登録では、逆に各要素へ product_code を書きます。
一覧は { "has_more": true, "data": [ ... ] } です。1件と PUT の成功は、品番そのものの JSON です。
品番の項目
| 項目 | 内容 |
|---|---|
name | 品名。作成時は必須 |
status | draft / active / discontinued。省略時は draft |
brand_code | ブランドコード |
season_code | シーズンコード |
category_code | カテゴリコード |
supplier_code | 仕入先コード |
retail_price | 上代 |
cost_price | 原価 |
material | 素材 |
country_of_origin | 原産国 |
launched_on | 発売日。YYYY-MM-DD |
wholesale_due | 卸の納期。YYYY-MM-DD |
skus | SKU の配列。省略すると、既存の SKU はそのまま |
参照時には、加えて id、created_at、updated_at が返ります。
brand_code、season_code、category_code は、先に マスタ にあるコードだけを受け付けます。
SKU
送るときは、color_code と size_code の両方が必要です。同じ組は、すでにあればそのまま残し、削除済みなら戻します。配列に無い SKU は消えません。
sku_code と jan_code は参照専用です。空の sku_code は、品番-色-サイズ で埋まります。JAN は、空のときに割り当てます。
{
"name": "シャツ",
"status": "active",
"brand_code": "BR01",
"retail_price": 12000,
"skus": [{ "color_code": "BK", "size_code": "M" }]
}PUT /v1/products/SH001 のように送ります。応答の skus には、割り当て済みの sku_code と jan_code が入ります。