TikTok Sync Order Information

This destination is currently under final review and will be available soon.

TikTok for Business 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 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 supports TikTok order status, 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 array is dispatched to TikTok.

Destination setup

Configuration

Settings	Description
Credentials	Required Your credentials with TikTok as set directly in your destination or, in the left menu, following: Administration ➜ Connector Credentials ➜ Add connector credentials ➜ TikTok .
TikTok Organic Tracking Id	Required 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=opfed89ds90132344n2dkkl12321s321va).
Third Merchant Id	Required Must match the third_merchant_id you used to create the merchant within TikTok.
Third Shop Id	Required The identifier of the hotel as in your system.
Third Shop Name	Required The name of the hotel as in your system.
Payment Value	Required 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: payment_value = total_value - discounts. This value reflects the full price of the order, even if the customer completes payment at a later stage (E.g. during checkout).
Total Value	Required Total order value before discounts, including taxes and service fees. Calculated as: total_value = total_room_fee + total_tax + total_service_fee. This value is related to the price of the order.
Order Country	Required The country where the hotel is located.
Create Time	Required The time of order created in your system (timestamp in seconds).
Length Of Stay	Required Length of stay.
Amount Of Room	Required Amount of room stayed.
Check-In Date	Required Check-In date.
Check-Out Date	Required Check-Out date.
Event Mapping	Required Map TikTok order status with Your event name . More details are available following this LINK. At least one entry is required.

Quick reference

Commanders Act Events	TikTok Order Status
[Any Event]	[Any Order Status] [1]

[1] See Event Mapping in Configuration for more details.

Field mappings

Most properties can be remapped using our "Smart Mapping" feature. All TikTok properties are set in the path order_info .

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

[*] Mandatory property. [1] See Event Mapping in Configuration for more details. [2] Mandatory property for order status CANCEL_ORDER . This is either MERCHANT or CUSTOMER . [3] Set in path spu_list.0.sku_list.0 . [4] Mandatory property for order status COMPLETE_ORDER . [5] Set in path value.commission_value.0 .\