# 获取货品详情

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

接口英文名:getsupplyproduct

请求方式:POST

可通过指定货品ID获取货品具体信息

# 1. 调用方式

# HTTPS 调用

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

# 云调用

  • 本接口不支持云调用。

# 第三方调用

# 2. 请求参数

# 查询参数 Query String Parameters

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

# 请求体 Request Payload

参数名类型必填说明
product_idstring货品ID
data_typenumber默认取1 1:获取线上数据 2:获取草稿数据 3:同时获取线上和草稿数据(注意:上架过的货品才有线上数据)

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
productobject货品线上数据,入参data_type==2时不返回该字段;入参data_type==3且货品从未上架过,不返回该字段
edit_productobject货品草稿数据(结构同product),入参data_type==1时不返回该字段

# Res.product Object Payload

货品线上数据,入参data_type==2时不返回该字段;入参data_type==3且货品从未上架过,不返回该字段

参数名类型说明枚举
product_idnumber货品ID-
out_product_idstring商家自定义货品ID-
titlestring标题-
short_titlestring短标题-
aftersale_descstring售后描述-
head_imgsarray主图-
head_videosobjarray视频头图-
desc_infoobject货品详情-
deliver_methodnumber发货方式-
express_infoobject运费信息-
extra_serviceobject额外服务-
statusnumber货品状态枚举值
edit_statusnumber草稿状态枚举值
catsobjarray类目-
attrsobjarray参数属性-
spu_codestring货品编码-
brand_idnumber品牌ID-
product_qua_infosobjarray货品资质信息-
skusobjarraysku信息-
after_sale_infoobject售后信息-
size_chartobject尺码表信息-
edit_timenumber编辑时间-
total_sold_numnumber销量-

# Res.edit_product Object Payload

货品草稿数据(结构同product),入参data_type==1时不返回该字段

参数名类型说明
product_idnumber货品ID
out_product_idstring商家自定义货品ID
titlestring标题
short_titlestring短标题
aftersale_descstring售后描述
head_imgsarray主图
head_videosobjarray视频头图
desc_infoobject货品详情
deliver_methodnumber发货方式
express_infoobject运费信息
extra_serviceobject额外服务
statusnumber状态
edit_statusnumber草稿状态
catsobjarray类目
attrsobjarray参数属性
spu_codestring货品编码
brand_idnumber品牌ID
product_qua_infosobjarray货品资质信息
skusobjarraysku信息
after_sale_infoobject售后信息
size_chartobject尺码表信息
edit_timenumber编辑时间
total_sold_numnumber销量

# Res.product.head_videos(Array) Object Payload

视频头图

参数名类型说明
video_urlstring视频url

# Res.product.desc_info Object Payload

货品详情

参数名类型说明
imgsarray详情图片
descstring详情文本

# Res.product.express_info Object Payload

运费信息

参数名类型说明
template_idstring运费模板ID
weightnumber重量(克)

# Res.product.extra_service Object Payload

额外服务

参数名类型说明
seven_day_returnnumber七天无理由退货

# Res.product.cats(Array) Object Payload

类目

参数名类型说明
cat_idnumber类目ID

# Res.product.attrs(Array) Object Payload

参数属性

参数名类型说明
attr_keystring属性键
attr_valuestring属性值

# Res.product.product_qua_infos(Array) Object Payload

货品资质信息

参数名类型说明
qua_idnumber资质ID
qua_urlarray资质图片url列表

# Res.product.skus(Array) Object Payload

sku信息

参数名类型说明枚举
sku_idnumberskuID-
out_sku_idstring商家自定义skuID-
thumb_imgstringsku小图-
price_infoobject价格信息-
stock_numnumber库存-
sku_codestringsku编码-
bar_codestring条形码-
sku_attrsobjarraysku属性-
statusnumber状态枚举值

# Res.product.skus(Array).price_info Object Payload

价格信息

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

# Res.product.skus(Array).sku_attrsObject Payload

sku属性

参数名类型说明
attr_keystring
attr_valuestring

# Res.product.after_sale_info Object Payload

售后信息

参数名类型说明
after_sale_address_idstring售后地址ID

# Res.product.size_chart Object Payload

尺码表信息

参数名类型说明
enableboolean是否启用
specification_listobjarray尺码规格列表

# Res.product.size_chart.specification_list(Array) Object Payload

尺码规格列表

参数名类型说明
namestring规格名称
unitstring单位
is_rangeboolean是否区间
value_listobjarray规格值映射列表

