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

Order management system (OMS)

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

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

来自 TikTok Shop 官方资料快照 ·

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

资料正文

§1 What OMS apps do

Order management system (OMS) apps help sellers manage post-order operations after a TikTok Shop order is created. Use this page when your app imports orders, manages order status, coordinates 3PL or 4PL fulfillment, syncs shipping and tracking updates, handles split or combined packages, or needs to block fulfillment during the On Hold period. If your app mainly connects TikTok Shop with another commerce channel, start with the Connector or MCA requirements. If your app mainly provides shipping capacity or carrier services, start with the Shipping and Fulfillment requirements. If your app includes catalog, inventory, order, fulfillment, finance, and returns in one back-office system, start with the ERP requirements and use this OMS page for the order-fulfillment subset.

App typePrimary purposeWhere this OMS page applies
Connector or MCAConnect TikTok Shop with external commerce channels and keep shop, product, inventory, price, and order data synchronized.Use the shared Connector baseline for shop connection, catalog, listing, and generic order sync. Apply OMS-specific rows only when the app also manages fulfillment, split/combine, or On Hold handling.
Shipping or FulfillmentProvide logistics, carrier, or package execution capabilities.Use fulfillment API and shipping-provider requirements as the primary source. Apply OMS-specific rows when the app also exposes an order management workflow to sellers.
OMSOperate seller order workflows after order creation.Use this page for 3PL/4PL fulfillment, shipment update sync, split/combine scenarios, On Hold compliance, sample order mapping, and gift/giveaway order mapping.
ERPRun broad back-office operations across catalog, inventory, order, fulfillment, finance, and returns.Use ERP requirements as the broad category page. Use this OMS page as the focused reference for order and fulfillment scenarios.
#

§2 Shared baseline and maintenance

The original OMS table repeated shop connection, catalog, and generic order-sync rows that are already maintained in Connector/MCA and ERP pages. To reduce drift, this page keeps those shared families as references instead of duplicating every row. Apply the shared baseline when your OMS feature set includes that capability, and keep this page focused on OMS-specific behavior.

Shared familyUse case families preserved from the original OMS pageCanonical referenceTypical OMS usage
Shop connection lifecycleConnect shops use cases Disconnect shops use cases Manage shops use casesConnector, multi-channel, dropshipping, and print on demand Enterprise Resource Planning (ERP)Required when the OMS authorizes seller shops, manages shop connections, reauthorization reminders, or carrier mapping.
Product search, inventory, and pricePost-listing use casesConnector, multi-channel, dropshipping, and print on demand Enterprise Resource Planning (ERP)Required only if the OMS also manages product lookup, stock, or price. Do not request product scopes only because this page references OMS.
Generic order sync and cancellationOrder sync use cases Order cancellation use casesConnector, multi-channel, dropshipping, and print on demand Enterprise Resource Planning (ERP)Required when the OMS imports orders, detects status changes, uses polling as a webhook fallback, retrieves tax data, or supports order cancellation.
#

§3 Critical: On Hold compliance

When TikTok Shop orders are placed, they enter a 1-hour On Hold period before sellers should fulfill them. OMS apps that process seller orders must recognize the On Hold status, display it correctly, and block any fulfillment action while the order is On Hold. Sellers installing the app should not see an On Hold support warning caused by the app integration.

ScenarioRequired action
The app processes seller orders or lets sellers fulfill orders.Implement On Hold handling in order import, order status sync, and fulfillment actions. Block shipping, package creation, and other fulfillment actions until the order becomes fulfillable.
The app does not process orders for sellers.Complete the On Hold Status Developer Declaration in Partner Center. Suggested entry path: Partner Center > App & Service > select the app or service > App review or pre-publish checklist > On Hold Status Developer Declaration. If the exact menu label differs by market or review flow, search for the declaration title in Partner Center.
The app is being tested in Development Shop.Create a test order, confirm the initial status is On Hold, then validate the transition to Pending Shipment before allowing fulfillment. See the Development Shop manual order status update guide.

Integration references: Order API overview, Get Order List, Get Order Detail, and Order status change webhook.

#

§4 Terms and tag conventions

Term or tagMeaning in this page
3PLThird-party logistics. In this OMS context, the external platform helps sellers fulfill and ship orders, then syncs shipping and tracking information back to TikTok Shop.
4PLFourth-party logistics or fulfillment orchestration. In this OMS context, the app may coordinate fulfillment API flows or let sellers complete fulfillment from Seller Center before syncing package state.
Order Management tagUse for order import, order status sync, On Hold handling, sample order mapping, gift or giveaway order mapping, and other order-data workflows.
Fulfillment tagUse together with Order Management when the row requires fulfillment APIs, package shipping, tracking updates, split packages, or combined packages.
Promotion Orders tagReserve for promotion-domain use cases that require Promotion Information(434884), such as Gift with Purchase or virtual bundle setup. ORD-SYNC-GIFT remains an Order Management row because it uses Order Information(430276) and covers order mapping, not promotion creation.
#

§5 OMS-specific quick reference

The rows below keep the original use case IDs and parent use case links, but add a direct Integration guide column so developers do not have to infer the implementation path from the OpenLearn parent page alone. Suffixes such as 3PL2 and 4PL2 are inherited scenario labels, not sequence numbers. Read the "Trigger or edge case" column to understand when each row applies.

