# TikTok Sync Order Information

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

[TikTok for Business](https://www.tiktok.com/business/en) est une plateforme mondiale conçue pour fournir aux marques et aux marketeurs des solutions afin d'être des conteurs créatifs et d'engager de manière significative la communauté TikTok.\
En utilisant cette destination, vous pouvez exploiter [Tiktok Sync Order Information endpoint](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 offre 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 transmises aux champs attendus de manière optimisée.
* **Mappages préconstruits**: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Mappage intelligent**: le mapping des données peut être réajusté en utilisant vos champs définis dans le 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) tableau sont envoyées à 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 avec TikTok tels que définis directement dans votre destination ou, dans le menu de gauche, en suivant : <code>Administration</code> ➜ <code>Connector Credentials</code> ➜ <code>Ajouter des connector credentials</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 qui est ajouté à votre URL de page lorsqu'un utilisateur clique sur votre page produit (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 au <code>third_merchant_id</code> que vous avez utilisé pour créer le marchand au sein de 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>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 panel. Cela inclut tous les frais et taxes, mais exclut les remises appliquées. Calculé comme : <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 (ex. lors du checkout).</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, incluant taxes et frais de service. Calculé comme : <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ù l'hôtel est situé.</td></tr><tr><td><code>Heure de création</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le moment de création de la commande dans votre système (timestamp 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 séjourné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>Mappage des événements</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Mapper <mark style="color:bleu;"><code>Statut de commande TikTok</code></mark> avec <mark style="color:bleu;"><code>Votre nom d'é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 | TikTok Order Status           |
| --------------------- | ----------------------------- |
| `[Any Event]`         | `[Any Order Status]` **\[1]** |

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

## Mappings des champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées en utilisant notre fonctionnalité "Smart Mapping".\
Toutes les propriétés TikTok sont définies dans le chemin <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>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>Pays de la commande</code></td><td><code>order_country</code> <strong>[*]</strong></td></tr><tr><td><code>Heure 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>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>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.  \
> \&#xNAN;**\[1]** Voir <mark style="color:bleu;">`Mappage des événements`</mark> dans [Configuration](#configuration) pour plus de détails.  \
> \&#xNAN;**\[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> .  \
> \&#xNAN;**\[3]** Défini dans le chemin <mark style="color:bleu;">`spu_list.0.sku_list.0`</mark> .  \
> \&#xNAN;**\[4]** Propriété obligatoire pour le statut de commande <mark style="color:bleu;">`COMPLETE_ORDER`</mark> .  \
> \&#xNAN;**\[5]** Défini dans le chemin <mark style="color:bleu;">`value.commission_value.0`</mark> .
> {% endhint %}