goods/setGoodsInfo

修改商品

URL

https://api.weibo.com/2/proxy/eshop/open/goods/setGoodsInfo

返回格式

JSON

HTTP请求方式

POST

是否需要登录

是
关于电商服务商应用授权，参见 电商服务商应用 基础能力

访问授权限制

访问级别：高级接口（需要授权） - 仅限电商服务商第三方开发者
频次限制：是
关于频次限制，参见 接口访问权限说明

请求参数

注意事项

• 1、参数 skus 说明，有以下三种情况：
  • 1.1、编辑SKU数据时，参数 skus 数组中需要传入要修改的SKU对应的 sku_id，示例

[{"sku_id":"499","cover":"https://wx1.sinaimg.cn/large/005O6SuGly8h.jpg","spec_value":"11","retail_price":"1.00","stock":"2","pin":""}]

• • 1.2、新增SKU数据时，参数 skus 数组中不需要传入SKU对应的 sku_id，此时系统会认为是新增SKU操作，示例

[{"cover":"https://wx1.sinaimg.cn/large/005O6SuGly8h.jpg","spec_value":"11","retail_price":"1.00","stock":"2","pin":""}]

• • 1.3、删除SKU数据时，参数 skus 数组中不需要传入此SKU数据，此时系统会认为是删除SKU操作

• • 字段说明：
  • cover：SKU商品图片
  • spec_value：商品规格
  • retail_price：商品售价
  • stock：商品库存
  • pin：第三方商品识别码
• 2、由于不同类目的商品在创建时会产生扩展字段，因此需要先根据商品所属类目去调用 获取商品扩展类目接口，获取对应类目下的商品扩展字段列表，然后补全扩展字段到修改接口，即调用本接口传参时，需把 获取商品扩展类目接口 返回的 extend 列表中的 field_key 字段作为参数项并带上对应的参数值补充进去。rules 中的 required 是是否必填，如果是 true 则该参数必填，本修改接口会有校验

• 3、接口中需要补充的扩展类目，只需要在请求参数里增加通过 获取商品扩展类目接口 中的 fild_key 字段作为参数即可，例如，有 delivery_time，presale_time，brand_cert 三个扩展字段，那么在修改商品的时候需要将这三个字段及其数据作为参数放进修改商品接口里，类似这样，delivery_time=xxx ，presale_time=xxx ，brand_cert=xxx

• 4、扩展类目字段中的 filed_option，请参见 获取商品扩展类目接口 文档，如果是选择类的数据项，则取值需要从 option 中选择对应的数据，而 upload 类型的数据项，则需要传图片或者文件的 url

• 5、如果遇到传入商品图片导致的接口报错、创建失败的情况，需要接入方把图片的域名发给微博电商平台，开通豁免后即可解决

• 6、商品再次编辑后，如触发二次审核相关字段，则商品数据不会直接修改，数据会进入二次审核状态，需要等微博电商运营人工审核通过后，数据才会生效，二次审核相关操作接口参见相关接口文档

• 7、如果商品已处于二次审核待审核状态，则不可以调用此接口进行重复编辑，需要先将要修改的商品撤销二次审核，或者微博电商运营审核驳回/通过后才可以重新编辑

• 8、此接口修改库存逻辑为，计算接口传参的库存值和当前库存数据的差值，如果小于0则扣减对应数值的库存，如果大于0则增加对应数值的库存，示例：如果某SKU的库存 stock 传参值为100，系统会获取接口执行时点的库存数据，例如为50，那么会执行+50库存操作，而不是直接将库存设置为100。如果整体需要过二次审核，那么+50库存的操作也会在二次审核通过时统一执行

返回结果

{
    "code": 0, 
    "msg": "", 
    "data": { }, 
    "consume": 60, 
    "time": 1658143987
}

关于错误返回值与错误代码，参见 错误代码说明

返回字段说明

其他

无

相关问题

无