商品券结构及修改说明

商品券

券的规则模板，定义优惠核心属性（商品券的基础信息、商品券类型等），不直接发放给用户，只用于批量生成批次。

1个商品券可包含多个批次

【商品券ID】product_coupon_id

批次

从商品券模板生成的一批可发放券，定义更细节的使用规则和发放规则。

“单券”模式通过单个批次向用户发放单张商品券；

“多次优惠”模式由多个批次进行组合，构成批次组，以券组的形式一次发放给用户多张商品券。

1个批次关联1个商品券，1个批次可发放多个用户商品券

【批次ID】stock_id

【批次组ID】stock_bundle_id（"多次优惠"模式才存在）

用户商品券

用户在批次下实际领取到的券即为用户商品券。

“单券”模式下领取的是单个批次下的单张券。

“多次优惠”模式下领取的，则是在批次组下领取一个券组，即批次组下的每个批次里都有一张券发放给用户，用户领取的券组内包含多张券。

1个批次可发放多个用户商品券，1个用户商品券关联1个用户

【用户商品券Code】coupon_code

【用户券组ID】user_coupon_bundle_id（"多次优惠"模式才存在）

【展示信息】display_info

用于设置商品券在客户端页面的展示信息，主要设置内容包含：

• 商品券基础信息：【商品券名称】name

• 图片类信息：【商品券图片】image_url、【商品券背景图】background_url、【商品券详情图列表】detail_image_url_list

• 商品信息：【商品原价】original_price

全场券无需设置商品信息：【适用商品组合】combo_package_list

单品券必须设置商品信息：【适用商品组合】combo_package_list

【使用模式】usage_mode

设置商品券的使用模式，单券取值“SINGLE”

【优惠范围】scope

设置商品券的优惠范围，取值“ALL”

设置商品券的优惠范围，取值“SINGLE”

【商品券类型】type

设置商品券的优惠类型，可设置两种：
-满减券：NORMAL
-折扣券：DISCOUNT

设置商品券的优惠类型，可设置三种：
-满减券：NORMAL
-折扣券：DISCOUNT
-兑换券：EXCHANGE

【单券模式信息】single_usage_info

设置商品券的优惠力度，主要设置内容包含：

• 门槛信息：【门槛金额】threshold

• 减免额度信息：
  -满减券：【固定减免金额】discount_amount
  -折扣券：【固定减免百分比】percent_off

单品券的使用规则与优惠力度在批次信息中设置

【单券使用规则】single_usage_rule

设置商品券的可核销时间，即券的有效期，只有在有效期内用户才能使用券。

可核销时间信息：【券可核销时间】coupon_available_period

全场券的使用规则与优惠力度在商品券信息中设置

设置商品券的优惠力度，主要设置内容包含：

• 门槛信息：【门槛金额】threshold

• 减免额度信息：
  -满减券：【固定减免金额】discount_amount
  -折扣券：【固定减免百分比】percent_off
  -兑换券：【固定兑换价格】exchange_price

【批次】stock

设置批次的发放信息与门店信息，主要设置内容包含：

• 发放信息：【券Code分配模式】coupon_code_mode、【发放规则】stock_send_rule、【事件通知配置】notify_config

• 门店信息：【可用门店范围】store_scope

【券使用规则展示信息】usage_rule_display_info

用于设置商品券在客户端页面的展示券详情信息，主要设置内容包含：

• 券使用方式：【券使用方式列表】coupon_usage_method_list

• 使用券的跳转链接：【小程序跳转路径】mini_program_path、【APP跳转路径】app_path

• 券使用说明：【券使用说明】usage_description

【用户商品券展示信息】coupon_display_info

用于设置用户商品券在卡包中的展示详情，主要设置内容包含：

• 用户商品券展示信息：【用户商品券Code展示模式】code_display_mode、【背景颜色】background_color

• 自定义跳转入口信息：【小程序入口】entrance_mini_program、【公众号入口】entrance_official_account、【视频号入口】entrance_finder

【用户商品券Code】coupon_code

记录用户的领券信息，券code是券的唯一标识

【展示信息】display_info

用于设置商品券在客户端页面的展示信息，主要设置内容包含：

• 商品券基础信息：【商品券名称】name

• 图片类信息：【商品券图片】image_url、【商品券背景图】background_url、【商品券详情图列表】detail_image_url_list

• 商品信息：【商品原价】original_price

全场券无需设置商品信息：【适用商品组合】combo_package_list

单品券必须设置商品信息：【适用商品组合】combo_package_list

【使用模式】usage_mode

设置商品券的使用模式，多次优惠取值“PROGRESSIVE_BUNDLE”

