Admin/merchant/goods/update (o2o)

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 商品更新

接口名称

 admin/merchant/goods/update

请求参数

字段名 变量名 必填 类型 示例值 描述
token请求凭证 token String d122e3c72332c5af12a71d77c9f1462f5901d276
商品id goods_id int
商品名称 goods_name string
平台分类id category_id int
商家分类id merchant_category int
商品价格 goods_price Price
库存数量 stock int
商品图片 goods_image file
成本价 cost_price float 到家1.33新增 成本价
是否包邮 is_shipping string 到家1.33新增 是否包邮(yes是no否)
重量单位(既散装库存单位) weight_unit string 到家1.33新增 重量单位(gram克,kilogram千克)
商品货号(散装商品货号) goods_sn string 到家1.33新增 商品货号

举例如下

{
      "token" : "d122e3c72332c5af12a71d77c9f1462f5901d276",
      "goods_name" : "美国进口车厘子",
      "category_id" : 1,
      "merchant_category" : 1,
      "goods_price" : 39.00,
      "stock" : 1000,
      "is_shipping":"yes",
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态码 status Array() {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明)
返回信息 data Array() 请求接口提供的返回信息
商品id goods_id Int 商品id
商品名称 name String 商品名称
商品货号 goods_sn String 商品货号
品牌名称 brand_name String 品牌名称
商品分类id category_id int
商品分类 category_name String 商品类型
商品上级分类 category array
平台商品分类id merchant_category_id int
平台商品分类 merchant_category_name String
平台商品上级分类 merchant_category array
商品市场价格(格式化) market_price String 商品市场价格(格式化)
商品本店价格(格式化) shop_price String 商品本店价格(格式化)
是否促销 is_promote String 商品本店价格(格式化)
商品促销价格(格式化) promote_price String 商品促销价格(false为非促销,否则为格式化后的促销价格)
商品促销开始时间(格式化) promote_start_date String 商品促销开始时间(格式化)
商品促销结束时间(格式化) promote_end_date String 商品促销结束时间(格式化)
商品点击率 clicks Int 游客浏览次数(点击率)
库存数量 stock String 库存数量(空表示本店不启用库存)
商品重量 goods_weight String 商品重量
是否是精品 is_best int 是否是精品
是否是新品 is_new int 是否是新品
是否热卖 is_hot int 是否热卖
是否免邮费 is_shipping int 是否免邮费
是否在售 is_on_sale int 是否在售
是否能单独销售 is_alone_sale int 是否能单独销售
最后更新时间(格式化) last_updatetime String 最后更新时间(格式化)
商品描述 goods_desc String
商品会员等级价格 user_rank Array() 商品会员等级价格
└ 会员等级id rank_id Int 会员等级id
└ 会员等级名称 rank_name String 会员等级名称
└ 会员折扣率 discount String 会员折扣率
└ 会员价格 price String 会员价格, -1代表按会员折扣率计算
商品优惠价格 volume_number Array() 商品优惠价格
└ 优惠数量 number Int 优惠数量
└ 优惠价格 price String 优惠价格
商品图片信息 img Array() 店铺内商品图片信息
└ 商品图片信息small small String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息small
└ 商品图片信息thumb thumb String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息thumb
└ 商品图片信息url url String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息url
商品图片相册信息 pictures Array() 店铺内商品图片相册信息
└ 图片id img_id int 25
└ 商品图片信息small small String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息small
└ 商品图片信息thumb thumb String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息thumb
└ 商品图片信息url url String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息url
商品描述 goods_desc String或null 商品描述,返回url链接或null
商品本店价格(未格式化) unformatted_shop_price String 商品本店价格(未格式化)
商品市场价格(未格式化) unformatted_market_price String 商品市场价格(未格式化)
商品促销价格(未格式化) unformatted_promote_price String 商品促销价格(未格式化)
赠送消费积分数 give_integral String 购买该商品时赠送消费积分数,-1表示按商品价格赠。
赠送等级积分数 rank_integral String 购买该商品时赠送等级积分数,-1表示按商品价格赠送。
积分购买金额 integral String 购买该商品时最多可以使用积分的金额
销量 sales_volume String 销量
是否绑定了参数模板 isbind_parameter_template String 到家1.33新增 是否绑定了参数模板(yes是no否)(此处商品未绑定但商品相关分类绑定了也算绑定)
是否绑定了规格模板 isbind_specification_template String 到家1.33新增 是否绑定了规格模板(yes是no否) (此处商品未绑定但商品相关分类绑定了也算绑定)
是否有货品 has_products String 到家1.33新增 是否有货品(yes是no否)
商品扩展类型 extension_code String 到家1.33新增 商品扩展类型(commom普通商品,bulk散装商品,cashier收银台商品)
重量单位 weight_unit String 到家1.33新增 重量单位(gram克kilogram千克)
散装商品库存重量 weight_stock float 到家1.33新增 散装商品库存重量

成功举例如下

{
      "data" : {
            "goods_id" : "354",
            "name" : "ECSHOP模板堂物流快递跟踪插件免费下载",
            "goods_sn" : "000354",
            "brand_name" : "",
            "category_id" : 5,
            "category_name" : "免费插件",
            "category" : [{
                        "cat_id": 0,
                        "cat_name": '',
                        "parent_id" : 0,
                        "level": 0}
            ],
            "merchant_category_id" : 5,
            "merchant_category_name" : "免费插件",
            "merchant_category" : [{
                        "cat_id": 0,
                        "cat_name": '',
                        "parent_id" : 0,
                        "level": 0}
            ],
            "market_price" : "¥0.00元",
            "shop_price" : "¥0.00元",
            "is_promote" : 0,
            "promote_price" : "¥0.00元",
            "promote_start_date" : "",
            "promote_end_date" : "",
            "clicks" : 2317,
            "stock" : "",
            "goods_weight" : "0克",
            "is_best" : 1,
            "is_new" : 0,
            "is_hot" : 1,
            "is_shipping" : 0,
            "is_on_sale" : 0,
            "is_alone_sale" : 1,
            "last_updatetime" : "2014-05-29 11:59:04",
            "img": {
                  "thumb" : "http://192.168.1.55/ecmoban-admin/content/uploads/images/201401/goods_img/354_G_1390755819535.jpg",
                  "url" : "http://192.168.1.55/ecmoban-admin/content/uploads/images/201401/source_img/354_G_1390755819414.jpg",
                  "small" : "http://192.168.1.55/ecmoban-admin/content/uploads/images/201401/thumb_img/354_thumb_G_1390755819437.jpg"
            },
            "pictures": [{
                  "img_id": 25,
                  "thumb": "http://192.168.1.55/ecmoban-admin/content/system/statics/images/nopic.png",
                  "url": "http://192.168.1.55/ecmoban-admin/content/system/statics/images/nopic.png",
                  "small": "http://192.168.1.55/ecmoban-admin/content/system/statics/images/nopic.png"
            }],
            "user_rank" : [{
                  "rank_id" :  3,
                  "rank_name" : "代销用户",
                  "discount" : "60",
		  "price" : 100.00
	    }],
            "volume_number" : [{
                  "number" : 1,
                  "price" : 100.00,
            }],
            "goods_desc" : ""
            "unformatted_shop_price" : 100.00,
            "unformatted_market_price" : 120.00,
            "unformatted_promote_price" : 90.00,
            "give_integral" : 100,
            "rank_integral" : 100,
            "integral" : 100,
            "sales_volume" : 0,
            "isbind_parameter_template":"yes",
            "isbind_specification_template":"no",
            "has_products":"yes",
            "extension_code":"common",
            "weight_unit":"kilogram",
            "weight_stock":1233.00,
      },
      "status" : {
            "succeed" : 1
      }
}

失败举例如下

{
      "status" : {
            "succeed" : 0,
            "error_code" : 100,
            "error_desc" : "Invalid session",
      }
}
{
      "status" : {
            "succeed" : 0,
            "error_code" : 101,
            "error_desc" : "错误的参数提交",
      }
}
{
      "status" : {
            "succeed" : 0,
            "error_code" : 13,
            "error_desc" : "不存在的信息",
      }
}

注:错误编码