Virtual bundles are now available in order details

资料正文

§1 What is changing?

Virtual bundles is a TikTok Shop seller enablement initiative which allows sellers to create a new ProductID (new SKU) by adding multiple existing SKUs and allowing them to share the inventory in real-time. Sellers can set prices for the new SKUs different from the sums of the added SKUs. The new SKUs will become independent new products for shoppers to explore and purchase. A new product_id and sku_id is created when generating a virtual bundle product. From a buyer's perspective in TikTok Shop, it is browsed and purchased as a single product. After a virtual bundle is created, the seller can add or remove the "child" products to the virtual bundle, and the product_id and sku_id will not change. This change will allow sellers to use API to map orders that have virtual bundles to be synced back to their systems for fulfillment. The virtual bundle has to be created in Seller Center and is not possible to be created via the API. Only the GET Order Detail (and not GET Order List) will return information about virtual bundles.

§2 Which markets are affected?

This change is for all markets and all sellers.

§3 Who is affected?

All developers who build connects, multi-channel apps and shipping / fulfillment apps are affected by this change.

§4 Which version is applicable?

This change is applicable to v202309

§5 What action is required?

Please adopt the new combined_listing_sku object present in the Get Order Detail API to enable sellers to fulfill bundles that have been sold on TikTok Shop.

§6 Get Order Detail

Get Order Detail

§7 Parameters

Parameters

No change

§8 Responses

Responses

A new combined_listing_sku object added to the line_item property, indicating the "child" products/SKUs that compose the virtual bundle.

Properties					Type	Sample	Properties description
data
└				orders	[]object		order information
└	└			id	string	576461413038785752	Tiktok shop order id
└	└			line_items	[]object		Line item info list
└	└	└		id	string	577086512123755123	Line item ID
└	└	└		product_name	string	Wellgard Collagen & ACV Gummies Bundle	Product name
└	└	└		product_id	string	1729582718312380123	Product ID
└	└	└		sku_id	string	2729382476852921560	Sku id
└	└	└		combined_listing_skus	[]object		For a virtual bundle SKU, returns an array of related product SKUs that compose the virtual bundle SKU
└	└	└	└	sku_id	string	2729382476852921123	The original sku_id related to the virtual bundle SKU
└	└	└	└	sku_count	int	1	The quantity of original SKUs that compose the virtual bundle SKU
└	└	└	└	product_id	string	1729582718312380456	The original product_id related to the virtual bundle SKU

For example, a virtual bundle that contains two SKUs will have two elements in the array:

Image