【优惠范围】scope

设置商品券的优惠范围，取值“ALL”

设置商品券的优惠范围，取值“SINGLE”

【商品券类型】type

设置商品券的优惠类型，可设置两种：
-满减券：NORMAL
-折扣券：DISCOUNT

设置商品券的优惠类型，可设置三种：
-满减券：NORMAL
-折扣券：DISCOUNT
-兑换券：EXCHANGE

【多次优惠模式信息】progressive_bundle_usage_info

主要用于设置多次优惠模式的配置信息，主要设置内容包含：

• 次数信息：【可使用次数】count

• 使用间隔信息：【多次优惠使用间隔天数】interval_days

【多次优惠批次组使用规则】progressive_bundle_usage_rule

设置商品券的可核销时间，即券的有效期，只有在有效期内用户才能使用券。

可核销时间信息：【券可核销时间】coupon_available_period

设置商品券的优惠力度，主要设置内容包含：

• 门槛信息：【门槛金额】threshold

• 减免额度信息：
  -满减券：【固定减免金额】discount_amount
  -折扣券：【固定减免百分比】percent_off

设置商品券的优惠力度，主要设置内容包含：

• 门槛信息：【门槛金额】threshold

• 减免额度信息：
  -满减券：【固定减免金额】discount_amount
  -折扣券：【固定减免百分比】percent_off
  -兑换券：【固定兑换价格】exchange_price

【批次组】stock_bundle

设置批次组的发放信息与门店信息，主要设置内容包含：

• 发放信息：【券Code分配模式】coupon_code_mode、【批次组发放规则】stock_send_rule、【事件通知配置】notify_config

• 门店信息：【可用门店范围】store_scope

【券使用规则展示信息】usage_rule_display_info

用于设置商品券在客户端页面的展示券详情信息，主要设置内容包含：

• 券使用方式：【券使用方式列表】coupon_usage_method_list

• 使用券的跳转链接：【小程序跳转路径】mini_program_path、【APP跳转路径】app_path

• 券使用说明：【券使用说明】usage_description

【用户商品券展示信息】coupon_display_info

用于设置用户商品券在卡包中的展示详情，主要设置内容包含：

• 用户商品券展示信息：【用户商品券Code展示模式】code_display_mode、【背景颜色】background_color

• 自定义跳转入口信息：【小程序入口】entrance_mini_program、【公众号入口】entrance_official_account、【视频号入口】entrance_finder

【用户商品券Code】coupon_code

记录用户的领券信息，券code是券的唯一标识

【用户券组信息】user_product_coupon_bundle_info

记录了用户券组信息、券在组内的索引信息，以及使用情况，主要内容包含：

• 券组信息：【用户券组ID】user_coupon_bundle_id

• 组内索引：【用户券组内索引】user_coupon_bundle_index

• 使用情况：【总可使用次数】total_count、【已使用次数】used_count

修改商品券（品牌/服务商）

用于修改商品券信息，可修改字段如下：

【展示信息】display_info：

• 商品券基础信息：【商品券名称】name

• 图片类信息：【商品券图片】image_url、【商品券背景图】background_url、【商品券详情图列表】detail_image_url_list

• 商品信息：【商品原价】original_price、【适用商品组合】combo_package_list

单券模式：修改商品券批次（品牌/服务商）

多次优惠模式：修改商品券批次组（品牌/服务商）

用于修改单券模式的批次信息，可修改字段如下：

1、【券使用规则展示信息】usage_rule_display_info：

• 券使用方式：【券使用方式列表】coupon_usage_method_list

• 使用券的跳转链接：【小程序跳转路径】mini_program_path、【APP跳转路径】app_path

• 券使用说明：【券使用说明】usage_description

2、【用户商品券展示信息】coupon_display_info：

• 用户商品券展示信息：【用户商品券Code展示模式】code_display_mode、【背景颜色】background_color

• 自定义跳转入口信息：【小程序入口】entrance_mini_program、【公众号入口】entrance_official_account、【视频号入口】entrance_finder

3、发放信息：【事件通知配置】notify_config

4、门店信息：【可用门店范围】store_scope

一、“商品券详情”页面的查看路径：

• 已领取的券：“摇优惠”功能-我的-待使用优惠-点击查看具体的券

• 未领取的券：“摇优惠”功能-我的-周边的优惠-点击查看具体的券

二、“商品券详情”页面包含的字段内容：

1、头部图片为【展示信息】display_info中的【商品券图片】image_url、【商品券背景图】background_url。

2、头部展示的商品券优惠信息为【商品券类型】type、【商品券名称】name、

