> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/orders/order-connections/how-to-set-up-an-order-connection.md).

# How to set up an order connection

Learn how to set up an order connection in Channable to sync returns and help keep order statuses and stock aligned.

An order connection syncs orders from the marketplaces you’re listing on back to your eCommerce platform, and syncs shipment and tracking data back to the marketplace. It’s used to help keep order statuses and stock aligned and sync returns.

In this article, we’ll explain how to set up an order connection in Channable.

***

### <i class="fa-memo-circle-check">:memo-circle-check:</i> Before you start

**You’ll need**

* The Order sync add-on enabled in your plan
* [A compatible eCommerce platform](/list-advertise/orders/order-connections/supported-ecommerce-platforms-for-order-connections.md)
* [A compatible marketplace](/list-advertise/orders/order-connections/supported-marketplaces-for-order-connections.md)
* **Matched IDs:** Your eCommerce platform products must match the products in your marketplace channel (use the same product ID)

**Good to know**

* You need [one order sync add-on per marketplace seller account](/list-advertise/orders/order-connections/order-connection-billing-logic.md)
* You can only use one eCommerce platform per project.

{% stepper %}
{% step %}

### Create an order connection

1. Go to **Setup > Order connections**.
2. Click **Add connection**.
3. Select your eCommerce platform and marketplace channel.
4. For **Name**, give your connection a recognizable name (like ‘Amazon DE - Main’)
5. Fill in any additional required fields for your marketplace & eCommerce platform combination.
6. Click **Save**. Don't activate your connection yet.
   {% endstep %}

{% step %}

### Configure Advanced settings (optional)

After saving your new order connection, the <i class="fa-gear-complex">:gear-complex:</i> **Advanced settings** option will appear.

1. Click <i class="fa-gear-complex">:gear-complex:</i> **Advanced settings**.
2. Set your desired settings.
3. Click **Save**.

If you navigated away from this page, you can return to it by going to **Setup > Order connections** and selecting **Settings** in **\[your order connection]**.

Available options depend on the marketplace.

*Learn more:* [Advanced order connection settings](/list-advertise/orders/configure-order-setup/advanced-order-connection-settings.md)

{% hint style="warning" %}
By default, Channable will sync order returns for compatible eCommerce platforms and marketplaces. You can disable this in your advanced settings.
{% endhint %}
{% endstep %}

{% step %}

### Set transporter (carrier) settings

Set your transport settings to ensure Channable sends the right tracking and transporter details per order back to the marketplace.

{% hint style="info" %}
If you plan on using the marketplace’s fulfillment services, you can skip this step.
{% endhint %}

{% hint style="warning" %}
If no default transporter is selected, Track\&Trace (T\&T) codes will not be added to your orders.
{% endhint %}

<details>

<summary>I use one transporter</summary>

Go to **Setup > Transporter**.

1. Select a **Default transporter**. This transporter will be applied to all orders (for all order connections) unless specified otherwise through transporter mapping

</details>

<details>

<summary>I use multiple transporters</summary>

1. Go to **Setup > Transporter**.
2. Click **Add transporter mapping** to create rules based on different tracking code patterns.
3. Select a **Default transporter**. This transporter will be applied to all orders (for all order connections) that don’t meet your transporter mapping rules.

</details>
{% endstep %}

{% step %}

### Send a test order (optional)

Sending a test order tests whether Channable can successfully send and receive information from your eCommerce platform. It does not test whether it can receive information from your marketplace channels.

{% hint style="warning" %}
Make sure the Product ID entered for your test order matches the Unique ID for your items in your eCommerce platform.
{% endhint %}

1. In your eCommerce platform, check that the item(s) you want to test have at least 4 items in stock, and are imported in Channable.
2. Go to **Setup > Order connections**.
3. In **\[your order connection]**, click **Send test > Send test order**.
4. Provide the following information:
5. **Product ID:** Fill in the product ID of an item from your imported items. This ID must be the same unique ID used for that item in your eCommerce platform.

{% hint style="info" %}
**Y**ou can test multiple products by separating your IDs with commas.
{% endhint %}

6. **Country:** Select a country you sell this item in.
7. Click **Send test order**. Channable will test using randomized product information (e.g. price, description).

If successful, your test order will appear in your eCommerce platform and Channable account.

{% hint style="danger" %}
Do not process test orders.
{% endhint %}
{% endstep %}

{% step %}

### Activate your connection

After a successful test order, you’re ready to activate your connection.

1. Return to **Setup > Order connections**.
2. In **\[your order connection]**, click **Settings**.
3. Click **Activate order connection**.
4. Click **Save**.
   {% endstep %}
   {% endstepper %}

Channable retrieves new orders from the connected marketplace and pushes related information to your eCommerce platform.&#x20;

{% hint style="info" %}
If this is a new order connection, it can take up to 24 hours to retrieve order information.
{% endhint %}

### FAQ

<details>

<summary>Can I connect multiple eCommerce platforms with multiple Marketplaces in Channable?</summary>

An order connection connects **one eCommerce platform** to **one marketplace**.

This means that if you want orders from a marketplace to be sent to a different eCommerce platform, you'll need to create a new project for that connection.

</details>

<details>

<summary>I have orders that are fulfilled by the Marketplace, how can I set this up?</summary>

You need a separate order connection for your orders that are fulfilled by the marketplace.

For example: if you have both AFN and MFN orders or both FBR and FBB orders, you will need two separate order connections.

[Learn more](/list-advertise/orders/processing-orders-returns-and-cancellations/fulfilled-by-marketplace.md)

</details>

<details>

<summary>My eCommerce platform is not supported, what now?</summary>

In the case that your eCommerce platform is not supported, you can make use of our Channable API for an order connection.

&#x20;[Learn more](/list-advertise/orders/order-connections/supported-ecommerce-platforms-for-order-connections/how-to-set-up-the-channable-api-for-an-order-connection.md)

</details>

<details>

<summary>I use Magento or PrestaShop, how do I set up an order connection?</summary>

* Magento 2: Follow the instructions in [How do I configure the Channable Orders plugin in Magento 2?](/list-advertise/orders/order-connections/supported-ecommerce-platforms-for-order-connections/how-do-i-configure-the-channable-orders-plugin-in-magento-2.md)
* Prestashop: You need to adjust the settings of the Channable plugin. In the **Configuration** section of the Prestashop plugin, you'll see all the different parameters that you have to set up for your order connection to work.

</details>


---

# 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 following URL with the `ask` and `goal` query parameters:

```
GET https://helpcenter.channable.com/list-advertise/orders/order-connections/how-to-set-up-an-order-connection.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

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.