# Res.product.size_chart.specification_list(Array).value_listObject Payload

规格值映射列表

参数名类型说明
keystring尺码值
valuestring非区间时的值
leftstring区间左边界
rightstring区间右边界

# Res.edit_product.head_videos(Array) Object Payload

视频头图

参数名类型说明
video_urlstring视频url

# Res.edit_product.desc_info Object Payload

货品详情

参数名类型说明
imgsarray详情图片
descstring详情文本

# Res.edit_product.express_info Object Payload

运费信息

参数名类型说明
template_idstring运费模板ID
weightnumber重量(克)

# Res.edit_product.extra_service Object Payload

额外服务

参数名类型说明
seven_day_returnnumber七天无理由退货

# Res.edit_product.cats(Array) Object Payload

类目

参数名类型说明
cat_idnumber类目ID

# Res.edit_product.attrs(Array) Object Payload

参数属性

参数名类型说明
attr_keystring属性键
attr_valuestring属性值

# Res.edit_product.product_qua_infos(Array) Object Payload

货品资质信息

参数名类型说明
qua_idnumber资质ID
qua_urlarray资质图片url列表

# Res.edit_product.skus(Array) Object Payload

sku信息

参数名类型说明
sku_idnumberskuID
out_sku_idstring商家自定义skuID
thumb_imgstringsku小图
price_infoobject价格信息
stock_numnumber库存
sku_codestringsku编码
bar_codestring条形码
sku_attrsobjarraysku属性
statusnumber状态

# Res.edit_product.skus(Array).price_info Object Payload

价格信息

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

# Res.edit_product.skus(Array).sku_attrsObject Payload

sku属性

参数名类型说明
attr_keystring
attr_valuestring

# Res.edit_product.after_sale_info Object Payload

售后信息

参数名类型说明
after_sale_address_idstring售后地址ID

# Res.edit_product.size_chart Object Payload

尺码表信息

参数名类型说明
enableboolean是否启用
specification_listobjarray尺码规格列表

# Res.edit_product.size_chart.specification_list(Array) Object Payload

尺码规格列表

参数名类型说明
namestring规格名称
unitstring单位
is_rangeboolean是否区间
value_listobjarray规格值映射列表

# Res.edit_product.size_chart.specification_list(Array).value_listObject Payload

规格值映射列表

参数名类型说明
keystring尺码值
valuestring非区间时的值
leftstring区间左边界
rightstring区间右边界

# 4. 枚举信息

# Res.product.status Enum

货品状态

枚举值描述
0初始值
1编辑中
2审核中
3审核失败
4审核成功
5已上架
6回收站
7货品异步提交,上传中
8货品异步提交,上传失败
9彻底删除,货品无法再进行任何操作
10冻结, 审核通过但是不能上架
11自主下架
13违规下架/风控系统下架
20货品被封禁

# Res.product.edit_status Enum

草稿状态

枚举值描述
0初始值
1编辑中
2审核中
3审核失败
4审核成功
5已上架
6回收站
7货品异步提交,上传中
8货品异步提交,上传失败
9彻底删除,货品无法再进行任何操作
10冻结, 审核通过但是不能上架
11自主下架
13违规下架/风控系统下架
20货品被封禁

# Res.product.skus(Array).status Enum

状态

枚举值描述
0默认值
5已上架
11已下架

# 5. 注意事项

  • edit_product的结构与product完全一致,区别仅在于它是草稿版本的数据。
  • 上架过的货品才有线上数据(product字段)。

# 6. 代码示例

请求示例

{
	"product_id": "324545",
	"data_type": 1
}

返回示例

{
	"errcode": 0,
	"errmsg": "ok",
	"product": {
		"product_id": 123456789,
		"title": "示例货品标题",
		"head_imgs": ["https://mmecimage.cn/p/xxx1"],
		"cats": [{"cat_id": 6031},{"cat_id": 6032},{"cat_id": 6033}],
		"status": 5,
		"skus": [{"sku_id": 123456001,"sale_price": 1000,"stock_num": 5}],
		"min_price": 1000
	}
}

# 7. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。

错误码错误描述解决方案
10020050无权限调用该api请获取权限后再试
10020051参数有误请按照文档要求传参
10020052货品不存在确认货品ID正确
10020065货品未上架

# 8. 适用范围

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

接口变更日志(1条)
2026 年 07 月 10 日
statusedit_status 等字段新增枚举值,更新 statusedit_status 等字段描述