ProductVariant - 友好速搭 -- 开发文档

友好速搭

开放 API
使用说明 获取授权 全部 API 特殊 API 开放功能

ProductVariant

ProductVariant

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

ProductVariant 对象支持 Metafields

ProductVariant 相关API

GET /products/#{id}/variants获取 Product 所有 ProductVariantGET /products/#{id}/variants/count获取 Product 所有 ProductVariant 的数量GET /products/#{id}/variants/#{id}获取 Product 的单个 ProductVariantPOST /products/#{id}/variants创建 ProductVariantPUT /products/#{id}/variants/#{id}更新 ProductVariantDELETE /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
    • {}
      
友好速搭,让商业更简单
0元开始
联系客服
电话咨询
服务热线
0755-83051027
获取报价
QQ咨询
微信咨询
微信二维码
在线咨询

在线获取方案和报价,专人快速响应

所选城市 *

您的称呼 *

联系电话 *

网站类型 *

请选择
展示官网 电商网站 微信商城 小程序 其他类型

您希望我们为您提供哪些服务?(可多选)

B2C商城 跨境解决方案 B2B2C平台电商 网站备案 自营电商培训
获取报价

提交成功

你好, XXX女士/先生 ,你的需求已提交成功,后续会有专门的客户经理与你电话联系。谢谢!