获取赠品 | 微信开放文档

# 获取赠品

# 接口说明

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

# 接口调用请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
product_id	string(uint64)	是	商品ID
data_type	number	否	默认取1 1:获取线上数据 2:获取草稿数据 3:同时获取线上和草稿数据（注意：上架过的商品才有线上数据）

# 请求参数示例

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

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
product	Objct(Product)	赠品线上数据，入参data_type==2时不返回该字段；入参data_type==3且赠品从未上架过，不返回该字段，具体参数内容可参考：结构体product
edit_product	Objct(Product)	赠品草稿数据，入参data_type==1时不返回该字段

# 返回参数示例

{
    "product_id": "1700000000000",
    "title": "宠物玩具5",
    "head_imgs": [
        "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ"
    ],
    "desc_info": {
        "imgs": [
            "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ"
        ],
        "desc": "物美价廉"
    },
    "cats_v2": [
        {
            "cat_id": "10000026"
        },
        {
            "cat_id": "10000032"
        },
        {
            "cat_id": "1246"
        }
    ],
    "attrs": [
        {
            "attr_key": "产品净重（kg）",
            "attr_value": "1"
        }
    ],
    "skus": [
        {
            "sku_id": "462966903",
            "sale_price": 100,
            "stock_diff": {
                "diff_type": 1,
                "num": 1,
            }
        }
    ],
    "spu_code": "SPU_CODE_XXX",
    "brand_id": "2100000000"
}

# 错误码

错误码	错误描述
公共错误码	-
10020050	无权限调用该api，请获取权限后再试
10020051	参数有误，请按照文档要求传参
10020052	商品不存在
10020065	商品未上架
10020207	该类型的商品无法获取草稿数据

# 结构体

# product

商品线上数据

参数	类型	描述
product_id	string(uint64)	小店内部赠品ID
out_product_id	string	外部平台自定义赠品ID。如果添加时没录入，回包可能不包含该字段
title	string	标题
head_imgs	string array	主图,多张,列表,最多9张,每张不超过2MB
desc_info.imgs	string array	赠品详情图片(最多20张)。如果添加时没录入，回包可能不包含该字段
desc_info.desc	string	赠品详情文字。如果添加时没录入，回包可能不包含该字段
status	number	赠品线上状态，edit_product和product都会返回该字段
edit_status	number	赠品草稿状态，以edit_product字段返回的值为准，product不返回，枚举值状态可参考：edit_status ，在售赠品没有草稿
cats_v2[].cat_id	string(uint64)	新类目树--商家需要先申请可使用类目
attrs[].attr_key	string	属性键key（属性自定义用）。如果添加时没录入，回包可能不包含该字段
attrs[].attr_value	string	属性值（属性自定义用）。如果添加时没录入，回包可能不包含该字段，参数规则如下： ● 当获取类目信息接口中返回的type：为 select_many， attr_value的格式：多个选项用分号;隔开示例：某赠品的适用人群属性，选择了：青年、中年，则 attr_value的值为：青年;中年 ● 当获取类目信息接口中返回的type：为 integer_unit/decimal4_unit attr_value格式：数值单位，用单个空格隔开示例：某赠品的重量属性，要求integer_unit属性类型，数值部分为 18，单位选择为kg，则 attr_value的值为：18 kg ● 当获取类目信息接口中返回的type：为 integer/decimal4 attr_value 的格式：字符串形式的数字
spu_code	string	商家自定义的赠品编码
brand_id	string(uint64)	品牌id，无品牌为“2100000000”
skus[].sku_id	string(uint64)	skuID
skus[].out_sku_id	string	外部平台自定义skuID。如果添加时没录入，回包可能不包含该字段
skus[].sale_price	number	售卖价格，以分为单位
skus[].stock_num	number	sku库存
skus[].sku_code	string	商家自定义的sku编码。如果添加时没录入，回包可能不包含该字段
skus[].status	number	sku状态
product_type	number	赠品类型。4: 在售赠品，5: 非卖赠品。注意: 在售赠品为只读数据，不支持编辑、下架操作，不支持用data_type=2的参数获取。
edit_time	number	赠品草稿最近一次修改时间
src_product_id	number	在售赠品的来源商品id，非卖赠品没有该字段

# 枚举值

# edit_status

商品草稿状态

枚举值	描述
0	初始值
1	编辑中
2	审核中
3	审核失败
4	审核成功
7	商品异步提交，上传中（处于该状态的商品调用上架商品接口会返回10020067）
8	商品异步提交，上传失败（请重新提交）

# status

商品线上状态

枚举值	描述
0	初始值
5	上架
6	回收站
9	彻底删除，商品无法再进行任何操作
11	自主下架
13	违规下架/风控系统下架
14	保证金不足下架
15	品牌过期下架
20	商品被封禁