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

# 获取橱窗商品详情

# 接口说明

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

# 注意事项

关于橱窗商品ID的说明

不支持带货中心来源的商品，其余商品的橱窗商品ID与商品来源处的平台内部商品ID相同，对应关系如下:

商品来源	橱窗ID说明
视频号小店	视频号小店商品的 product_id 字段
交易组件	组件商品的 product_id 字段

# 接口调用请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
product_id	string(uint64)	是	橱窗商品ID
appid	string	是	商品来源店铺的appid

# 请求参数示例

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

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
product	Object(Product)	橱窗商品详情，结构体详情请参考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,
        "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": "我的小店",
        "product_recommend_wording": "自定义的推荐语",
        "is_hide_for_window": 0,
        "banned": false,
        "limit_discount_info": {
            "is_effect": true,
            "discount_price": 1300,
            "end_time_ms": 1666086005500,
            "stock": 10
        }
    }
}

# 错误码

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

# 结构体

# Product

橱窗商品详情

参数	类型	描述
product_id	string(uint64)	橱窗商品ID
out_product_id	string	商家侧外部商品ID
title	string	商品标题
img_url	string	商品头图url
third_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	抢购剩余库存

# 枚举值

status

# 商品状态

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

# banned_details.reason

禁售原因

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

# branch_info.branch_status

分店状态

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