【单券使用规则】single_usage_rule中设置的门槛和优惠力度。
3、“可用门店”的展示情况根据商品券设置的【可用门店范围】store_scope而定，如果展示，点击可用门店后将跳转到【券可用门店信息】coupon_available_store_info中设置的跳转地址。

4、如果是单品券，还会在“详情”区域展示【展示信息】display_info中【适用商品组合】combo_package_list设置的各单品信息。

5、“使用须知”中展示的可用时间为微信侧根据【券可核销时间】coupon_available_period设置的核销时间规则计算出的券有效期；
使用方式为【券使用方式列表】coupon_usage_method_list；
其他说明为【券使用说明】usage_description

6、若用户已领取券，“商品券详情”页面将根据【券使用方式列表】coupon_usage_method_list提供核销入口；
注意：除了“商品券详情”页面能提供核销入口外，商户侧接入核销组件也能实现在商户侧小程序内为用户提供核销入口，核销组件会根据【适用商品组合】combo_package_list的设置展示各单品信息，以及跳转路径。

一、“商品券详情”页面的查看路径：

• 已领取的券：“摇优惠”功能-我的-待使用优惠-点击查看具体的券

• 未领取的券：“摇优惠”功能-我的-周边的优惠-点击查看具体的券

二、“商品券详情”页面包含的字段内容：

1、头部图片为【展示信息】display_info中的【商品券图片】image_url、【商品券背景图】background_url。

2、头部展示的商品券优惠信息为【商品券类型】type、【商品券名称】name，【多次优惠批次组使用规则】progressive_bundle_usage_rule中设置的首次使用的优惠力度，以及微信侧根据【券可核销时间】coupon_available_period设置的核销时间规则计算出的券有效期。
3、“优惠说明”部分的内容为【多次优惠模式信息】progressive_bundle_usage_info中设置的【可使用次数】count，以及【多次优惠批次组使用规则】progressive_bundle_usage_rule中设置的每轮门槛和优惠力度。

4、“可用门店”的展示情况根据商品券设置的【可用门店范围】store_scope而定，如果展示，点击可用门店后将跳转到【券可用门店信息】coupon_available_store_info中设置的跳转地址。

5、如果是单品券，还会在“详情”区域展示【展示信息】display_info中【适用商品组合】combo_package_list设置的各单品信息。

6、“使用须知”中展示的可用时间为微信侧根据【券可核销时间】coupon_available_period设置的核销时间规则计算出的券有效期；
使用方式为【券使用方式列表】coupon_usage_method_list；
其他说明为【券使用说明】usage_description

7、若用户已领取券，“商品券详情”页面将根据【券使用方式列表】coupon_usage_method_list提供核销入口；
注意：除了“商品券详情”页面能提供核销入口外，商户侧接入核销组件也能实现在商户侧小程序内为用户提供核销入口，核销组件会根据【适用商品组合】combo_package_list的设置展示各单品信息，以及跳转路径。

商品券结构

全场券的优惠力度single_usage_info 设置在商品券层

全场券的优惠力度single_usage_info 设置在批次层

没有批次组stock_bundle 结构

有批次组stock_bundle 结构

商户管理商品券

批次的有效期是按单个批次的维度计算的

批次的有效期是按批次组的维度计算的，即批次组下的每个批次的有效期都是统一的，并非单个批次可以单独设置有效期

可失效单个批次

无法失效单个批次与批次组

用户领一次券，微信侧发送一次回调通知给商户

用户领一次券组，微信侧发送券组中第一轮优惠券的回调通知给商户，用户使用第一轮优惠券后，微信侧发送券组中第二轮优惠券信息，以此类推，商户侧会收到多轮回调通知

用户体验

一次领取行为获得一张券

一次领取行为获得一个“券包”(用户券组)，包含多张券

用户只会领取到一张券，因此只展示这一张券的门槛和优惠力度。

因为用户券组包含多张券，因此会展示每张券的门槛和优惠力度。

商品券结构

单券模式下，全场券的优惠力度single_usage_info设置在商品券层

单券模式下，单品券的优惠力度single_usage_info设置在批次层

全场券无需设置商品信息：【适用商品组合】combo_package_list

单品券必须设置商品信息：【适用商品组合】combo_package_list

优惠类型

无法设置“兑换”类型的优惠，仅支持设置“满减”和“折扣”类型

“兑换”、“满减”和“折扣”类型的优惠都支持设置

用户体验

由于全场券无需设置【适用商品组合】，因此查看券详情时，没有“详情”区域用于展示商品列表

由于单品券会设置【适用商品组合】，因此查看券详情时，有“详情”区域用于展示商品列表