# TikTok Sync Order Information

{% hint style="info" %}
Cette destination est actuellement en phase de validation finale et sera bientôt disponible.
{% endhint %}

[TikTok for Business](https://www.tiktok.com/business/en) est une plateforme mondiale conçue pour donner aux marques et aux spécialistes du marketing les solutions nécessaires pour être des storytellers créatifs et interagir de manière significative avec la communauté TikTok.\
En utilisant cette destination, vous pouvez exploiter [endpoint Tiktok Sync Order Information](https://bytedance.sg.larkoffice.com/docx/CslIdiRnaoSnwuxMpJQljyUagAg) pour mettre à jour le statut de vos commandes.

## Fonctionnalités clés

La destination TikTok Sync Order Information fournit les fonctionnalités clés suivantes :

* **Structure des events**: notre [Référence des events](https://community.commandersact.com/platform-x/developers/tracking/events-reference) prend en charge [statut de commande TikTok](https://bytedance.sg.larkoffice.com/docx/CslIdiRnaoSnwuxMpJQljyUagAg#doxlgbogCjcbcoAPBIVYZOOJVIf), ce qui signifie que vos données sont correctement bridgées vers les champs attendus de manière optimisée.
* **Mappings préconfigurés**: le mapping des données pour les destinations basées sur les events se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Smart Mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Prise en charge des données des articles**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) array est envoyé à TikTok.

## Configuration de la destination

### Configuration

<table><thead><tr><th width="330">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Credentials</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Vos identifiants avec TikTok tels qu'ils sont définis directement dans votre destination ou, dans le menu de gauche, en suivant : <code>Administration</code> ➜ <code>Connector Credentials</code> ➜ <code>Ajouter des credentials de connecteur</code> ➜ <code>TikTok</code> .</td></tr><tr><td><code>TikTok Organic Tracking Id</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le TikTok Organic Tracking Id (ttoclid) est un paramètre de suivi ajouté à l'URL de votre page lorsqu'un utilisateur clique sur votre page produit (par ex. https://www.url.com/product?ttoclid=<mark style="color:bleu;"><code>opfed89ds90132344n2dkkl12321s321va</code></mark>).</td></tr><tr><td><code>Third Merchant Id</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Doit correspondre à <code>third_merchant_id</code> que vous avez utilisé pour créer le merchant dans TikTok.</td></tr><tr><td><code>Third Shop Id</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L'identifiant de l'hôtel tel qu'il figure dans votre système.</td></tr><tr><td><code>Third Shop Name</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le nom de l'hôtel tel qu'il figure dans votre système.</td></tr><tr><td><code>Payment Value</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le montant total que le client est censé payer sur le site du panel. Cela inclut tous les frais et taxes, mais exclut les réductions appliquées. Calculé comme suit : <code>payment_value = total_value - discounts</code>. Cette valeur reflète le prix total de la commande, même si le client effectue le paiement à une étape ultérieure (par ex. lors du checkout).</td></tr><tr><td><code>Total Value</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Valeur totale de la commande avant remises, incluant les taxes et les frais de service. Calculé comme suit : <code>total_value = total_room_fee + total_tax + total_service_fee</code>. Cette valeur est liée au prix de la commande.</td></tr><tr><td><code>Order Country</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le pays où l'hôtel est situé.</td></tr><tr><td><code>Create Time</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L'heure de création de la commande dans votre système (timestamp en secondes).</td></tr><tr><td><code>Length Of Stay</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Durée du séjour.</td></tr><tr><td><code>Amount Of Room</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Nombre de chambres séjournées.</td></tr><tr><td><code>Check-In Date</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Date de Check-In.</td></tr><tr><td><code>Check-Out Date</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Date de Check-Out.</td></tr><tr><td><code>Mapping des events</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Map <mark style="color:bleu;"><code>statut de commande TikTok</code></mark> avec <mark style="color:bleu;"><code>Your event name</code></mark> . Plus de détails sont disponibles via ce <a href="https://bytedance.sg.larkoffice.com/docx/CslIdiRnaoSnwuxMpJQljyUagAg#doxlgbogCjcbcoAPBIVYZOOJVIf">LIEN</a>. Au moins une entrée est requise.</td></tr></tbody></table>

## Référence rapide

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

{% hint style="info" %}

> **1.** Voir <mark style="color:bleu;">`Mapping des events`</mark> dans [Configuration](#configuration) pour plus de détails.
> {% endhint %}

## Mappings des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) feature.\
Toutes les propriétés TikTok sont définies dans le path <mark style="color:bleu;">`order_info`</mark> .
{% endhint %}

<table data-full-width="false"><thead><tr><th width="417.6685580062747">Propriétés Commanders Act</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" %}

> **\*** Propriété obligatoire.\
> **1.** Voir <mark style="color:bleu;">`Mapping des events`</mark> dans [Configuration](#configuration) pour plus de détails.\
> **2.** Propriété obligatoire pour le statut de commande <mark style="color:bleu;">`CANCEL_ORDER`</mark> . C'est soit <mark style="color:bleu;">`MERCHANT`</mark> soit de <mark style="color:bleu;">`CUSTOMER`</mark> .\
> **3.** Défini dans le path <mark style="color:bleu;">`spu_list.0.sku_list.0`</mark> .\
> **4.** Propriété obligatoire pour le statut de commande <mark style="color:bleu;">`COMPLETE_ORDER`</mark> .\
> **5.** Défini dans le path <mark style="color:bleu;">`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/fr/fonctionnalites/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.