> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/tiktok/tiktok-sync-order-information.md).

# TikTok Sync Order Information

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

[TikTok for Business](https://www.tiktok.com/business/en) est une plateforme mondiale conçue pour offrir aux marques et aux spécialistes du marketing les solutions leur permettant de raconter des histoires de manière créative et d'interagir de façon pertinente avec la communauté TikTok.\
Grâce à cette destination, vous pouvez exploiter [point de terminaison 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 événements**: notre [Référence des événements](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 reliées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur des événements s'effectue automatiquement, ce qui simplifie la saisie 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 d'article**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) le tableau 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>Identifiants</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Vos identifiants TikTok, configurés directement dans votre destination ou, dans le menu de gauche, comme suit : <code>Administration</code> ➜ <code>Identifiants du connecteur</code> ➜ <code>Ajouter des identifiants de connecteur</code> ➜ <code>TikTok</code> .</td></tr><tr><td><code>ID de suivi organique TikTok</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L'ID de suivi organique TikTok (ttoclid) est un paramètre de suivi qui est ajouté à l'URL de votre page lorsqu'un utilisateur clique sur votre page produit (p. ex. https://www.url.com/product?ttoclid=<mark style="color:bleu;"><code>opfed89ds90132344n2dkkl12321s321va</code></mark>).</td></tr><tr><td><code>ID du troisième marchand</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Doit correspondre au <code>third_merchant_id</code> que vous avez utilisé pour créer le marchand dans TikTok.</td></tr><tr><td><code>ID du troisième hôtel</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L'identifiant de l'hôtel tel qu'il est dans votre système.</td></tr><tr><td><code>Nom du troisième hôtel</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le nom de l'hôtel tel qu'il est dans votre système.</td></tr><tr><td><code>Valeur du paiement</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le montant total que le client est censé payer sur le site du panneau. Cela inclut tous les frais et taxes, mais exclut toute remise appliquée. 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 finalise le paiement à une étape ultérieure (p. ex. lors du paiement).</td></tr><tr><td><code>Valeur totale</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Valeur totale de la commande avant remises, y compris 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>Pays de la commande</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le pays où se trouve l'hôtel.</td></tr><tr><td><code>Date de création</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L'heure de création de la commande dans votre système (horodatage en secondes).</td></tr><tr><td><code>Durée du séjour</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Durée du séjour.</td></tr><tr><td><code>Nombre de chambres</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Nombre de chambres occupées.</td></tr><tr><td><code>Date d'arrivée</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Date d'arrivée.</td></tr><tr><td><code>Date de départ</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Date de départ.</td></tr><tr><td><code>Correspondance des événements</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Carte <mark style="color:bleu;"><code>Statut de commande TikTok</code></mark> avec <mark style="color:bleu;"><code>Nom de votre événement</code></mark> . Plus de détails sont disponibles en suivant ce <a href="https://bytedance.sg.larkoffice.com/docx/CslIdiRnaoSnwuxMpJQljyUagAg#doxlgbogCjcbcoAPBIVYZOOJVIf">LINK</a>. Au moins une entrée est requise.</td></tr></tbody></table>

## Référence rapide

| Commanders Act Events | Statut de commande TikTok                      |
| --------------------- | ---------------------------------------------- |
| `[Tout événement]`    | `[N'importe quel statut de commande]` **\[1]** |

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

## Correspondances des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Mappage intelligent](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.\
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>Propriétés TikTok</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>order_id</code> <strong>[*]</strong></td></tr><tr><td><code>ID du troisième marchand</code></td><td><code>third_merchant_id</code> <strong>[*]</strong></td></tr><tr><td><code>ID du troisième hôtel</code></td><td><code>third_shop_id</code> <strong>[*]</strong></td></tr><tr><td><code>Nom du troisième hôtel</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>Pays de la commande</code></td><td><code>order_country</code> <strong>[*]</strong></td></tr><tr><td><code>Date de création</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>initiateur</code> <strong>[2]</strong></td></tr><tr><td><code>currency</code></td><td><code>value.currency</code> <strong>[*]</strong></td></tr><tr><td><code>Valeur du paiement</code></td><td><code>value.payment_value</code> <strong>[*]</strong></td></tr><tr><td><code>Valeur totale</code></td><td><code>value.total_value</code> <strong>[*]</strong></td></tr><tr><td><code>Durée du séjour</code></td><td><code>extra.length_of_stay</code> <strong>[*]</strong></td></tr><tr><td><code>Nombre de chambres</code></td><td><code>extra.amount_of_room</code> <strong>[*]</strong></td></tr><tr><td><code>Date d'arrivée</code></td><td><code>extra.check_in_date</code> <strong>[*]</strong></td></tr><tr><td><code>Date de départ</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;">`Correspondance des événements`</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> . Il s'agit soit de <mark style="color:bleu;">`MERCHANT`</mark> ou <mark style="color:bleu;">`CUSTOMER`</mark> .\
**3.** Définie 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éfinie dans le path <mark style="color:bleu;">`value.commission_value.0`</mark> .
{% endhint %}


---

# 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://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/tiktok/tiktok-sync-order-information.md?ask=<question>&goal=<endgoal>
```

`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.
