商品券可核销时间规则说明(coupon_available_period)

更新时间:2025.11.24

注意

创建投放计划时,投放计划的开始、结束时间会对商品券可核销时间(coupon_available_period)的相关字段进行校验,详细规则请查阅投放时间字段说明

一、概述

商品券信息中,coupon_available_period下的各个子参数共同构建了商品券的可核销时间规则,具体可核销时间为各个子参数设置的交集时间,商户在创券、发券时,需计算好商品券可核销的时间范围。

字段

功能

注意事项

available_begin_time

设置商品券批次的开始时间

批次开始和结束时间的间隔不能超过一年

available_end_time

设置商品券批次的结束时间

批次开始和结束时间的间隔不能超过一年

wait_days_after_receive

设置商品券领券后需等待生效的天数

1、批次开始时间前领券,计时从批次生效的第一天开始计算。批次有效期内领券,计时从用户领券当天开始计算

2、wait_days_after_receive需要与available_days一起使用

available_days

设置商品券生效后可使用的天数

1、生效后可使用的天数范围若超过批次结束时间,则券的有效期截止到批次结束时间。

2、available_days可单独使用,也可以与wait_days_after_receive一起使用。

weekly_available_period

设置商品券每周可生效的时间段

1、weekly_available_period.day_list可单独使用,而weekly_available_period.day_period_list需要与weekly_available_period.day_list一起使用

2、时间段的开始时间、结束时间必须同时设置,填写多个时间段时,不同区间请勿重叠

irregular_available_period_list

自定义设置商品券可生效的时间段

时间段的开始时间、结束时间必须同时设置,填写多个时间段时,不同区间请勿重叠

二、常见场景组合说明

场景

所需字段

参数设置举例

说明

在批次有效期内,用户可以在任意时间点使用券。

available_begin_time
available_end_time

"coupon_available_period" : {
    "available_begin_time" : "2025-08-04T08:00:00+08:00",
    "available_end_time" : "2025-08-13T08:00:00+08:00"
}

用户领券之后在批次有效期(2025年8月4日8点到2025年8月13日8点)的任意时间点都可以使用。

在批次有效期内,用户领券后立即可用,且券有效期是N天。

available_begin_time
available_end_time
available_days

"coupon_available_period" : {
    "available_begin_time" : "2025-08-04T08:00:00+08:00",
    "available_end_time" : "2025-08-13T08:00:00+08:00",
    "available_days" : "3"
}

用户领券之后3天内在批次有效期(2025年8月4日8点到2025年8月13日8点)的任意时间点都可以使用。

在批次有效期内,用户领券后需要等待N天才可以用券,且券有效期是N天。

available_begin_time
available_end_time
available_days
wait_days_after_receive

"coupon_available_period" : {
    "available_begin_time" : "2025-08-04T08:00:00+08:00",
    "available_end_time" : "2025-08-13T08:00:00+08:00",
    "available_days" : "3",
    "wait_days_after_receive":"2"
}

用户领券之后需要等待2天才可以使用券,当券可以使用时,用户可在3天内在批次有效期(2025年8月4日8点到2025年8月13日8点)的任意时间点可以使用。

在批次有效期内,每周设定的星期可以用券。

available_begin_time
available_end_time
weekly_available_period 

"coupon_available_period" : {
    "available_begin_time" : "2025-08-04T08:00:00+08:00",
    "available_end_time" : "2025-08-13T08:00:00+08:00",
    "weekly_available_period" : {
        "day_list" : ["MONDAY", "FRIDAY"],
    }
}

用户领券之后在批次有效期内(2025年8月4日8点到2025年8月13日8点),每个周一、周五全天的任意时间点可以使用。

在批次有效期内,每周设定的星期以及对应时间段可以用券。

available_begin_time
available_end_time
weekly_available_period 

"coupon_available_period" : {
    "available_begin_time" : "2025-08-04T08:00:00+08:00",
    "available_end_time" : "2025-08-13T08:00:00+08:00",
    "weekly_available_period" : {
        "day_list" : ["MONDAY", "FRIDAY"],
        "day_period_list" : [{
            "begin_time" : "08:00:00",
            "end_time" : "10:00:00"
        }]
    }
}

用户领券之后在批次有效期内(2025年8月4日8点到2025年8月13日8点),每个周一、周五的8点到10点之间的任意时间点可以使用。

在批次有效期内,指定可以用券的时间段。

available_begin_time
available_end_time
irregular_available_period_list 

"coupon_available_period" : {
    "available_begin_time" : "2025-08-04T08:00:00+08:00",
    "available_end_time" : "2025-08-13T08:00:00+08:00",
    "irregular_available_period_list" : [
        {
            "begin_time" : "2025-08-04T08:00:00+08:00",
            "end_time" : "2025-08-06T08:00:00+08:00"
        },
        {
            "begin_time" : "2025-08-10T08:00:00+08:00",
            "end_time" : "2025-08-13T08:00:00+08:00"
        }
    ]
}

用户领券之后在批次有效期内(2025年8月4日8点到2025年8月13日8点),指定的2025年8月4日8点到2025年8月6日8点、2025年8月10日8点到2025年8月13日8点之间的任意时间点可以使用。

以上场景仅作为示例参考,商户可结合自身实际需求进行字段的组合。

 

 

元宝AI
反馈
目录
置顶