# 免审更新货品

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:updatesupplyproductauditfree

请求方式:POST

针对已上架的货品,通过本接口可以进行免审核更新,接口只更新线上版本的数据,不影响编辑中的草稿数据。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/supplier/product/auditfree?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用。

# 第三方调用

# 2. 请求参数

# 查询参数 Query String Parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token(供货商)、authorizer_access_token(服务商代调用)

# 请求体 Request Payload

参数名类型必填说明枚举
product_idnumber货品ID-
spu_codestring货品编码-
skusobjarray需要进行更新的sku-
express_infoobject运费信息-
extra_serviceobject额外服务-
deliver_methodnumber发货方式:0-快递发货(默认),1-无需快递枚举值
after_sale_infoobject售后/退货地址-

# Body.skus(Array) Object Payload

需要进行更新的sku

参数名类型必填说明枚举
sku_idnumber更新时必填sku_id-
sku_codestringsku编码-
stock_diffobject库存增减信息-
price_infoobject价格信息-
is_deletenumber是否要删除当前sku-
statusnumber更新sku状态枚举值

# Body.express_info Object Payload

运费信息

参数名类型必填说明
template_idnumber运费模板ID
weightnumber货品重量,单位克

# Body.extra_service Object Payload

额外服务

参数名类型必填说明
seven_day_returnnumber是否支持七天无理由退货。0-不支持,1-支持,2-支持(定制商品除外),3-支持(使用后不支持)

# Body.after_sale_info Object Payload

售后/退货地址

参数名类型必填说明
after_sale_address_idnumber售后/退货地址id

# Body.skus(Array).stock_diff Object Payload

库存增减信息

参数名类型必填说明枚举
diff_typenumber修改类型。1:增加;2:减少;3:设置枚举值
numnumber增加、减少或者设置的库存值-

# Body.skus(Array).price_info Object Payload

价格信息

参数名类型必填说明
cost_pricenumber成本价(分)
suggest_retail_pricenumber建议零售价(分)
lowest_retail_pricenumber最低零售价(分)

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息

# 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货品信息检查不通过检查参数
100202460元保证金试运营商品数超出限制上架中与审核中商品总数不得超过100个

# 8. 适用范围

本接口支持「小店供货商」账号类型调用。其他账号类型如无特殊说明,均不可调用。