> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/sales-channels/tiktok-shop-integration.md). # TikTok Shop Integration Order Desk can connect to your [TikTok Shop](https://www.tiktok.com/) account and automatically download your orders. > **Choosing the Right Connection** > This guide covers both the **US** and **Global** TikTok Shop connections. > The **Global** connection currently supports the following marketplaces: > * **North America:** Mexico. > * **Asia:** China. > * **Europe:** The UK, France, Spain, Germany, Italy, and Ireland. > The **US** connection only supports shops based in the United States. ### Setup In Order Desk, click **Manage Integrations** in the left sidebar. Under the **Shopping Carts** tab, find and enable TikTok Shop. ![TikTok Shop integrations under the Shopping Carts tab](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FCmkUaFaaQ0hvkakK4Uhv%2Flegacy-441398b8b58871bfbb68.jpg?alt=media) You can also search for TikTok Shop using the available integration search. Choose the connection that matches your shop’s region. ![TikTok Shop US and Global integrations in the integration search](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FxXZgMZnitXJsXv6JZxH4%2Flegacy-788aa87f503658d00e78.png?alt=media) Once the integration is enabled, click **Connect to TikTok Shop**. You’ll be asked to sign in to your TikTok Shop account and authorize the connection. > Order Desk can’t find or reset your TikTok Shop credentials. You’ll need to get help with them directly from TikTok. ![Connect to TikTok Shop button in Order Desk](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FS3r4f6vPO4c7ureK7qIl%2Flegacy-f604b8da7864c06c7dee.png?alt=media) ![TikTok Shop authorization screen](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FMWRmFp3bbEgKJ0bmdztr%2Flegacy-f6c581e58e26faf12b25.png?alt=media) > You’ll need an active TikTok Shop account before you can connect the integration. You can create one through the [**TikTok Shop Seller Center**](https://seller.tiktok.com/). TikTok Shop accounts can’t be created through Order Desk. ### Integration Settings ![TikTok Shop integration settings in Order Desk](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Flm0Q72A24Bb6JEbcVZdi%2Flegacy-7cb18c58d4abd01c1497.png?alt=media) #### TikTok Help ![Opening the TikTok Shop help resources from Order Desk](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FqKnWLYbS7oYPnwXAOlkC%2Flegacy-90fd8e685509b0f7112a.gif?alt=media) Click **Need Help Getting Started?** to open helpful resources for using TikTok Shop. #### Instant Download Select **Enabled** to import TikTok Shop orders into Order Desk as soon as they’re placed. > If Instant Download is enabled but some orders aren’t being imported, make sure you’ve also set up a **Backup Check Schedule**. #### Backup Check Schedule The Backup Check Schedule tells Order Desk when to check TikTok Shop for new orders. If **Instant Download** is enabled, the backup check runs in the background and picks up any orders that weren’t imported when they were placed. If **Instant Download** is disabled, Order Desk will import new orders according to the schedule you select. #### Order Status Select which TikTok Shop order statuses Order Desk should download. #### Fulfillment Type Select which fulfillment types Order Desk should download. The available fulfillment types are: * **Fulfilled by TikTok Shop:** TikTok Shop manages the fulfillment process, including inventory and shipping. * **Fulfilled by Seller:** You fulfill the order. This includes Platform Shipping, which uses a shipping label purchased from TikTok Shop, and Seller Shipping, which uses your own shipping label. #### Shipping Type Select which TikTok Shop shipping types Order Desk should download. #### Folder for New Orders Select the folder where newly imported TikTok Shop orders should be placed. For more information, see the [**Working with Folders**](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide. #### Sync Tracking Numbers Enable this setting to automatically send shipment details back to TikTok Shop and update the original order. #### Sync Inventory Enable **Sync Inventory** if you want Order Desk to send inventory availability updates back to TikTok Shop. By default, Order Desk will sync inventory to the first available warehouse it finds. To choose a specific warehouse for an item, add either the `tiktokshopus_warehouse_id` or `tiktokshopglobal_warehouse_id` item metadata field and use the warehouse ID as its value. You can find your available warehouses by clicking **View Warehouse List** in the TikTok Shop help links. > **Preventing Unnecessary Stock Syncs to TikTok Shop** > If an inventory item isn’t found in TikTok Shop during the first sync attempt, Order Desk adds a skip metadata field to the item. This prevents repeated sync attempts for an item that isn’t available in TikTok Shop. > Depending on your integration region, the metadata field will be one of the following: > * `skip_push_tiktokshopglobal` > * `skip_push_tiktokshopus` > Once the skip metadata is added, Order Desk will stop trying to sync stock for that item. > If you list the item on TikTok Shop later, remove the skip metadata to resume syncing. You can remove it from multiple items at once using an [**inventory import template**](/guided-walkthroughs/templates-emails-and-order-documents/how-to-import-a-spreadsheet.md#remove-variations-and-metadata-from-inventory-items). #### Download Packing Slips Enable this setting to download packing slips with your TikTok Shop orders. #### Download Shipping Label Enable this setting to download shipping labels with your TikTok Shop orders. #### Expand Bundle SKUs If you use virtual bundles in TikTok Shop, enable this setting to have Order Desk split each bundle into its individual line items after import. #### Inventory Location Filter Use this setting to import only orders associated with specific inventory locations. #### First Import Date Select the earliest date from which you want Order Desk to import orders. #### Order Prefix Enter a prefix here if you want it added to every order number imported from TikTok Shop. #### Platform Shipping Label Creation > This feature is only available in the TikTok Shop US integration. ![Platform Shipping label defaults in the TikTok Shop US integration](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FZ8THmR827dk6gjjfZAPB%2Flegacy-d713368a38030c239007.png?alt=media) When **Platform Shipping** is selected under the [Shipping Type](#shipping-type) setting, label package settings will appear on the integration page. Use these settings to choose the default package details applied when you create labels for TikTok Shop orders. #### TikTok Shipping Label Creator When Platform Shipping is enabled in your [Shipping Type](#shipping-type) setting, a label creator will appear below the product details on each TikTok Shop order. Select the box type, enter the package weight, then click **Fetch Rates**. ![TikTok Shipping Label Creator on an Order Desk order](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F9nbdzsUleHPZXzRvYvmf%2Flegacy-9b9f8365d41ba0036d30.png?alt=media) The available rates will appear in a new dropdown menu. Select a rate, then create the label. You can also update the package settings and fetch the rates again. ### Manual Imports You can manually import orders or inventory items from TikTok Shop into Order Desk at any time. #### Manually Import Orders You can manually import orders from TikTok at any time. You can import orders by **Date** if you need to bring in multiple orders, or by a specific **Order ID** if you only need to import one order. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FenlqwVDATuR4Pq7ilFIk%2Flegacy-2c6d2f04acde1052cc6f.png?alt=media) > **Tip: Importing Orders by Date** > If TikTok has a large number of orders in the selected date range, you may need to click the **Import** button a few times to bring them all in. #### Manually Import Inventory Items ![TikTok Shop inventory import buttons in Order Desk](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F31KSmm1Kquh1GeIoB3tk%2Flegacy-7e5b2cc682e100b4358d.png?alt=media) Click **Request Product Download** to manually import your inventory items. You can also click **View Inventory Items** to view the inventory already stored in Order Desk. #### Handling Cancellations and Returns When a buyer asks to cancel an order or return or replace an item, Order Desk tracks the request and lets you approve or reject it without leaving Order Desk. > **TikTok Shop Global Sellers** > When this guide refers to `tiktokshopus` in a metadata field or rule action name, use `tiktokshopglobal` instead if you’re connected through the Global integration. #### Approving or Rejecting a Request When an order has an open cancellation or return request, Order Desk adds an **Approve / Reject** dropdown to the order details page. A button will also appear so you can send your response back to TikTok Shop. #### For a cancellation request: ![Approve or reject controls for a TikTok Shop cancellation request](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FHxfRo0A4VmUhfo8HF3d9%2Flegacy-984f7b6485aa14a15e22.png?alt=media) #### For a return request: ![Approve or reject controls for a TikTok Shop return request](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FZyiJ7Rah1fGvMJCR7rFp%2Flegacy-b6010ec5a9f110d465ac.png?alt=media) Select your response from the dropdown, then click the button to send it to TikTok Shop. These controls only appear while the request is waiting for a response. They’ll disappear after TikTok Shop marks the request as complete, canceled, or rejected. #### Automating Your Response with a Rule You can create a rule to respond to requests automatically. If you’re new to rules, start with the [**How to Work With Rules**](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) guide. Use the **Respond to Cancel / Return Request at TikTok Shop US** rule action: ![Respond to Cancel or Return Request rule action for TikTok Shop US](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FVYbvTooxDuOtnFH2XPEu%2Flegacy-d94351312c872974b426.png?alt=media) For example, you could automatically approve every buyer cancellation request. You could also approve returns only when certain conditions are met, such as when the order contains a specific product or is below a certain total. > **Heads Up** > The rule action will fail if the request has already been resolved. For example, it can’t approve a cancellation after the buyer has withdrawn the request. #### Building Custom Workflows Around Cancellations and Returns Order Desk provides rule events you can use to trigger workflows when specific changes happen, such as when a buyer submits a return request or a seller rejects a cancellation. There are two tracking levels. The level you use determines which rule events are available. #### Basic tracking, checked simultaneously as Order Desk imports orders from TikTok Shop: * `Buyer Requested Cancelation at TikTok Shop` * `Order Canceled at TikTok Shop` > As Order Desk imports orders from TikTok Shop, it checks whether each order has been imported before. If it finds a match, it runs a second check to see whether the order has a cancelation in progress and then records it. #### Detailed tracking, updated when TikTok Shop notifies Order Desk of a change: * `Order Cancelation Request Status Change at TikTok Shop` * `Order Return Status Change at TikTok Shop` * `Order Status Change at TikTok Shop` When a detailed tracking event runs, Order Desk stores information about the change as order metadata. You can use these fields in your rule filters: | Metadata Field | What It Tells You | | --------------------------- | -------------------------------------------------------------------------------------------------------- | | tiktokshopus\_event\_status | The current status of the request, such as pending, canceled, or complete. | | tiktokshopus\_event\_role | Who made the change. Possible values are `BUYER`, `SELLER`, and `TIKTOK`. | | tiktokshopus\_event\_id | An internal ID used by Order Desk to act on the request. You won’t usually need to filter on this field. | #### Example: Catching a Successful Cancellation To run a rule whenever a cancellation request is completed successfully, use the following example as a starting point: > * **Rule Type:** Order Rule > * **Event:** Order Cancelation Request Status Change at TikTok Shop > * **Filter:** Order Metadata Field `tiktokshopus_event_status` Equals `CANCELLATION_REQUEST_SUCCESS` > * **Action:** *Your preferred rule action* To run the rule only when the buyer canceled the order, add another filter where `tiktokshopus_event_role` equals `BUYER`. > * **Rule Type:** Order Rule > * **Event:** Order Cancelation Request Status Change at TikTok Shop > * **Filter:** Order Metadata Field `tiktokshopus_event_status` Equals `CANCELLATION_REQUEST_SUCCESS` > * **AND** > * **Filter:** Order Metadata Field `tiktokshopus_event_role` Equals `BUYER` > * **Action:** *Your preferred rule action* #### Values You Can Filter On The following values may appear in the event metadata fields. TikTok Shop may add or change values in the future, so use this list as a reference rather than a permanent list. #### Order Cancelation Request Status Change at TikTok Shop Possible values for `tiktokshopus_event_status`: * `CANCELLATION_REQUEST_PENDING`: The buyer has submitted a request and is waiting for a response. * `CANCELLATION_REQUEST_SUCCESS`: The request was approved. * `CANCELLATION_REQUEST_CANCELLED`: The request was withdrawn. * `CANCELLATION_REQUEST_COMPLETE`: The request was fully processed. #### Order Return Status Change at TikTok Shop Possible values for `tiktokshopus_event_status`: * `RETURN_OR_REFUND_REQUEST_PENDING` * `REFUND_OR_RETURN_REQUEST_REJECT` * `BUYER_SHIPPED_ITEM` * `REJECT_RECEIVE_PACKAGE` * `RETURN_OR_REFUND_REQUEST_SUCCESS` * `RETURN_OR_REFUND_REQUEST_CANCEL` * `RETURN_OR_REFUND_REQUEST_COMPLETE` * `REPLACEMENT_REQUEST_PENDING` * `REPLACEMENT_REQUEST_REJECT` * `REPLACEMENT_REQUEST_REFUND_SUCCESS` * `REPLACEMENT_REQUEST_CANCEL` * `REPLACEMENT_REQUEST_COMPLETE` **FAQ** #### Can You Create a TikTok Seller Account for Me? Order Desk can’t create a seller account for you. You can create one through the [**TikTok Shop Seller Center**](https://seller.tiktok.com/), then connect it to Order Desk. #### Why Are the Order Details Redacted on My TikTok Shop Orders? Order details are redacted when TikTok Shipping, also called Platform Shipping, is selected in your TikTok Shop Seller Center. To ship orders through another service, such as a fulfillment integration connected to Order Desk, switch the shipping option to Seller Shipping. #### Why Can’t I See My TikTok Shop Products in Order Desk After I Click Request Product Download? Order Desk can only download products that have a Seller SKU in TikTok Shop Seller Center. Check the product in TikTok Shop Seller Center and make sure a Seller SKU has been added. ![Seller SKU field in TikTok Shop Seller Center](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F2UQcb833EfKqhmCjPSZn%2Flegacy-4df91060a2da97a48653.png?alt=media) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.orderdesk.com/integration-setup-guides/sales-channels/tiktok-shop-integration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.