stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 App categories
This App Requirement Document (ARD) applies to apps that help sellers connect TikTok Shop with external commerce, fulfillment, or production systems.
| App category | Definition |
|---|---|
| Connector | Connects TikTok Shop with one external platform, such as Shopify, Salesforce Commerce Cloud, WooCommerce, BigCommerce, an ERP, an OMS, or another seller operation system. |
| Multi-Channel App (MCA) | Connects TikTok Shop with multiple external commerce or seller operation platforms so sellers can manage products, inventory, and orders across channels. |
| Dropshipping | Helps sellers source products from third-party suppliers and sell directly to buyers without holding inventory. The app usually coordinates product sync, order routing, and supplier fulfillment. |
| Print on Demand (POD) | Helps sellers sell customized products without pre-purchasing inventory. The app connects sellers with a production or printing partner that produces and ships products after orders are placed. |
§3 Implementation baseline by app category
The required use cases in this ARD are the baseline for Connector, MCA, Dropshipping, and POD apps unless Partner Center, your ARD template, or your partner manager confirms a category-specific exception.
| Capability group | Connector | MCA | Dropshipping | POD |
|---|---|---|---|---|
| Shop Connection | Required: SHOP-CONN-SINGLE, SHOP-DISCON-SINGLE, SHOP-MAN-MULTI, SHOP-MAN-WHOOK, SHOP-MAN-CARRIER | Same baseline | Same baseline | Same baseline |
| Category | Required: CAT-MAP-PROD | Same baseline | Same baseline | Same baseline |
| Listing prerequisites and listing | Required: CAT-PRE-PREREQ, CAT-PRE-CERT, CAT-PRE-BRANDS, CAT-PRE-SIZE, CAT-PRE-PKG, CAT-PRE-CAMPAIGN, CAT-PRE-WAREHOUSE, CAT-PRE-HAZMAT, CAT-PRE-CATEGORY, CAT-PROD-LIST | Same baseline | Same baseline | Same baseline |
| Product information quality | Required: CAT-NFOQUAL-SEOKEY, CAT-NFOQUAL-WHTBGIMG, CAT-NFOQUAL-AUTOWHTBG | Same baseline | Same baseline | Same baseline |
| Post-listing product sync | Required: CAT-POST-SEARCH, CAT-POST-INVENTORY, CAT-POST-PRICE, CAT-POST-INFO | Same baseline | Same baseline | Same baseline |
| Order sync | Required: ORD-SYNC-IMPORT, ORD-SYNC-UPDATE, ORD-SYNC-WHOOK | Same baseline | Same baseline | Same baseline |
| Fulfillment | Required: ORD-3PL-FULFILL, ORD-3PL-UPDATE, ORD-SPLIT-API | Same baseline | Same baseline | Same baseline |
| Promotion | Optional baseline. Implement the promotion use cases that match your app value proposition. | Same baseline | Same baseline | Same baseline |
§4 Scope application note
The numbers in parentheses after scope names are scope package IDs used in Partner Center review and Manage API configuration. When applying for or checking scopes, go to Partner Center > App & Service > Manage > Manage API, then search by the scope name and confirm the matching package ID. Some scopes are available by default, while sensitive or category-specific scopes may require approval. Always request the smallest set of scopes that your implemented use cases actually need.
§5 Shop Connection
| Use case ID | Required | Tag | Summary | Scopes | Solution guide | Integration guide |
|---|---|---|---|---|---|---|
SHOP-CONN-SINGLE | Yes | Shop Connection | Connect one external store to one TikTok Shop. | Shop Authorized Information(431812) Global Shop Information(431300) | Connect shops use cases | Connecting shops Get Authorized Shops |
SHOP-CONN-MULTI | No | Shop Connection | Connect one external store to multiple TikTok Shops. | Shop Authorized Information(431812) Global Shop Information(431300) | Connect shops use cases | Connecting shops Get Authorized Shops |
SHOP-DISCON-SINGLE | Yes | Shop Connection | Disconnect one external store from one TikTok Shop. | Shop Authorized Information(431812) Global Shop Information(431300) | Disconnect shops use cases | Disconnecting shops |
SHOP-MAN-MULTI | Yes | Shop Connection | Manage shop connections by adding new connections or removing existing ones. | Shop Authorized Information(431812) Global Shop Information(431300) | Manage shops use cases | Connecting shops Disconnecting shops |
SHOP-MAN-WHOOK | Yes | Shop Connection | Use the Upcoming Authorization Expiration webhook to notify sellers before reauthorization is required. | Shop Authorized Information(431812) Global Shop Information(431300) | Manage shops use cases | Reauthorize shops |
SHOP-MAN-CARRIER | Yes | Shop Connection | Map shipping carriers in the external platform to TikTok Shop shipping providers. | Shop Authorized Information(431812) Global Shop Information(431300) | Manage shops use cases | Get Shipping Providers |
§6 Category
| Use case ID | Required | Tag | Summary | Scopes | Solution guide | Integration guide |
|---|---|---|---|---|---|---|
CAT-MAP-PROD | Yes | Category Management Product Listing | Map product categories between the external platform and TikTok Shop. When calling Get Categories, include category_version=v2 when the endpoint reference requires it. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) | Category mapping use cases | Map product categories Get Categories |
§7 Listing
#§8 Pre-listing and listing prerequisites
Pre-listing and listing prerequisites
| Use case ID | Required | Tag | Summary | Scopes | Solution guide | Integration guide |
|---|---|---|---|---|---|---|
CAT-PRE-PREREQ | Yes | Product Listing | Check whether the seller has completed the shop configuration required for product listing. If required configuration is missing, stop listing and guide the seller to complete it. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Check Listing Prerequisites |
CAT-PRE-CERT | Yes | Product Listing | Upload product certifications or set required certification fields according to category rules. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Get Category Rules Create Product |
CAT-PRE-BRANDS | Yes | Brand Management Product Listing | Call Get Brands to map platform brands to TikTok Shop brands before listing. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Get Brands |
CAT-PRE-SIZE | Yes | Product Listing | Upload or set product size chart information according to category rules. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Get Category Rules Create Product |
CAT-PRE-PKG | Yes | Product Listing | Upload or set package dimensions before listing. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Create Product Edit Product |
CAT-PRE-ATTRIBUTE | No | Product Listing | Optionally let sellers sync products with custom attributes when your app supports that listing experience. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Get Attributes Create Product |
CAT-PRE-IMGSIZE | No | Product Listing | Optionally convert product images to meet TikTok Shop requirements for image size, aspect ratio, and file size. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Upload Product Image Optimize Images |
CAT-PRE-DESCRIP | No | Product Listing | Optionally let sellers set TikTok Shop-specific inventory, price, and description values before syncing products. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Create Product Edit Product |
CAT-PRE-CAMPAIGN | Yes | Product Listing | Map TikTok Shop products to the corresponding products in the external platform so campaign orders can sync back correctly. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Search Products Get Product |
CAT-PRE-WAREHOUSE | Yes | Warehouse Management Product Listing | Pull warehouse information, including warehouse ID, name, address, and status, before product sync. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Get Warehouse List |
CAT-PRE-DRAFT | No | Product Listing | Optionally create a draft product before listing. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Create Product |
CAT-PRE-HAZMAT | Yes | Product Listing | Require sellers to label products with hazardous properties, such as batteries or drain cleaners, when category rules require it. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Get Category Rules Get Attributes |
CAT-PRE-IMG | No | Product Listing | Optionally use image translation APIs to provide images in the language required by the target listing region. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Upload Product Image |
CAT-PRE-CATEGORY | Yes | Product Listing | Let sellers list products using Recommend Category by providing product title, description, and images. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Pre-listing use cases | Recommend Category Map product categories |
§9 Product listing and post-listing sync
Product listing and post-listing sync
| Use case ID | Required | Tag | Summary | Scopes | Solution guide | Integration guide |
|---|---|---|---|---|---|---|
CAT-PROD-LIST | Yes | Product Listing | List products from the external platform to TikTok Shop through the app. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Product listing use cases | Create Product Store product categories |
CAT-NFOQUAL-SEOKEY | Yes | Product Listing | Get recommended SEO keywords and add them to the product title based on seller request and approval. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Optimization(729604) Product Delete & Recover(431428) | Product information quality use cases | Products API overview |
CAT-NFOQUAL-TITLEDESC | No | Product Listing | Optionally get a recommended product title and description for an existing product based on seller request and approval. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Optimization(729604) Product Delete & Recover(431428) | Product information quality use cases | Products API overview |
CAT-NFOQUAL-EXISTDIAG | No | Product Listing | Optionally diagnose and optimize an existing product listing based on seller request and approval. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Optimization(729604) Product Delete & Recover(431428) | Product information quality use cases | Products API overview |
CAT-NFOQUAL-NEWDIAG | No | Product Listing | Optionally diagnose and optimize a new product listing based on seller request and approval. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Optimization(729604) Product Delete & Recover(431428) | Product information quality use cases | Products API overview |
CAT-NFOQUAL-WHTBGIMG | Yes | Product Listing | Optimize the first image of an existing product to have a white background based on seller request and approval. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Optimization(729604) Product Delete & Recover(431428) | Product information quality use cases | Optimize Images |
CAT-NFOQUAL-AUTOWHTBG | Yes | Product Listing | Optimize the first image of a new product listing to have a white background based on seller request and approval. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Optimization(729604) Product Delete & Recover(431428) | Product information quality use cases | Optimize Images |
CAT-POST-SEARCH | Yes | Product Listing | Search TikTok Shop product information through Open API. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Post-listing use cases | Search Products |
CAT-POST-INVENTORY | Yes | Product Listing | Update product inventory in TikTok Shop through Open API. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Post-listing use cases | Update Inventory |
CAT-POST-PRICE | Yes | Product Listing | Update product prices in TikTok Shop through Open API. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Post-listing use cases | Update Price |
CAT-POST-ACTIVATE | No | Product Listing | Optionally let sellers activate or deactivate a product. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Post-listing use cases | Deactivate Product |
CAT-POST-INFO | Yes | Product Listing | Let sellers edit and update product information in TikTok Shop through Open API. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Post-listing use cases | Edit Product Partial Edit Product |
CAT-POST-STOP | No | Product Listing | Optionally let sellers stop syncing product information, inventory, or price. | Global Product Information(431108) Product Basic(430148) Product Modify(431492) Product Delete & Recover(431428) | Post-listing use cases | Update Inventory Update Price |
§10 Order
| Use case ID | Required | Tag | Summary | Scopes | Solution guide | Integration guide |
|---|---|---|---|---|---|---|
ORD-SYNC-IMPORT | Yes | Order Management | Sync new and existing orders from TikTok Shop to the external platform. | Order Information(430276) | Order sync use cases | Get Order List Get Order Detail |
ORD-SYNC-UPDATE | Yes | Order Management | Detect order status changes and update the order status in the external platform. | Order Information(430276) | Order sync use cases | Order API overview Order status change webhook |
ORD-SYNC-WHOOK | Yes | Order Management | Use polling as a fallback so orders stay synced if some webhooks are missed or lost. | Order Information(430276) | Order sync use cases | Get Order List Order status change webhook |
ORD-SYNC-TAX | No | Order Management | Optionally retrieve tax information from order data. | Order Information(430276) | Order sync use cases | Get Order Detail |
ORD-CANCEL-BUYER | No | Order Management | Optionally support buyer order cancellation flows when applicable. | Order Information(430276) | Order cancellation use cases | Order API overview |
ORD-CANCEL-SELLER | No | Order Management | Optionally support seller order cancellation flows when applicable. | Order Information(430276) | Order cancellation use cases | Order API overview |
§11 Fulfillment
| Use case ID | Required | Tag | Summary | Scopes | Solution guide | Integration guide |
|---|---|---|---|---|---|---|
ORD-3PL-FULFILL | Yes | Order Management Fulfillment | For 3PL flows, sync orders to the external platform and let sellers fulfill and ship orders from that platform. | Fulfillment Basic(430340) Order Information(430276) | 3PL fulfillment use cases | Fulfillment API overview Mark Package As Shipped |
ORD-3PL-UPDATE | Yes | Order Management Fulfillment | Sync updated shipping and tracking information back to TikTok Shop after dispatch. | Fulfillment Basic(430340) Order Information(430276) | 3PL fulfillment use cases | Fulfillment API overview |
ORD-4PL-FULFILL | No | Order Management Fulfillment | Optionally implement 4PL API flows or let sellers fulfill orders from Seller Center. | Fulfillment Basic(430340) Order Information(430276) | 4PL fulfillment use cases | Fulfillment API overview |
ORD-SPLIT-API | Yes | Order Management Fulfillment | When sellers need item-level order splitting, use Mark Package As Shipped to split and ship packages. | Fulfillment Basic(430340) Order Information(430276) | Split order use cases | Split Orders Mark Package As Shipped |
ORD-SPLIT-3PL2 | No | Order Management Fulfillment | 3PL edge case: optionally fulfill split orders when sellers split the order in TikTok Shop Seller Center. | Fulfillment Basic(430340) Order Information(430276) | Split order use cases | Split Orders Fulfillment API overview |
ORD-SPLIT-4PL2 | No | Order Management Fulfillment | 4PL edge case: optionally support Seller Center order splitting before fulfillment. | Fulfillment Basic(430340) Order Information(430276) | Split order use cases | Split Orders Fulfillment API overview |
ORD-COMBINE-3PL1 | No | Order Management Fulfillment | 3PL edge case: optionally combine multiple orders into a single shipment on the external platform. | Fulfillment Basic(430340) Order Information(430276) | Combine order use cases | Fulfillment API overview |
ORD-COMBINE-3PL2 | No | Order Management Fulfillment | 3PL edge case: optionally fulfill combined orders when sellers combine orders in TikTok Shop Seller Center. | Fulfillment Basic(430340) Order Information(430276) | Combine order use cases | Fulfillment API overview |
ORD-COMBINE-4PL2 | No | Order Management Fulfillment | 4PL edge case: optionally support Seller Center order combination before fulfillment. | Fulfillment Basic(430340) Order Information(430276) | Combine order use cases | Fulfillment API overview |
§12 Promotion
| Use case ID | Required | Tag | Summary | Scopes | Solution guide | Integration guide |
|---|---|---|---|---|---|---|
PRO-VCL-FLFMNT | No | Promotion Orders | Optionally show virtual bundle details in the external platform when a seller receives an order with a virtual bundle. | Promotion Information(434884) | Virtual bundle use cases | Get Order Detail |
PRO-VCL-RECON | No | Promotion Orders | Optionally add combined_listing_info to the notes section of the external order management platform for virtual bundle orders. | Promotion Information(434884) | Virtual bundle use cases | Get Order Detail |
PRO-VCL-CREATE | No | Promotion Orders | Optionally create virtual bundles by using product APIs and providing combined_skus information in the request body. | Promotion Information(434884) | Virtual bundle use cases | Create Product Edit Product |
PRO-GWP-CREATE | No | Promotion Orders | Optionally create non-sellable products through the API for Gift with Purchase flows. | Promotion Information(434884) | Gift with Purchase use cases | Create Product |
PRO-GWP-GET | No | Promotion Orders | Optionally show a list of all non-sellable products in the seller's TikTok Shop. | Promotion Information(434884) | Gift with Purchase use cases | Search Products Get Product |
PRO-GWP-SEARCH | No | Promotion Orders | Optionally let sellers search for non-sellable products in TikTok Shop. | Promotion Information(434884) | Gift with Purchase use cases | Search Products |
PRO-GWP-CHPROD | No | Promotion Orders | Optionally let sellers toggle a product between sellable and non-sellable. TikTok Shop policy requires products to be recreated when changing between sellable and non-sellable. | Promotion Information(434884) | Gift with Purchase use cases | Create Product Deactivate Product |
PRO-GWP-RECON | No | Promotion Orders | Optionally reconcile orders when a Gift with Purchase is pushed to another platform. Shopify may require additional reconciliation handling. | Promotion Information(434884) | Gift with Purchase use cases | Get Order Detail |
PRO-FS-RECON | No | Promotion Orders | Optionally reconcile free sample orders. | Promotion Information(434884) | Free sample use cases | Get Order Detail |