获取橱窗商品详情 | 微信开放文档

# 获取橱窗商品详情

# 接口说明

通过该接口可获取橱窗商品详情。

增加 leaf_category_id 字段（与 third_category_id 同级），表示叶子类目（品类）ID，旧的 third_category_id 最终会下掉，请尽快迁移

# 注意事项

关于橱窗商品ID的说明

橱窗商品ID即在视频号助手web端，橱窗列表中展示的商品ID。具体的分为两种情况：

1、对于自营商品，橱窗ID即为小店商品ID，是小店在上传商品的时候，平台给的唯一商品ID，获取方式为小店后台-商品规格，或通过小店商品详情API获取

2、对于带货商品，橱窗ID为货源商品在小店的商品ID。此外带货商品会额外拥有一个带货商品ID，是小店在创建带货计划的时候，平台给的此计划对应的商品ID，获取方式为小店带货商品详情API，或视频号助手商品详情API等

每个带货商品ID唯一对应一个带货商品，而同一个货源商品ID可能对应多个带货商品，具体详见"关于橱窗中的带货商品"部分

关于橱窗中的带货商品

目前接口支持了橱窗中带货商品详情的返回，填写 need_cps_product = true 后，product_id 字段同时支持根据前述两种商品ID查询，不过需要注意的是：

1、若输入小店商品ID，则能够获取此商品的所有带货计划

2、若输入带货商品ID，则只能获取该带货商品的计划

带货商品会被单独返回在 cps_products 列表中，同时返回带货计划的类型

# 接口调用请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
product_id	string(uint64)	是	橱窗商品ID
appid	string	need_cps_product为true时可留空, 否则必填	商品来源店铺的appid
need_cps_product	bool	否	是否查询带货商品

(

# 请求参数示例

{
    "product_id": "100234056",
    "appid": "wxee9f94a3360ad25f",
    "need_cps_product": true
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
product	Object(Product)	橱窗商品详情，结构体详情请参考Product
cps_products	Repeated(Product)	橱窗中的带货商品详情(详见"关于橱窗中的带货商品")

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "product": {
        "product_id": "100234056",
        "out_product_id": "out_100234056",
        "title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
        "img_url": "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ",
        "third_category_id": 6091,
        "leaf_category_id": 6091,
        "status": 1,
        "market_price": 1500,
        "selling_price": 1300,
        "stock": 100,
        "sales": 888,
        "appid": "wxee9f94a3360ad25f",
        "page_path": {
            "appid": "wxee9f94a3360ad25f",
            "half_page_path": "pages/buy/productDetail?productId=2176180",
            "full_page_path": "pages/productDetail/productDetail?productId=2176180"
        },
        "platform_id": 0,
        "platform_name": "我的小店",
        "is_hide_for_window": 0,
        "banned": false,
        "limit_discount_info": {
            "is_effect": true,
            "discount_price": 1300,
            "end_time_ms": 1666086005500,
            "stock": 10
        }
    },
    "cps_products": [
        {
            "product_id": "100234056",
            "out_product_id": "out_100234056",
            "title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
            "img_url": "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ",
            "third_category_id": 6091,
            "leaf_category_id": 6091,
            "status": 1,
            "market_price": 1500,
            "selling_price": 1300,
            "stock": 100,
            "sales": 888,
            "appid": "wxee9f94a3360ad25f",
            "platform_id": 0,
            "platform_name": "我的小店",
            "is_hide_for_window": 0,
            "banned": false,
            "cps_item_type": 1,
            "product_promotion_link": "v1=HAOHK025pGFF8tBx69zbwNpU473uiTNa5MOHrs_Hknqa_-Cjk9IbBHMHeKh5rSnIrQ"
        }
    ]
}

# 错误码

错误码	错误描述
公共错误码	-
48001	接口权限未开启，需前往视频号助手- 开放能力-开放场景打开开关
10022001	验证视频号身份失败, 请检查是否使用视频号橱窗ID请求
10022002	因违规行为, 橱窗被禁止使用, 请前往'带货中心->个人中心->带货权限'检查橱窗带货权限
10022003	橱窗商品未找到
10022007	不支持操作带货中心来源的商品
10022008	请求的appid不属于该视频号的绑定店铺

# 结构体

# Product

橱窗商品详情

参数	类型	描述
product_id	string(uint64)	对于自营商品为橱窗商品ID; 对于带货商品为带货商品ID
out_product_id	string	对于自营商品为商家侧外部商品ID; 对于带货商品则为商品在货源店铺的商品ID
title	string	商品标题
img_url	string	商品头图url
third_category_id	string(uint64)	商品所属三级类目ID
leaf_category_id	string(uint64)	商品所属叶子类目（品类）ID
status	number	商品状态,枚举值详情请参考status
market_price	number	价格区间最大值(单位分) （市场价，原价）
selling_price	number	价格区间最小值(单位分) (销售价)
stock	number	剩余库存
sales	number	销量
appid	string	商品来源店铺的appid(非带货商品才拥有)
page_path.appid	string	商品详情半屏页、全屏页所属appid
page_path.half_page_path	string	商品详情半屏页path
page_path.full_page_path	string	商品详情全屏页path
platform_id	number	商品所属电商平台ID
platform_name	string	商品所属电商平台名
is_hide_for_window	bool	是否在个人橱窗页隐藏
banned	bool	商品是否处于禁止售卖的状态
banned_details.reason	number	禁售原因，枚举值详情请参考banned_details.reason
banned_details.need_apply_category_id	string(uint64)	未申请售卖对应商品类目时带有，需要申请的类目ID
banned_details.need_apply_category_name	string	未申请售卖对应商品类目时带有，需要申请的类目名
branch_info.branch_id	number	分店ID
branch_info.branch_name	string	分店名
branch_info.branch_status	number	分店状态，枚举值详情请参考branch_info.branch_status
limit_discount_info.is_effect	bool	是否有生效中的抢购活动
limit_discount_info.discount_price	number	抢购价
limit_discount_info.end_time_ms	string(uint64)	抢购活动结束时间(毫秒时间戳)
limit_discount_info.stock	number	抢购剩余库存
cps_item_type	number	对于带货商品会返回, 代表所属计划的类型
product_promotion_link	string	用于在小程序跳转小店场景添加商品时传递跟佣信息

# 枚举值

status

# 商品状态

枚举值	描述
1	已上架到橱窗
2	未上架到橱窗
3	已在商品来源处删除

# banned_details.reason

禁售原因

枚举值	描述
0	三级类目在橱窗禁售或商品在来源处被禁售
1	商品属于可申请售卖的类目，但商家未完成申请
2	商品所属分店未处于营业状态

# branch_info.branch_status

分店状态

枚举值	描述
0	营业中
1	停业

# cps_item_type

带货计划类型

枚举值	描述
0	普通计划
1	定向计划
2	专属计划
3	团长计划