# 免审更新货品
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:updatesupplyproductauditfree
请求方式:POST
针对已上架的货品,通过本接口可以进行免审核更新,接口只更新线上版本的数据,不影响编辑中的草稿数据。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/supplier/product/auditfree?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
本接口支持第三方平台代供货商调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为:192
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代供货商进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token(供货商)、authorizer_access_token(服务商代调用) |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 | 枚举 |
|---|---|---|---|---|
| product_id | number | 是 | 货品ID | - |
| spu_code | string | 否 | 货品编码 | - |
| skus | objarray | 是 | 需要进行更新的sku | - |
| express_info | object | 否 | 运费信息 | - |
| extra_service | object | 否 | 额外服务 | - |
| deliver_method | number | 否 | 发货方式:0-快递发货(默认),1-无需快递 | 枚举值 |
| after_sale_info | object | 否 | 售后/退货地址 | - |
# Body.skus(Array) Object Payload
需要进行更新的sku
| 参数名 | 类型 | 必填 | 说明 | 枚举 |
|---|---|---|---|---|
| sku_id | number | 是 | 更新时必填sku_id | - |
| sku_code | string | 否 | sku编码 | - |
| stock_diff | object | 否 | 库存增减信息 | - |
| price_info | object | 否 | 价格信息 | - |
| is_delete | number | 否 | 是否要删除当前sku | - |
| status | number | 否 | 更新sku状态 | 枚举值 |
# Body.express_info Object Payload
运费信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| template_id | number | 否 | 运费模板ID |
| weight | number | 否 | 货品重量,单位克 |
# Body.extra_service Object Payload
额外服务
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| seven_day_return | number | 否 | 是否支持七天无理由退货。0-不支持,1-支持,2-支持(定制商品除外),3-支持(使用后不支持) |
# Body.after_sale_info Object Payload
售后/退货地址
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| after_sale_address_id | number | 否 | 售后/退货地址id |
# Body.skus(Array).stock_diff Object Payload
库存增减信息
| 参数名 | 类型 | 必填 | 说明 | 枚举 |
|---|---|---|---|---|
| diff_type | number | 否 | 修改类型。1:增加;2:减少;3:设置 | 枚举值 |
| num | number | 否 | 增加、减少或者设置的库存值 | - |
# Body.skus(Array).price_info Object Payload
价格信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cost_price | number | 否 | 成本价(分) |
| suggest_retail_price | number | 否 | 建议零售价(分) |
| lowest_retail_price | number | 否 | 最低零售价(分) |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
# 4. 枚举信息
# Body.deliver_method Enum
发货方式:0-快递发货(默认),1-无需快递
| 枚举值 | 描述 |
|---|---|
| 0 | 快递发货(默认) |
| 1 | 无需快递 |
# Body.skus(Array).status Enum
更新sku状态
| 枚举值 | 描述 |
|---|---|
| 0 | 默认值 |
| 5 | 上架 |
| 11 | 下架 |
# Body.skus(Array).stock_diff.diff_type Enum
修改类型。1:增加;2:减少;3:设置
| 枚举值 | 描述 |
|---|---|
| 1 | 增加 |
| 2 | 减少 |
| 3 | 设置 |
# 5. 注意事项
- 审核中的货品不支持免审更新,需要先等待审核完成或者主动取消审核。
- 接口对传入的字段进行覆盖更新,对缺省字段不做处理。如果需要删除某个字段的内容,需要显式指定字段名,并带上空的value。
# 6. 代码示例
请求示例
{
"product_id": 12345466,
"skus": [
{
"sku_id": 1234565,
"sku_code": "SKU_1",
"price_info": {
"cost_price": 500,
"suggest_retail_price": 1000,
"lowest_retail_price": 800
},
"stock_diff": {
"diff_type": 1,
"num": 50
}
},
{
"sku_id": 1234557,
"is_delete": 1
}
],
"spu_code": "SPU_123",
"deliver_method": 0
}
返回示例
{
"errcode": 0,
"errmsg": "ok"
}
# 7. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 10020051 | 参数错误 | 按文档传参 |
| 10020065 | 货品未上架或不存在 | 确认货品已上架 |
| 10020083 | 该货品所需类目保证金高于当前保证金余额 | 前往补缴保证金 |
| 10020110 | 货品信息检查不通过 | 检查参数 |
| 10020246 | 0元保证金试运营商品数超出限制 | 上架中与审核中商品总数不得超过100个 |
# 8. 适用范围
本接口支持「小店供货商」账号类型调用。其他账号类型如无特殊说明,均不可调用。