CapabilityStart with these use casesMain scopesIntegration guides
3PL fulfillment and shipment update syncORD-3PL-FULFILL, ORD-3PL-UPDATEFulfillment Basic(430340) Order Information(430276)Fulfillment API overview Mark Package As Shipped
4PL fulfillment supportORD-4PL-FULFILLFulfillment Basic(430340) Order Information(430276)Fulfillment API overview
Split packagesORD-SPLIT-API, ORD-SPLIT-3PL2, ORD-SPLIT-4PL2Fulfillment Basic(430340) Order Information(430276) Package Split And Combine, when required by the endpointSplit Orders Mark Package As Shipped Access scope
Combined packagesORD-COMBINE-3PL1, ORD-COMBINE-3PL2, ORD-COMBINE-4PL2Fulfillment Basic(430340) Order Information(430276) Package Split And Combine, when required by the endpointFulfillment API overview Access scope
Order-state and special order mappingORD-SYNC-ONHOLD, ORD-SYNC-SAMPLE, ORD-SYNC-GIFTOrder Information(430276)Order API overview Get Order Detail Development Shop manual order status update guide
#

§6 Fulfillment model

Use case IDRequiredTagsScopesWhat the OMS must doSolution guideIntegration guideTrigger or edge case
ORD-3PL-FULFILLYesOrder Management FulfillmentFulfillment Basic(430340) Order Information(430276)Sync orders to the OMS and let sellers fulfill and ship from the OMS or connected fulfillment platform.3PL fulfillment use casesFulfillment API overview Mark Package As ShippedRequired when the OMS is the place where sellers arrange shipment or submit shipping information.
ORD-3PL-UPDATEYesOrder Management FulfillmentFulfillment Basic(430340) Order Information(430276)Sync updated shipping and tracking information back to TikTok Shop after an order has been dispatched.3PL fulfillment use casesFulfillment API overviewRequired when sellers or fulfillment operators can edit carrier, tracking, or delivery information after dispatch.
ORD-4PL-FULFILLNoOrder Management FulfillmentFulfillment Basic(430340) Order Information(430276)Optionally implement 4PL API flows or let sellers fulfill orders from Seller Center, then keep package state aligned.4PL fulfillment use casesFulfillment API overviewOptional when the app supports 4PL orchestration rather than direct seller fulfillment inside the OMS.
#

§7 Split order scenarios

Use case IDRequiredTagsScopesWhat the OMS must doSolution guideIntegration guideTrigger or edge case
ORD-SPLIT-APIYesOrder Management FulfillmentFulfillment Basic(430340) Order Information(430276) Package Split And Combine, when required by the endpointSplit item-level fulfillment into separate packages and ship the packages through API flow.Split order use casesSplit Orders Mark Package As Shipped Access scopeRequired when sellers split an order from the OMS before shipping.
ORD-SPLIT-3PL2NoOrder Management FulfillmentFulfillment Basic(430340) Order Information(430276) Package Split And Combine, when required by the endpointRecognize and fulfill split packages when sellers split the order in TikTok Shop Seller Center first.Split order use casesSplit Orders Fulfillment API overview3PL edge case: Seller Center creates the split before the OMS fulfills the resulting packages.
ORD-SPLIT-4PL2NoOrder Management FulfillmentFulfillment Basic(430340) Order Information(430276) Package Split And Combine, when required by the endpointSupport package sync when sellers split an order in Seller Center before a shipping or 4PL application fulfills it.Split order use casesSplit Orders Fulfillment API overview4PL edge case: Seller Center split happens before the shipping application executes fulfillment.
#

§8 Combine order scenarios

Use case IDRequiredTagsScopesWhat the OMS must doSolution guideIntegration guideTrigger or edge case
ORD-COMBINE-3PL1NoOrder Management FulfillmentFulfillment Basic(430340) Order Information(430276) Package Split And Combine, when required by the endpointOptionally let sellers combine multiple orders into a single shipment from the OMS or connected fulfillment platform.Combine order use casesFulfillment API overview Access scope3PL scenario: the OMS is the system where sellers combine orders.
ORD-COMBINE-3PL2NoOrder Management FulfillmentFulfillment Basic(430340) Order Information(430276) Package Split And Combine, when required by the endpointRecognize and fulfill combined packages when sellers combine orders in TikTok Shop Seller Center first.Combine order use casesFulfillment API overview Access scope3PL edge case: Seller Center creates the combined shipment before the OMS fulfills it.
ORD-COMBINE-4PL2NoOrder Management FulfillmentFulfillment Basic(430340) Order Information(430276) Package Split And Combine, when required by the endpointSupport package sync when sellers combine orders in Seller Center before a shipping or 4PL application fulfills them.Combine order use casesFulfillment API overview Access scope4PL edge case: Seller Center combination happens before the shipping application executes fulfillment.
#

§9 Order-state and special order mapping

Use case IDRequiredTagsScopesWhat the OMS must doSolution guideIntegration guideTrigger or edge case
ORD-SYNC-ONHOLDYesOrder ManagementOrder Information(430276)Support the On Hold status and block sellers from fulfilling orders during the 1-hour On Hold period. If the app does not process seller orders, complete the On Hold Status Developer Declaration in Partner Center instead of updating an order-processing flow that the app does not have.Order sync use casesOrder API overview Get Order Detail Development Shop manual order status update guideCritical compliance row. Applies to any app that imports orders, displays order status, or allows fulfillment actions.
ORD-SYNC-SAMPLEYesOrder ManagementOrder Information(430276)Correctly map free sample orders from TikTok Shop and sync them to the OMS without treating them as regular paid orders when downstream logic differs.Order sync use casesGet Order DetailRequired when sample orders appear in the seller's OMS workflow.
ORD-SYNC-GIFTYesOrder ManagementOrder Information(430276)Correctly map gift or giveaway products from TikTok Shop and sync them to the OMS. If the app also creates Gift with Purchase or other promotion rules, check the Promotion Orders requirements separately.Order sync use casesGet Order DetailTag corrected from Promotion Orders to Order Management because this row uses Order Information(430276) and covers order mapping.
#