跳转到: 导航, 搜索

goods/setGoodsInfoPin

使用PIN码作为标识来修改商品

URL

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

返回格式

JSON

HTTP请求方式

POST

是否需要登录


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

访问授权限制

访问级别:高级接口(需要授权) - 仅限电商服务商第三方开发者
频次限制:
关于频次限制,参见 接口访问权限说明

请求参数

参数 必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得,此参数放在GET请求中
appid true int 电商服务商的身份标识,需联系微博电商分配获得
sign true string 验证签名,签名算法见 电商服务商接口验证签名
type true int 主营类目ID
cate_id true int 三级类目ID
goods_id true int 商品ID
name true string 商品名称
ys_delivery false string 发货地(医美商品不需要传,其他类目需要传)
freight_tpl_id false int 运费模版ID(医美商品不需要传,其他类目需要传)
online_time false datetime 定时上架时间
offline_time false datetime 定时下架时间
sale_time false datetime 开售时间
service true string 服务保证,数组字符串,示例:["7day","quality","compensate"]
images true string 商品图片地址,多张图片用逗号分隔
skus true string SKU信息
content true string 商品详情富文本
apply false string 保存后是否提报,N - 保存不提报、Y - 保存提报,默认为N
medical_body false int 医美身体部位,只有医美类目商品需要传
expiry_type false int 核销限制类型,1 - 时间、2 - 天,只有医美类目商品需要传
expriy_value false string 核销设置值,只有医美类目商品需要传
buy_limit_type false int 商品限购类型,0 - 不限购、1 - 商品累计限购、2 - 规格累计限购
buy_limit_num false int 商品限购数量

注意事项

  • 1、参数 skus 说明,有以下三种情况:
    • 1.1、编辑SKU数据时,参数 skus 数组中需要传入对应的第三方PIN码,示例

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

    • 1.2、新增SKU数据时,参数 skus 数组中不需要传入对应的第三方PIN码,此时系统会认为是新增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库存的操作也会在二次审核通过时统一执行

返回结果

JSON示例

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

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

返回字段说明

返回值字段 字段类型 字段说明
code int 返回状态码,0-正常,其他为异常

其他

相关问题







api评价