商品バリエーションの更新エンドポイントを公開します

2026/06/12

商品IDと商品バリエーションIDを指定してリクエストすると、対象の商品バリエーションを1件更新できるエンドポイントを公開します。指定したフィールドのみを反映する部分更新形式です。

提供開始日

2026年6月12日(金)

リクエストボディ

キー名	値	形式
stocks	在庫数。全バリエーションの在庫数が未設定 (`null`) の状態で本フィールドに 0 以上の値を指定すると、他のバリエーションの在庫数は `0` になり、商品全体の在庫数はバリエーション在庫に揃い、本フィールドの指定値と等しくなります	数値 (0以上)
few_num	残りわずかとなる在庫数	数値 (0以上)
model_number	型番	文字列
weight	重量。`null` を明示的に指定すると未設定状態に戻ります	数値
option_price	販売価格。`null` を明示的に指定すると未設定状態に戻ります。フリープランを利用しているショップの場合、最低価格は100円です	数値
option_members_price	会員価格。`null` を明示的に指定すると未設定状態に戻ります。フリープランを利用しているショップの場合、最低価格は100円です	数値
option_market_price	定価。`null` を明示的に指定すると未設定状態に戻ります	数値
option_cost	原価。`null` を明示的に指定すると未設定状態に戻ります	数値

レスポンス

{
  "variant": {
    "id": 123,
    "product_id": 1342332,
    "account_id": "PA01234567",
    "title": "赤　x　S",
    "option1": {
      "id": 1,
      "name": "色",
      "value_id": 10,
      "value": "赤"
    },
    "option2": {
      "id": 2,
      "name": "サイズ",
      "value_id": 20,
      "value": "S"
    },
    "option1_value": "赤",
    "option2_value": "S",
    "stocks": 20,
    "few_num": 5,
    "model_number": "T-RED-S-223",
    "option_price": 1980,
    "option_price_including_tax": 2178,
    "option_price_tax": 198,
    "option_members_price": 1800,
    "option_members_price_including_tax": 1980,
    "option_members_price_tax": 180,
    "weight": 150,
    "option_market_price": 300,
    "option_cost": 80,
    "make_date": 1465784944,
    "update_date": 1494496809
  }
}

レスポンス項目の詳細は商品バリエーション一覧の取得と同一です。

注意事項

利用には OAuth スコープ write_products が必要です。
指定したフィールドのみが反映される部分更新形式です。リクエストボディに含めなかったフィールドは更新されません。
weight / option_price / option_members_price / option_market_price / option_cost は null を明示的に指定すると未設定状態に戻ります。

詳細は以下のドキュメントを確認ください。

商品バリエーションの更新