获取优惠券详情 | 微信开放文档

# 获取优惠券详情

# 接口说明

通过该接口可获取优惠券详情信息。

# 接口调用请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
coupon_id	string	是	优惠券id

# 请求参数示例

{
    "coupon_id": "12639900"
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
coupon.coupon_id	string	优惠券ID
coupon.type	number	优惠券类型，枚举值详情请参考type
coupon.status	number	优惠券状态
coupon.create_time	number	优惠券创建时间
coupon.update_time	number	优惠券更新时间
coupon.coupon_info.name	string	优惠券名称
coupon.coupon_info.valid_info.valid_type	number	优惠券有效期类型，枚举值详情请参考valid_type
coupon.coupon_info.valid_info.valid_day_num	number	优惠券有效天数，valid_type=2时才有意义
coupon.coupon_info.valid_info.start_time	number	优惠券有效期开始时间，valid_type=1时才有意义
coupon.coupon_info.valid_info.end_time	number	优惠券有效期结束时间，valid_type=1时才有意义
coupon.coupon_info.promote_info.promote_type	number	推广类型，枚举值详情请参考promote_type
coupon.stock_info.issued_num	number	优惠券剩余量
coupon.stock_info.receive_num	number	优惠券领用但未使用量
coupon.stock_info.used_num	number	优惠券已用量
coupon.coupon_info.discount_info.discount_num	number	优惠券折扣数 * 1000, 例如 5.1折-> 5100
coupon.coupon_info.discount_info.discount_fee	number	优惠券减少金额, 单位分, 例如0.5元-> 50
coupon.coupon_info.discount_info.discount_condition.product_cnt	number	优惠券使用条件, 满 x 件商品可用
coupon.coupon_info.discount_info.discount_condition.product_price	number	优惠券使用条件, 价格满 x 可用，单位分
coupon.coupon_info.discount_info.discount_condition.product_ids[]	string array	优惠券使用条件, 指定商品 id 可用
coupon.coupon_info.ext_info.invalid_time	number	优惠券失效时间
coupon.coupon_info.ext_info.jump_product_id	string	商品折扣券领取后跳转的商品id
coupon.coupon_info.ext_info.notes	string	备注信息
coupon.coupon_info.ext_info.valid_time	number	优惠券有效时间
coupon.coupon_info.receive_info.end_time	number	优惠券领用结束时间
coupon.coupon_info.receive_info.limit_num_one_person	number	单人限领张数
coupon.coupon_info.receive_info.start_time	number	优惠券领用开始时间
coupon.coupon_info.receive_info.total_num	number	优惠券领用总数

# 返回参数示例

{
    "errcode": 0,
    "coupon": {
        "coupon_id": "12639900",
        "type": 103,
        "status": 5,
        "create_time": 1594885385,
        "update_time": 1594886327,
        "coupon_info": {
            "name": "scs",
            "promote_info": {
                "promote_type": 1
            },
            "discount_info": {
                "discount_num": 9900
            },
            "receive_info": {
                "end_time": 1673110742,
                "limit_num_one_person": 1,
                "start_time": 1673110742,
                "total_num": 100
            },
            "valid_info": {
                "valid_type": 1,
                "valid_day_num": 0,
                "start_time": 1594828800,
                "end_time": 1595433600
            }
        },
        "stock_info": {
            "issued_num": 95,
            "receive_num": 3,
            "used_num": 2
        }
    }
}

# 错误码

错误码	错误描述
公共错误码	-
10021037	优惠券不存在

# 枚举值

# type

优惠券类型

枚举值	描述
1	商品条件折扣券
2	商品满减券
3	商品统一折扣券
4	商品直减券
101	店铺条件折扣券
102	店铺满减券
103	店铺统一折扣券
104	店铺直减券

# promote_type

推广类型

枚举字段名	枚举值	描述
PROMOTE_TYPE_SHOP	1	店铺内推广
PROMOTE_TYPE_VIP	9	会员券
PROMOTE_TYPE_VIP_REGISTER	10	会员开卡礼券

# valid_type

优惠券有效期类型

枚举字段名	枚举值	描述
COUPON_VALID_TYPE_TIME	1	商品指定时间区间
COUPON_VALID_TYPE_DAY	2	生效天数