status 、 edit_status 等字段新增枚举值,更新 status 、 edit_status 等字段描述接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:getsupplyproduct
请求方式:POST
可通过指定货品ID获取货品具体信息
POST https://api.weixin.qq.com/channels/ec/supplier/product/get?access_token=ACCESS_TOKEN
本接口支持第三方平台代供货商调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为:192
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代供货商进行调用,具体可查看 第三方调用 说明文档。
Query String Parameters| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token(供货商)、authorizer_access_token(服务商代调用) |
Request Payload| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product_id | string | 是 | 货品ID |
| data_type | number | 否 | 默认取1 1:获取线上数据 2:获取草稿数据 3:同时获取线上和草稿数据(注意:上架过的货品才有线上数据) |
Response Payload| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| product | object | 货品线上数据,入参data_type==2时不返回该字段;入参data_type==3且货品从未上架过,不返回该字段 |
| edit_product | object | 货品草稿数据(结构同product),入参data_type==1时不返回该字段 |
Object Payload货品线上数据,入参data_type==2时不返回该字段;入参data_type==3且货品从未上架过,不返回该字段
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| product_id | number | 货品ID | - |
| out_product_id | string | 商家自定义货品ID | - |
| title | string | 标题 | - |
| short_title | string | 短标题 | - |
| aftersale_desc | string | 售后描述 | - |
| head_imgs | array | 主图 | - |
| head_videos | objarray | 视频头图 | - |
| desc_info | object | 货品详情 | - |
| deliver_method | number | 发货方式 | - |
| express_info | object | 运费信息 | - |
| extra_service | object | 额外服务 | - |
| status | number | 货品状态 | 枚举值 |
| edit_status | number | 草稿状态 | 枚举值 |
| cats | objarray | 类目 | - |
| attrs | objarray | 参数属性 | - |
| spu_code | string | 货品编码 | - |
| brand_id | number | 品牌ID | - |
| product_qua_infos | objarray | 货品资质信息 | - |
| skus | objarray | sku信息 | - |
| after_sale_info | object | 售后信息 | - |
| size_chart | object | 尺码表信息 | - |
| edit_time | number | 编辑时间 | - |
| total_sold_num | number | 销量 | - |
Object Payload货品草稿数据(结构同product),入参data_type==1时不返回该字段
| 参数名 | 类型 | 说明 |
|---|---|---|
| product_id | number | 货品ID |
| out_product_id | string | 商家自定义货品ID |
| title | string | 标题 |
| short_title | string | 短标题 |
| aftersale_desc | string | 售后描述 |
| head_imgs | array | 主图 |
| head_videos | objarray | 视频头图 |
| desc_info | object | 货品详情 |
| deliver_method | number | 发货方式 |
| express_info | object | 运费信息 |
| extra_service | object | 额外服务 |
| status | number | 状态 |
| edit_status | number | 草稿状态 |
| cats | objarray | 类目 |
| attrs | objarray | 参数属性 |
| spu_code | string | 货品编码 |
| brand_id | number | 品牌ID |
| product_qua_infos | objarray | 货品资质信息 |
| skus | objarray | sku信息 |
| after_sale_info | object | 售后信息 |
| size_chart | object | 尺码表信息 |
| edit_time | number | 编辑时间 |
| total_sold_num | number | 销量 |
Object Payload视频头图
| 参数名 | 类型 | 说明 |
|---|---|---|
| video_url | string | 视频url |
Object Payload货品详情
| 参数名 | 类型 | 说明 |
|---|---|---|
| imgs | array | 详情图片 |
| desc | string | 详情文本 |
Object Payload运费信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| template_id | string | 运费模板ID |
| weight | number | 重量(克) |
Object Payload额外服务
| 参数名 | 类型 | 说明 |
|---|---|---|
| seven_day_return | number | 七天无理由退货 |
Object Payload类目
| 参数名 | 类型 | 说明 |
|---|---|---|
| cat_id | number | 类目ID |
Object Payload参数属性
| 参数名 | 类型 | 说明 |
|---|---|---|
| attr_key | string | 属性键 |
| attr_value | string | 属性值 |
Object Payload货品资质信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| qua_id | number | 资质ID |
| qua_url | array | 资质图片url列表 |
Object Payloadsku信息
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| sku_id | number | skuID | - |
| out_sku_id | string | 商家自定义skuID | - |
| thumb_img | string | sku小图 | - |
| price_info | object | 价格信息 | - |
| stock_num | number | 库存 | - |
| sku_code | string | sku编码 | - |
| bar_code | string | 条形码 | - |
| sku_attrs | objarray | sku属性 | - |
| status | number | 状态 | 枚举值 |
Object Payload价格信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| cost_price | number | 成本价(分) |
| suggest_retail_price | number | 建议零售价(分) |
| lowest_retail_price | number | 最低零售价(分) |
Object Payloadsku属性
| 参数名 | 类型 | 说明 |
|---|---|---|
| attr_key | string | 键 |
| attr_value | string | 值 |
Object Payload售后信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| after_sale_address_id | string | 售后地址ID |
Object Payload尺码表信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| enable | boolean | 是否启用 |
| specification_list | objarray | 尺码规格列表 |
Object Payload尺码规格列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| name | string | 规格名称 |
| unit | string | 单位 |
| is_range | boolean | 是否区间 |
| value_list | objarray | 规格值映射列表 |
Object Payload规格值映射列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| key | string | 尺码值 |
| value | string | 非区间时的值 |
| left | string | 区间左边界 |
| right | string | 区间右边界 |
Object Payload视频头图
| 参数名 | 类型 | 说明 |
|---|---|---|
| video_url | string | 视频url |
Object Payload货品详情
| 参数名 | 类型 | 说明 |
|---|---|---|
| imgs | array | 详情图片 |
| desc | string | 详情文本 |
Object Payload运费信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| template_id | string | 运费模板ID |
| weight | number | 重量(克) |
Object Payload额外服务
| 参数名 | 类型 | 说明 |
|---|---|---|
| seven_day_return | number | 七天无理由退货 |
Object Payload类目
| 参数名 | 类型 | 说明 |
|---|---|---|
| cat_id | number | 类目ID |
Object Payload参数属性
| 参数名 | 类型 | 说明 |
|---|---|---|
| attr_key | string | 属性键 |
| attr_value | string | 属性值 |
Object Payload货品资质信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| qua_id | number | 资质ID |
| qua_url | array | 资质图片url列表 |
Object Payloadsku信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| sku_id | number | skuID |
| out_sku_id | string | 商家自定义skuID |
| thumb_img | string | sku小图 |
| price_info | object | 价格信息 |
| stock_num | number | 库存 |
| sku_code | string | sku编码 |
| bar_code | string | 条形码 |
| sku_attrs | objarray | sku属性 |
| status | number | 状态 |
Object Payload价格信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| cost_price | number | 成本价(分) |
| suggest_retail_price | number | 建议零售价(分) |
| lowest_retail_price | number | 最低零售价(分) |
Object Payloadsku属性
| 参数名 | 类型 | 说明 |
|---|---|---|
| attr_key | string | 键 |
| attr_value | string | 值 |
Object Payload售后信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| after_sale_address_id | string | 售后地址ID |
Object Payload尺码表信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| enable | boolean | 是否启用 |
| specification_list | objarray | 尺码规格列表 |
Object Payload尺码规格列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| name | string | 规格名称 |
| unit | string | 单位 |
| is_range | boolean | 是否区间 |
| value_list | objarray | 规格值映射列表 |
Object Payload规格值映射列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| key | string | 尺码值 |
| value | string | 非区间时的值 |
| left | string | 区间左边界 |
| right | string | 区间右边界 |
Enum货品状态
| 枚举值 | 描述 |
|---|---|
| 0 | 初始值 |
| 1 | 编辑中 |
| 2 | 审核中 |
| 3 | 审核失败 |
| 4 | 审核成功 |
| 5 | 已上架 |
| 6 | 回收站 |
| 7 | 货品异步提交,上传中 |
| 8 | 货品异步提交,上传失败 |
| 9 | 彻底删除,货品无法再进行任何操作 |
| 10 | 冻结, 审核通过但是不能上架 |
| 11 | 自主下架 |
| 13 | 违规下架/风控系统下架 |
| 20 | 货品被封禁 |
Enum草稿状态
| 枚举值 | 描述 |
|---|---|
| 0 | 初始值 |
| 1 | 编辑中 |
| 2 | 审核中 |
| 3 | 审核失败 |
| 4 | 审核成功 |
| 5 | 已上架 |
| 6 | 回收站 |
| 7 | 货品异步提交,上传中 |
| 8 | 货品异步提交,上传失败 |
| 9 | 彻底删除,货品无法再进行任何操作 |
| 10 | 冻结, 审核通过但是不能上架 |
| 11 | 自主下架 |
| 13 | 违规下架/风控系统下架 |
| 20 | 货品被封禁 |
Enum状态
| 枚举值 | 描述 |
|---|---|
| 0 | 默认值 |
| 5 | 已上架 |
| 11 | 已下架 |
请求示例
{
"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
}
}
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 10020050 | 无权限调用该api | 请获取权限后再试 |
| 10020051 | 参数有误 | 请按照文档要求传参 |
| 10020052 | 货品不存在 | 确认货品ID正确 |
| 10020065 | 货品未上架 |
本接口支持「小店供货商」账号类型调用。其他账号类型如无特殊说明,均不可调用。
status 、 edit_status 等字段新增枚举值,更新 status 、 edit_status 等字段描述