开发文档 > 应用开发 > 开放 API > 全部 API > ProductVariant

ProductVariant

#实体关系 ProductVariant 为 Product 的单品或SKU，包含了单品特定样式信息和价格、重量、体积等，一个 Product 可以包含多个 ProductVariant 。

ProductVariant 对象支持 Metafields。

ProductVariant 相关API

GET /products/#{id}/variants获取 Product 所有 ProductVariant GET /products/#{id}/variants/count获取 Product 所有 ProductVariant 的数量 GET /products/#{id}/variants/#{id}获取 Product 的单个 ProductVariant POST /products/#{id}/variants创建 ProductVariant PUT /products/#{id}/variants/#{id}更新 ProductVariant DELETE /products/#{id}/variants/#{id}删除 ProductVariant

ProductVariant 相关属性

- id
- ```
  { "id" : 148002 }
```
  Number 类型，ProductVariant 的唯一整型标识。
- product_id
- ```
  { "product_id" : 10254}
```
  Number 类型，ProductVariant 所属 Product 的唯一整型标识。
- created_at
- ```
  { "created_at" : "2014-02-15T15:12:21+08:00" }
```
  Datetime 类型，ProductVariant 的创建时间。
- updated_at
- ```
  { "updated_at" : "2014-02-15T15:12:21+08:00" }
```
  Datetime 类型，ProductVariant 的上一次更新时间。
- barcode
- ```
  { "barcode" : "102356-1002" }
```
  String 类型，ProductVariant 的编号。
- compare_price
- ```
  { "compare_price" : 100 }
```
  Price 类型，ProductVariant 的原价。
- price
- ```
  { "price" : 200}
```
  Price 类型，ProductVariant 的售价。
- image_id
- ```
  { "image_id" : 125680 }
```
  Number 类型，ProductVariant 被关联的 ProductImage 的 ID。
- sale
- ```
  { "sale" : 126 }
```
  Number 类型，ProductVariant 的销量。
- stock
- ```
  { "stock" : 302 }
```
  Number 类型，ProductVariant 的库存。
- reward_point
- ```
  { "reward_point" : 0 }
```
  Number 类型，ProductVariant 的赠送积分。
- volume
- ```
  { "volume" : 100 }
```
  Float 类型，ProductVariant 的体积(单位：立方米)。
- weight
- ```
  { "weight" : 200 }
```
  Float 类型，ProductVariant 的重量(单位：千克)。
- option_1
- ```
  { "option_1" : "白色" }
```
  String 类型，ProductVariant 的商品属性 1。
- option_2
- ```
  { "option_2" : "S码" }
```
  String 类型，ProductVariant 的商品属性 2。
- option_3
- ```
  { "option_3" : "纯棉"}
```
  String 类型，ProductVariant 的商品属性 3。
- stock_type
- ```
  { "stock_type" : "B"}
```
  String 类型，ProductVariant 库存为0时是否仍可以购买，默认为B，不可购买，可选值 A：可购买， B：不可购买。
- alarm_num
- ```
  { "alarm_num" : "1"}
```
  Number 类型，ProductVariant 的警报值。
- is_alarmed
- ```
  { "is_alarmed" : true}
```
  Boolean 类型，ProductVariant 是否开启库存警报， true:开启，false:不开启，默认为不开启。
- phone_alarm
- ```
  { "phone_alarm" : true}
```
  Boolean 类型，ProductVariant 是否开启短信库存警报， true:开启，false:不开启，默认为不开启。
- email_alarm
- ```
  { "email_alarm" : true}
```
  Boolean 类型，ProductVariant 是否开启邮件库存警报， true:开启，false:不开启，默认为不开启。
- weixin_alarm
- ```
  { "weixin_alarm" : true}
```
  Boolean 类型，ProductVariant 是否开启微信库存警报， true:开启，false:不开启，默认为不开启。

GET /products/#{id}/variants

获取 Product 所有 ProductVariant

- fields
- 需要查询的字段

获取 Product 所有 ProductVariant
GET /products/12032/variants

{
    "variants": [
        {
            "barcode": "",
            "compare_price": 0,
            "created_at": "2014-02-15T15:12:21+08:00",
            "id": 95721,
            "image_id": null,
            "option_1": "白",
            "option_2": "诡异1",
            "option_3": "2",
            "price": 10,
            "product_id": 12032,
            "sale": 152,
            "stock": 100,
            "updated_at":"2014-02-15T15:12:21+08:00",
            "volume": 2,
            "weight": 40
        },
        {
            "barcode": "",
            "compare_price": 0,
            "created_at": "2014-02-15T15:16:21+08:00",
            "id": 95720,
            "image_id": null,
            "option_1": "白",
            "option_2": "诡异1",
            "option_3": "1",
            "price": 10,
            "product_id": 12032,
            "sale": 102,
            "stock": 100,
            "updated_at": "2014-02-15T15:16:21+08:00",
            "volume": 1,
            "weight": 10
        }
    ]
}

