来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
查看技术与溯源信息
- 平台 / profile
- Shopee / profile.shopee.faq
- 语言
- en
- 发布版本
cn-20260909-2- 标签
- zhuge/sourceplatform/shopeeaudience/developercategory/help_centertopic/apitopic/bundle-dealtopic/developertopic/faqtopic/feature-apis
资料正文
§1 Bundle Deal related restrictions
The following restrictions apply to the "v2.bundle_deal.add_bundle_deal" and "v2.bundle_deal.update_bundle_deal" APIs
-
The name character length limit is [1, 25], that is, at least one character and a maximum of 25 characters.
-
"start_time" must be less than "end_time" and greater than the current time.
-
"end_time" must be greater than "start_time" + 1 hour; "end_time" - "start_time" must be less than 6 months (that is, the activity time span cannot exceed 6 months).
-
The legal range of "min_amount" is [2,3000], that is, the minimum is 2 and the maximum is 3000.
-
If "rule_type": 3 is passed in, "discount_value" is required, and the legal range of "discount_value" is as follows (restrictions also apply to multi-layer Bundle Deals):
SG: [0.1, 1000000000],
MY: [0.1, 1000000000],
TH: [1, 1000000000],
TW: [1, 499999],
ID: [99, 1000000000],
VN: [1000, 100000000],
PH: [5, 1000000],
BR: [0.1, 1000000000],
MX: [0.1, 1000000000],
CO: [0.1, 1000000000],
CL: [0.1, 1000000000],
PL: [0.1, 1000000000]
-
If "rule_type": 2 is passed in, "discount_percentage" is required, and the legal range of "discount_percentage" is [1,99]. (Restrictions also apply to multi-tier Bundle Deals)
-
If "rule_type": 1 is passed in, then "fix_price" is required, and the legal range of "fix_price" is as follows (restrictions also apply to multi-tier Bundle Deals):
SG: [0.1, 1000000000],
MY: [0.1, 1000000000],
TH: [1, 1000000000],
TW: [1, 499999],
ID: [99, 1000000000],
VN: [1000, 100000000],
PH: [5, 1000000],
BR: [0.1, 1000000000],
MX: [0.1, 1000000000],
CO: [0.1, 1000000000],
CL: [0.1, 1000000000],
PL: [0.1, 1000000000]
-
The legal range of "purchase_limit" is [1, 999999999].
-
If you want to create multiple bundle sets, you can add up to 3 tiers for one Bundle Deal. The value of "min_amount" of each tier should be greater than the previous tier, and should be within the legal range [2,3000].
-
For the multi-tier Bundle Deal with "rule_type": 1, the value of "fix_price" of each tier must be within the legal range and the higher tier should be grater than the lower one. The same rule applies to the value of "fix_price"/"min_amount" for each tier.
-
For the multi-tier Bundle Deal with "rule_type": 2, the value of "discount_percentage" of each tier must be between 1 and 99, and the higher tier should be grater than the lower one.
-
For the multi-tier Bundle Deal with "rule_type": 3, the value of "discount_value" of each tier must be within the legal range and the higher tier should be grater than the lower one. The same rule applies to the value of "discount_value"/"min_amount" for each tier.
The following restrictions apply to the "v2.bundle_deal.update_bundle_deal" API
| API fields | Scheduled without enabled items | Scheduled with enabled items | Ongoing without enabled items | Ongoing with enabled items | Ended |
| "start_time" | Can edit freely | Cannot start in advance | Cannot edit | Cannot edit | Cannot edit |
| "end_time" | Can edit freely | Cannot end later | Can edit freely | Cannot end later | Cannot edit |
| "additional_tiers" (tier change) | Can edit freely | Can edit freely | Cannot edit | Cannot edit | Cannot edit |
| "min_amount" | Can edit freely | Can edit freely | Cannot edit | Cannot edit | Cannot edit |
| "fix_value"/"discount_percentage"/"discount_value" | Can edit freely | Can edit freely | Cannot edit | Cannot edit | Cannot edit |
| "purchase_limit" | Can edit freely | Can edit freely | Can edit freely | Can edit freely | Cannot edit |