v2.bundle_deal.update_bundle_deal

POST /api/v2/bundle_deal/update_bundle_deal

update bundle deal. Relevant restrictions refer to FAQ：https://open.shopee.com/faq/254

Endpoint URL

URL: https://partner.shopeemobile.com/api/v2/bundle_deal/update_bundle_deal

Common Request Parameters

Name	Type	Sample	Description
partner_id	int	1	Partner ID is assigned upon registration is successful. Required for all requests.
timestamp	timestamp	1610000000	This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes.
access_token	string	c09222e3fc40ffb25fc947f738b1abf1	The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours.
shop_id	int	600000	Shopee's unique identifier for a shop. Required param for most APIs.
sign	string	e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2	Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Request Parameters

Name	Type	Required	Sample	Description
rule_type	int32	False	1	The bundle deal rule type：FIX_PRICE = 1 ；DISCOUNT_PERCENTAGE = 2； DISCOUNT_VALUE = 3
discount_value	float	False	11.0	The deducted price when when buying a bundle deal. Need to input it when the bundle deal rule type is 3
fix_price	float	False	11.0	The amount of the buyer needs to spend to purchase a bundle deal.Need to input it when the bundle deal rule type is 1
discount_percentage	int32	False	33	The discount that the buyer can get when buying a bundle deal. Need to input it when the bundle deal rule type is 2
min_amount	int32	False	123	The quantity of items that need buyer to combine purchased
start_time	timestamp	False	1655654412	The time when bundle deal activity start.The start time must be later than current time.
end_time	timestamp	False	1658246412	The time when bundle deal activity end. The end time must be later than current time.
name	string	False	bundle name	Title of the bundle deal
purchase_limit	int32	False	3	Maximum number of bundle deals that can be bought by a buyer.
bundle_deal_id	int32	True	6833	Shopee's unique identifier for a bundle deal activity.
additional_tiers	object	False		Use to create tiered discount for bundle deals, a max of 2 additional tiers are allowed to create bundle deals like buy 2 get 10% off, buy 3 for 15% off, buy 4 for 20% off; For each tier, we will need to set the following 4 values based on bundle deal type +    min_amount = IntAttribute() +    fix_price = IntAttribute() +    discount_percentage = IntAttribute() +    discount_value = IntAttribute()Note: for additional tiers, the fix price, discount_percentage, discount_value should be consistent with tier 1
min_amount	int32	True	100	The quantity of items that the buyers need to purchase for additional tier
fix_price	float	False	100.00	The bundle price when the buyers purchase a bundle deal for additional tiers. Need to input it when the bundle deal rule type is 1.
discount_value	float	False	20.00	The bundle deal discount amount the buyer can save when purchasing a bundle deal. Need to input it when the bundle deal rule type is 3
discount_percentage	int32	False	20	The bundle deal discount% that the buyer can get when buying a bundle deal for additional tiers. Need to input it when the bundle deal rule type is 2

Response Parameters

Name	Type	Sample	Description
error	string		Error code
message	string		The description of error code
request_id	string	2cda1f9c9b44449aedbc11dwer3ced242	The identifier of the API request for error tracking
response	object
bundle_deal_id	int32	6833	Shopee's unique identifier for a bundle deal activity.
name	string	bundle name	Title of the bundle deal
start_time	timestamp	1655654412	The time when bundle deal activity start.
end_time	timestamp	1658246412	The time when bundle deal activity end.
bundle_deal_rule	object
rule_type	int32	1	The bundle deal rule type：FIX_PRICE = 1 ；DISCOUNT_PERCENTAGE = 2； DISCOUNT_VALUE = 3
discount_value	float	11.0	The deducted price when when buying a bundle deal. Need to input it when the bundle deal rule type is 3
fix_price	float	11.0	The amount of the buyer needs to spend to purchase a bundle deal. Need to input it when the bundle deal rule type is 1
discount_percentage	int32	33	The discount that the buyer can get when buying a bundle deal. Need to input it when the bundle deal rule type is 2
min_amount	int32	123	The quantity of items that need buyer to combine purchased
additional_tiers	object[]		Use to create tiered discount for bundle deals, a max of 2 additional tiers are allowed to create bundle deals like buy 2 get 10% off, buy 3 for 15% off, buy 4 for 20% off; For each tier, we will need to set the following 4 values based on bundle deal type +    min_amount = IntAttribute() +    fix_price = IntAttribute() +    discount_percentage = IntAttribute() +    discount_value = IntAttribute()Note: for additional tiers, the fix price, discount_percentage, discount_value should be consistent with tier 1
min_amount	int32	123	The quantity of items that the buyers need to purchase for additional tier
fix_price	float	11.0	The bundle price when the buyers purchase a bundle deal for additional tiers. Need to input it when the bundle deal rule type is 1.
discount_value	float	11.0	The bundle deal discount amount the buyer can save when purchasing a bundle deal. Need to input it when the bundle deal rule type is 3
discount_percentage	int32	33	The bundle deal discount% that the buyer can get when buying a bundle deal for additional tiers. Need to input it when the bundle deal rule type is 2
purchase_limit	int32	3	Maximum number of bundle deals that can be bought by a buyer.