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

Combined Listing: Merge into Variants and API Integration Updates

TikTok Shop 官方资料 · TikTok Shop Partner Center 开发者文档 · 适合开发者

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

来自 TikTok Shop 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
TikTok Shop / profile.tiktok.docs_api
语言
en-US
发布版本
cn-20260919-1
标签
zhuge/sourceplatform/tiktok_shopaudience/developercategory/api_docdomain/producttopic/compliancetopic/developer

资料正文

§1 Combined Listing: Merge into Variants and API Integration Updates

Combined Listing now supports Merge into Variants, allowing sellers to consolidate same-style products listed under separate links into one main product detail page. New sales and reviews generated through the main listing are aggregated under the main product. Historical sales and reviews are not fully transferred, and orders placed through the original child listings continue to contribute to those child products. Feature guide This feature uses the existing virtual bundle response structure. ISVs should review how they map main listing SKUs to original child SKUs. Merged child products receive newly generated SKUs under the main product, while their original SKU IDs are returned in the component SKU fields:

APIMain listing SKU IDOriginal child SKU ID
Get Productdata.skus[].iddata.skus[].combined_skus[].sku_id
Get Order Detaildata.orders[].line_items[].sku_iddata.orders[].line_items[].combined_listing_skus[].sku_id

ISVs should use Get Product to synchronize SKU mappings and read combined_listing_skus in Get Order Detail to identify the original product_id, sku_id, seller_sku, and component quantity (sku_count) for fulfillment. Integrations that rely solely on the order line’s sku_id to identify the original child SKU require adaptation. Validate SKU mapping, order synchronization, and fulfillment before supporting merged listings. The following seller and product restrictions apply:

  • Seller availability: This announcement applies to US sellers with the feature enabled. Availability is subject to the feature being accessible in Seller Center.
  • Brand and category: Select at least two same-style products from the same brand and the same leaf category.
  • Product types: Only regular products are supported. Flash sale products, auction products, and certain special distribution, GPR, or POP scenario products are excluded. Eligibility is determined by the validation shown in Seller Center.
  • Existing relationships and SKU limits: Products must not already belong to another active product combination or combined listing relationship. Remove any existing relationship first. The total SKU count across selected products must remain within the platform limit. Full eligibility rules

Sellers can configure the feature in Seller Center → Manage Products → Combined Listing → Merge into Variants. Prices and inventory for SKUs linked to child products are synchronized from the original child SKUs; updates should be made to those original child products. Setup guide

#

变化记录

相对上一发布版本,本文内容有变化。

本版没有改过这篇(或它是新增页),没有可比的上一版。

对照官方原文 ↗