# TikTok Sync Order Information

{% hint style="info" %}
This destination is currently under final review and will be available soon.
{% endhint %}

[TikTok for Business](https://www.tiktok.com/business/en) is a global platform designed to give brands and marketers the solutions to be creative storytellers and meaningfully engage with the TikTok community.\
Using this destination, you can leverage [Tiktok Sync Order Information endpoint](https://bytedance.sg.larkoffice.com/docx/CslIdiRnaoSnwuxMpJQljyUagAg) to update the status of your orders.

## Key features

The TikTok Sync Order Information destination provides the following key features:

* **Events structure**: our [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) supports [TikTok order status](https://bytedance.sg.larkoffice.com/docx/CslIdiRnaoSnwuxMpJQljyUagAg#doxlgbogCjcbcoAPBIVYZOOJVIf), meaning that your data is properly bridged to the expected fields in an optimized way.
* **Prebuilt mappings**: data mapping for event-based destinations happens automatically, which simplifies user inputs.
* **Smart mapping**: data mapping can be readjusted using your datalayer defined fields.
* **Support for item data**: information included in the [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) array is dispatched to TikTok.

## Destination setup

### Configuration

<table><thead><tr><th width="330">Settings</th><th>Description</th></tr></thead><tbody><tr><td><code>Credentials</code></td><td><em><strong><code>Required</code></strong></em><br>Your credentials with TikTok as set directly in your destination or, in the left menu, following: <code>Administration</code> ➜ <code>Connector Credentials</code> ➜ <code>Add connector credentials</code> ➜ <code>TikTok</code> .</td></tr><tr><td><code>TikTok Organic Tracking Id</code></td><td><em><strong><code>Required</code></strong></em><br>The TikTok Organic Tracking Id (ttoclid) is a tracking parameter that is appended to your page URL when a user clicks on your product page (E.g. https://www.url.com/product?ttoclid=<mark style="color:blue;"><code>opfed89ds90132344n2dkkl12321s321va</code></mark>).</td></tr><tr><td><code>Third Merchant Id</code></td><td><em><strong><code>Required</code></strong></em><br>Must match the <code>third_merchant_id</code> you used to create the merchant within TikTok.</td></tr><tr><td><code>Third Shop Id</code></td><td><em><strong><code>Required</code></strong></em><br>The identifier of the hotel as in your system.</td></tr><tr><td><code>Third Shop Name</code></td><td><em><strong><code>Required</code></strong></em><br>The name of the hotel as in your system.</td></tr><tr><td><code>Payment Value</code></td><td><em><strong><code>Required</code></strong></em><br>The total amount the customer is expected to pay on the panel site. This includes all fees and taxes, but excludes any discounts applied. Calculated as: <code>payment_value = total_value - discounts</code>. This value reflects the full price of the order, even if the customer completes payment at a later stage (E.g. during checkout).</td></tr><tr><td><code>Total Value</code></td><td><em><strong><code>Required</code></strong></em><br>Total order value before discounts, including taxes and service fees. Calculated as: <code>total_value = total_room_fee + total_tax + total_service_fee</code>. This value is related to the price of the order.</td></tr><tr><td><code>Order Country</code></td><td><em><strong><code>Required</code></strong></em><br>The country where the hotel is located.</td></tr><tr><td><code>Create Time</code></td><td><em><strong><code>Required</code></strong></em><br>The time of order created in your system (timestamp in seconds).</td></tr><tr><td><code>Length Of Stay</code></td><td><em><strong><code>Required</code></strong></em><br>Length of stay.</td></tr><tr><td><code>Amount Of Room</code></td><td><em><strong><code>Required</code></strong></em><br>Amount of room stayed.</td></tr><tr><td><code>Check-In Date</code></td><td><em><strong><code>Required</code></strong></em><br>Check-In date.</td></tr><tr><td><code>Check-Out Date</code></td><td><em><strong><code>Required</code></strong></em><br>Check-Out date.</td></tr><tr><td><code>Event Mapping</code></td><td><em><strong><code>Required</code></strong></em><br>Map <mark style="color:blue;"><code>TikTok order status</code></mark> with <mark style="color:blue;"><code>Your event name</code></mark> . More details are available following this <a href="https://bytedance.sg.larkoffice.com/docx/CslIdiRnaoSnwuxMpJQljyUagAg#doxlgbogCjcbcoAPBIVYZOOJVIf">LINK</a>. At least one entry is required.</td></tr></tbody></table>

## Quick reference

| Commanders Act Events | TikTok Order Status           |
| --------------------- | ----------------------------- |
| `[Any Event]`         | `[Any Order Status]` **\[1]** |

{% hint style="info" %}
**1.** See <mark style="color:blue;">`Event Mapping`</mark> in [Configuration](#configuration) for more details.
{% endhint %}

## Field mappings

{% hint style="info" %}
Properties can be remapped using our [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) feature.\
All TikTok properties are set in the path <mark style="color:blue;">`order_info`</mark> .
{% endhint %}

<table data-full-width="false"><thead><tr><th width="417.6685580062747">Commanders Act Properties</th><th>TikTok Properties</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>order_id</code> <strong>[*]</strong></td></tr><tr><td><code>Third Merchant Id</code></td><td><code>third_merchant_id</code> <strong>[*]</strong></td></tr><tr><td><code>Third Shop Id</code></td><td><code>third_shop_id</code> <strong>[*]</strong></td></tr><tr><td><code>Third Shop Name</code></td><td><code>third_shop_name</code> <strong>[*]</strong></td></tr><tr><td><code>event_name</code></td><td><code>order_status</code> <strong>[*][1]</strong></td></tr><tr><td><code>Order Country</code></td><td><code>order_country</code> <strong>[*]</strong></td></tr><tr><td><code>Create Time</code></td><td><code>create_time</code> <strong>[*]</strong></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>update_time</code> <strong>[*]</strong></td></tr><tr><td><code>partners.tiktok.initiator</code></td><td><code>initiator</code> <strong>[2]</strong></td></tr><tr><td><code>currency</code></td><td><code>value.currency</code> <strong>[*]</strong></td></tr><tr><td><code>Payment Value</code></td><td><code>value.payment_value</code> <strong>[*]</strong></td></tr><tr><td><code>Total Value</code></td><td><code>value.total_value</code> <strong>[*]</strong></td></tr><tr><td><code>Length Of Stay</code></td><td><code>extra.length_of_stay</code> <strong>[*]</strong></td></tr><tr><td><code>Amount Of Room</code></td><td><code>extra.amount_of_room</code> <strong>[*]</strong></td></tr><tr><td><code>Check-In Date</code></td><td><code>extra.check_in_date</code> <strong>[*]</strong></td></tr><tr><td><code>Check-Out Date</code></td><td><code>extra.check_out_date</code> <strong>[*]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>third_sku_id</code> <strong>[*][3]</strong></td></tr><tr><td><code>items.X.product.name</code></td><td><code>third_sku_name</code> <strong>[*][3]</strong></td></tr><tr><td><code>items.X.third_spu_id</code></td><td><code>spu_list.0.third_spu_id</code></td></tr><tr><td><code>items.X.third_spu_name</code></td><td><code>spu_list.0.third_spu_name</code></td></tr><tr><td><code>partners.tiktok.actual_occupancy</code></td><td><code>extra.actual_occupancy</code></td></tr><tr><td><code>partners.tiktok.no_show</code></td><td><code>extra.no_show</code></td></tr><tr><td><code>partners.tiktok.cancel_reason</code></td><td><code>extra.cancel_reason</code></td></tr><tr><td><code>partners.tiktok.fulfillment_value</code></td><td><code>value.fulfillment_value</code> <strong>[4]</strong></td></tr><tr><td><code>partners.tiktok.fulfillment_tax</code></td><td><code>value.fulfillment_tax</code> <strong>[4]</strong></td></tr><tr><td><code>partners.tiktok.fulfillment_service_fee</code></td><td><code>value.fulfillment_service_fee</code> <strong>[4]</strong></td></tr><tr><td><code>partners.tiktok.commission_currency</code></td><td><code>currency</code> <strong>[4][5]</strong></td></tr><tr><td><code>partners.tiktok.commission_base_amount</code></td><td><code>commission_base_amount</code> <strong>[4][5]</strong></td></tr><tr><td><code>partners.tiktok.total_room_fee</code></td><td><code>value.total_room_fee</code></td></tr><tr><td><code>tax_amount</code></td><td><code>value.total_tax</code></td></tr><tr><td><code>partners.tiktok.total_service_fee</code></td><td><code>value.total_service_fee</code></td></tr><tr><td><code>partners.tiktok.discounts</code></td><td><code>value.discounts</code></td></tr><tr><td><code>context.page.url</code></td><td><code>order_url</code></td></tr><tr><td><code>partners.tiktok.promotion_id</code></td><td><code>promotion_info.promotion_id</code></td></tr><tr><td><code>partners.tiktok.promotion_description</code></td><td><code>promotion_info.description</code></td></tr><tr><td><code>partners.tiktok.promotion_saved_amount</code></td><td><code>promotion_info.saved_amount</code></td></tr></tbody></table>

{% hint style="info" %}
**\*** Mandatory property.\
**1.** See <mark style="color:blue;">`Event Mapping`</mark> in [Configuration](#configuration) for more details.\
**2.** Mandatory property for order status <mark style="color:blue;">`CANCEL_ORDER`</mark> . This is either <mark style="color:blue;">`MERCHANT`</mark> or <mark style="color:blue;">`CUSTOMER`</mark> .\
**3.** Set in path <mark style="color:blue;">`spu_list.0.sku_list.0`</mark> .\
**4.** Mandatory property for order status <mark style="color:blue;">`COMPLETE_ORDER`</mark> .\
**5.** Set in path <mark style="color:blue;">`value.commission_value.0`</mark> .
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://doc.commandersact.com/features/destinations/destinations-catalog/tiktok/tiktok-sync-order-information.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.