GET /products/#{id}/variants/count

获取 Product 所有 ProductVariant 的数量

- 获取商品所有 ProductVariant 的数量
- GET /products/12032/variants/count
- ```
{
    "count": 2
}
```

GET /products/#{id}/variants/#{id}

获取 Product 的单个 ProductVariant

- fields
- 需要查询的字段

获取 Product 的单个 ProductVariant
GET /products/12032/variants/95721

{
    "variant": [
        {
            "barcode": "",
            "compare_price": 0,
            "created_at": "2014-02-15T15:12:21+08:00",
            "id": 95721,
            "image_id": null,
            "option_1": "白",
            "option_2": "诡异1",
            "option_3": "2",
            "price": 10,
            "product_id": 12032,
            "sale": 120,
            "stock": 90,
            "updated_at":"2014-02-15T15:12:21+08:00",
            "volume": 1,
            "weight": 40
        }
    ]
}

POST /products/#{id}/variants

创建 ProductVariant

- variant[stock]
- ProductVariant 的库存
- variant[price]
- ProductVariant 的售价
- variant[image_id]
- ProductVariant 的关联图片 ID
- variant[compare_price]
- ProductVariant 的原价
- variant[volume]
- ProductVariant 的体积
- variant[weight]
- ProductVariant 的重量
- variant[barcode]
- ProductVariant 的编号
- variant[option_1]
- ProductVariant 的商品属性1
- variant[option_2]
- ProductVariant 的商品属性2
- variant[option_3]
- ProductVariant 的商品属性3

创建 ProductVariant

POST /products/12560/variants

{
    "variant": {
        "option_1": "白",
        "option_2": "萝卜",
        "option_3": "XXL",
        "price": 10,
        "compare_price": 0,
        "stock": 9,
        "weight": 4,
        "volume": 1,
        "barcode": "",
        "image_id": null
    }
}

{
    "variant": {
        "barcode": "",
        "compare_price": 0,
        "created_at": null,
        "id": 96323,
        "image_id": null,
        "option_1": "白",
        "option_2": "萝卜",
        "option_3": "XXL",
        "price": 10,
        "product_id": 12560,
        "sale": 0,
        "stock": 9,
        "updated_at": null,
        "volume": 1,
        "weight": 4
    }
}

PUT /products/#{id}/variants/#{id}

更新 ProductVariant

- variant[stock]
- ProductVariant 的库存
- variant[price]
- ProductVariant 的售价
- variant[image_id]
- ProductVariant 的关联图片 ID
- variant[compare_price]
- ProductVariant 的原价
- variant[volume]
- ProductVariant 的体积
- variant[weight]
- ProductVariant 的重量
- variant[barcode]
- ProductVariant 的编号
- variant[option_1]
- ProductVariant的商品属性1
- variant[option_2]
- ProductVariant 的商品属性2
- variant[option_3]
- ProductVariant 的商品属性3

更新 ProductVariant

PUT /products/12560/variants/156896

{
    "variant": {
        "barcode": "IPSCCC0001",
        "compare_price": 1000,
        "image_id": 12588,
        "option_1": "白",
        "option_2": "萝卜",
        "option_3": "XXL",
        "price": 10,
        "stock": 9,
        "volume": 0,
        "weight": 4
    }
}

{
    "variant": {
        "barcode": "IPSCCC0001",
        "compare_price": 1000,
        "created_at": null,
        "id": 156896,
        "image_id": 12588,
        "option_1": "白",
        "option_2": "萝卜",
        "option_3": "XXL",
        "price": 10,
        "product_id": 12560,
        "sale": 0,
        "stock": 9,
        "updated_at": "2015-03-24T16:40:04.182+08:00",
        "volume": 0,
        "weight": 4
    }
}

DELETE /products/#{id}/variants/#{id}

删除 ProductVariant

- 删除 ProductVariant
- DELETE /products/12560/variants/156896
- ```
{}
```

应用开发

ProductVariant

ProductVariant

ProductVariant 相关API

ProductVariant 相关属性

GET /products/#{id}/variants

GET /products/#{id}/variants/count

GET /products/#{id}/variants/#{id}

POST /products/#{id}/variants

PUT /products/#{id}/variants/#{id}

DELETE /products/#{id}/variants/#{id}

联系客服

领取免费试用资格

姓名 *

电话 *

公司名称

所在地区

意向产品

提交成功

微信咨询

应用开发

ProductVariant

ProductVariant

ProductVariant 相关API

ProductVariant 相关属性

GET /products/#{id}/variants

GET /products/#{id}/variants/count

GET /products/#{id}/variants/#{id}

POST /products/#{id}/variants

PUT /products/#{id}/variants/#{id}

DELETE /products/#{id}/variants/#{id}

联系客服

领取免费试用资格

姓名 *

电话 *

公司名称

所在地区

意向产品

提交成功