快工助手跨境电商知识与商机助手

Rule for Multiple Tier Bundle Deal

Shopee 官方资料 · Shopee Open Platform 常见问题(FAQ) · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.faq
语言
en
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/help_centertopic/apitopic/bundle-dealtopic/developertopic/faqtopic/feature-apis

资料正文

§1 Rule for Multiple Tier Bundle Deal

X1, X2, and X3 will indicate the amount of items that buyers need to purchase to reach the tier 1, tier 2, and tier 3 Bundle Deal criteria, respectively, and get the corresponding discount. (parameter name: "min_amount")

Y1, Y2, and Y3 will indicate the discount values that sellers set for each tier of the same Bundle Deal.

There are 3 different discount types:

  • Fixed Amount Off: get fixed $Y off (parameter name: "discount_value")
  • Percentage Off: get Y% off (parameter name: "discount_percentage")
  • Bundle Price: get a bundle price of $Y (parameter name: "fix_price")

To successfully upload X and Y values, follow the rules outlined below:

  1. Common rules that apply to all discount types: a. Up to 3 tiers at max b. Only one discount type can be applied to one Bundle Deal with multiple tiers c. X3 > X2 > X1 > 1, Y3 > Y2 > Y1 > 0 d. X can't be over 3000

  2. Rules for different discount types:

2.1 For discount types, Fixed Amount Off and Bundle Price, the range limitation of the Y value varies in different regions:

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],

AR: [0.1, 1000000000],

PL: [0.1, 1000000000]

2.2 For Fixed Amount Off, the ratio of Y/X from the higher tier needs to be greater than the lower one: Y3/X3 > Y2/X2 > Y1/X1

For example, the input value doesn't meet the ratio criteria, Y3/X3 > Y2/X2 > Y1/X1, so the call of the "v2.bundle_deal.add_bundle_deal" API or the "v2.bundle_deal.update_bundle_deal" API will fail.

"discount_value": 100,

"min_amount": 2,

"additional_tiers": [

{

"discount_value": 200,

"min_amount": 3

},

{

"discount_value": 250,

"min_amount": 4

}

]

2.3 For Bundle Price, the ratio from Y/X from the higher tier needs to be less than the lower one: Y3/X3 < Y2/X2 < Y1/X1

For example, the input value doesn't meet the ratio criteria, Y3/X3 < Y2/X2 < Y1/X1, so the call of the "v2.bundle_deal.add_bundle_deal" API or the "v2.bundle_deal.update_bundle_deal" API will fail.

{

"rule_type": 1,

"fix_price": 100,

"min_amount": 2,

"additional_tiers": [

{

"fix_price": 200,

"min_amount": 3

},

{

"fix_price": 250,

"min_amount": 4

}

]

}

2.4 For Percentage Off, the Y value from the higher tier needs to be greater than the lower one, meaning Y3 > Y2 > Y1, and Y1 can't be set over 90.

For example, the input value doesn't meet the criteria, Y3 > Y2 > Y1, so the call of the "v2.bundle_deal.add_bundle_deal" API or the "v2.bundle_deal.update_bundle_deal" API will fail.

{

"rule_type": 2,

"discount_percentage": 14,

"min_amount": 2,

"additional_tiers": [

{

"discount_percentage": 13,

"min_amount": 3

},

{

"discount_percentage": 12,

"min_amount": 4

}

]

#