> For the complete documentation index, see [llms.txt](https://docs-connector.ecomsend.com/ecomsend-connector/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-connector.ecomsend.com/ecomsend-connector/orders-and-fulfillments/sync-orders-to-shopify.md).

# Sync orders to Shopify

{% hint style="info" %}
The order sync feature is currently available for **US** TikTok Shop **only**.

If you use **other** connector apps with TikTok Shop, we recommend using **only** our app for product and order sync to **prevent duplicate syncing**.
{% endhint %}

Here’s how EcomSend Connector synchronizes orders to Shopify:

## Fetching orders

 Orders meeting the following criteria will automatically fetching from TikTok Shop to our app:

* Fulfillment type: [**Fulfilled by Seller**](#user-content-fn-1)[^1]
* Order status: Has reached **Awaiting shipment** (i.e., paid and no longer on hold)

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2FwL9BxMqH3HfDeS4DFIRP%2Fimage.png?alt=media&amp;token=e729636b-81af-4f4b-a6ad-8f31ca6073d3" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
For new users, we automatically fetching the **past 7 days** of TikTok Shop orders into our app for free. You can then choose whether to sync these orders to Shopify based on your needs.
{% endhint %}

## Syncing orders to Shopify

You can sync orders (including items, prices, and other details) to Shopify based on your order sync settings.

**Manual sync**: On the ***Orders page*** in our app, find the order you want to sync and click the **Sync** button in the **Action** column. Or **select multiple orders** to **sync in bulk**.

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2FiodlDp6SEN5I9Y69nvo5%2Fimage.png?alt=media&amp;token=dea92f59-aab5-4381-b0e8-88f937eedf70" alt=""><figcaption></figcaption></figure>

**Automatic sync:** **Enable** the **Automatic sync** feature on the *Settings → Order* page. The system will automatically sync all 'Not synced'  orders (both existing and new).

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2FBpmOhTYwBCwaTdpKpwi7%2Fimage.png?alt=media&amp;token=fd235856-c268-4a52-b6a0-d77b1ff39734" alt=""><figcaption></figcaption></figure>

***

EcomSend Connector automatically syncs order detials from TikTok Shop to Shopify:

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2F6x29sXAHIegMjXnBWh2r%2FGroup%203.png?alt=media&amp;token=2de3728a-802f-411a-bbfc-9207fb19933e" alt=""><figcaption><p>TikTok Shop order detials</p></figcaption></figure>

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2FCahedgSKfpXVNyUxYbtQ%2FGroup%204.png?alt=media&amp;token=d9a099c7-9ce2-46f0-b502-d0554f57d658" alt=""><figcaption><p>Order details synced to Shopify</p></figcaption></figure>

## Field mapping details <a href="#field-mapping-details-shopify-tiktok-shop" id="field-mapping-details-shopify-tiktok-shop"></a>

The following section explains in detail how the main fields from TikTok Shop are synced to Shopify.

**TikTok Shop → Shopify**&#x20;

> **TikTok Shop**: Go to TikTok Shop Seller Center Admin → Orders page → Manage Orders → Select specific order to see details
>
> **Shopify**: Go to Shopify Admin → Orders page → Select specific order to see details

### Order ID → Order number

When syncing orders to Shopify, our app uses Shopify’s **default** **order number**.\
The original TTS **order ID** is stored in **Additional details** for reference, so you can track the order back to TikTok Shop if needed.

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2F8MwV3ML6N5EEzk3mx65Z%2Fimage.png?alt=media&amp;token=0183f748-e861-4bcd-a28a-c12bf458675c" alt=""><figcaption></figcaption></figure>

### Time created → Date

The order creation time in Shopify is set to the time **when the customer placed the order** on TikTok Shop, **not** the time the order was synced by our app. This helps ensure accurate reporting of order timelines.

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2FSOk3Lku68KSbSrknd3JH%2Fimage.png?alt=media&amp;token=374c7736-1c15-4f66-a3ba-50494224e3bd" alt=""><figcaption></figcaption></figure>

### Delivery status

Shopify has two delivery statuses: **In transit** and **Delivered**.\
When a TTS order reaches either status, it will be automatically synced to Shopify to reflect the current delivery state.&#x20;

**Note:** Updates to delivery status **depend on TikTok Shop’s system**. Our app does not provide package tracking or delivery updates.

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2FRlSR5n8twYKJ7jbZl37y%2Fimage.png?alt=media&amp;token=08773563-9f8a-4bf8-a2d7-6efef59b5ade" alt=""><figcaption><p>TTS order status changes to <strong>In transit</strong></p></figcaption></figure>

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2FrfywUHs1QSxVyxmAN359%2Fimage.png?alt=media&amp;token=3dd22ebb-9165-49bb-a22a-83ae8da85e39" alt=""><figcaption></figcaption></figure>

### &#x20;Customer details → Customer

For orders using **TikTok Shipping**, customer information is **anonymized**. Full details may not be visible in Shopify.\
TTS provides only an **anonymous** email address, so **do not send messages directly** to this email. To contact the buyer, go to **Seller Center → Buyer Messages**.

### Delivery option → Delivery method

Our app will sync the TikTok Shop **delivery option** (e.g., Standard Shipping) to Shopify.\
This ensures that the delivery method selected in TikTok Shop is accurately reflected in the corresponding Shopify order.

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2FxWp4xMiGi9dgXpR7U239%2Fimage.png?alt=media&amp;token=996c7091-9b0a-4b7b-b33e-e980723b441d" alt=""><figcaption></figcaption></figure>

### Notes

Our app will sync the customer’s **buyer message** from TikTok Shop to the **Notes** section in Shopify, so you can see any special instructions or messages from the buyer.

### Additional details

The following information is synced to Shopify **Additional Details**:

Channel: TikTok Shop - {{Store Name}}\
TikTok Shop Order ID: {{Order ID}}\
Shipping Method: {{Seller Shipping}}

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2FBLILWzVGxIh7K4Djl1L8%2Fimage.png?alt=media&amp;token=58be7f75-fb64-4f86-824f-3d758fcec13c" alt=""><figcaption></figcaption></figure>

### Items

The products in the order correspond to the linked Shopify products.

If a product was part of a promotion, the synced price will reflect the **discounted price** from the TikTok Shop order.

* If the products **were synced through our app**, the items will match the corresponding Shopify products created by the app.
  \*

  ```
  <figure><img src="/files/qtibvdOpOKapukZuZfbJ" alt=""><figcaption><p>Sync by our app</p></figcaption></figure>
  ```

  \*

  ```
  <figure><img src="/files/izcoqmcoq6V5zcHiovcj" alt=""><figcaption></figcaption></figure>
  ```
* If the products **were not synced through our app**, the items will be matched to the **linked Shopify products**. Please make sure your TikTok Shop products are properly linked to Shopify products.
  \*

  ```
  <figure><img src="/files/YPCGB9TuM3fcsg9JteKo" alt=""><figcaption><p>Product linked</p></figcaption></figure>
  ```

  \*

  ```
  <figure><img src="/files/xsOSLwbhbBHo5Uxy88i5" alt=""><figcaption></figcaption></figure>
  ```

### Taxes/Discount/Shipping fee

All synced prices include discounts applied in TikTok Shop.&#x20;

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2FiKo8Dj6aN33jBPN4x3BV%2Fimage.png?alt=media&amp;token=3779c185-921a-4973-952e-25c85f88f963" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2FxI1bobByLVyf04VjTefP%2Fimage.png?alt=media&amp;token=90e95154-9fb7-4d6c-a516-ed87ccee2608" alt=""><figcaption></figcaption></figure>

### Tags

Default tag added: **TikTok Shop**

Additional tags:

* **TikTok Shop Gift** → for gift orders
* **TikTok Shop Sample** → for affiliate sample orders

<figure><img src="https://3351395997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGyD7kgIm6ylKeSkZt1y%2Fuploads%2FNekMG1ctHKQUqJkJKZlU%2Fimage.png?alt=media&amp;token=95b3397e-807b-41d3-9313-bfc7d91907c3" alt=""><figcaption></figcaption></figure>

**Need help?** Feel free to contact us via online chat or [email](mailto:undefined). Our world-class support team is available 24/7 and always ready to assist you. 🌻

[^1]: TikTok Shop offers two fulfillment types: **Fulfilled by** **Seller** and **Fulfilled by TikTok (FBT)**. \
    Currently, our app **only supports Fulfilled by** **Seller orders**.