# How to set up an order connection

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](https://helpcenter.channable.com/list-advertise/orders/order-connections/supported-ecommerce-platforms-for-order-connections)
* A compatible marketplace
* 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](https://helpcenter.channable.com/list-advertise/orders/order-connections/order-connection-billing-logic)
* 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](https://helpcenter.channable.com/list-advertise/orders/configure-order-setup/advanced-order-connection-settings "mention")

{% hint style="warning" %}
**Important:** 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" %}
Note: If you plan on using the marketplace’s fulfillment services, you can skip this step.
{% endhint %}

{% hint style="warning" %}
**Important:** 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" %}
**Important:** 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 > Orders**.
3. In **\[your order connection]**, click **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" %}
**Note:** You 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" %}
**Caution:** 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 > Orders**.
2. In **\[your order connection]**, click **Settings**.
3. Click **Activate order connection**.
4. Click **Save**.
   {% endstep %}
   {% endstepper %}

Channable will now retrieve any new and open orders from the past 5 days from the connected marketplace and push related information to your eCommerce platform.

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

Need to retrieve older open orders? Open a request to adjust your activation date with our Support team.

### FAQ

<details>

<summary>What about my open orders before I created the order connection?</summary>

If you need to retrieve 'open' orders that are not yet handled and that were placed before you activated the order connection, [contact our Technical Support team](https://app.gitbook.com/s/UAGSVlvcNsqEqVUgr0tD/contact-support) to request to change the activation date to a prior date. Only open orders can be retrieved.

</details>

<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. [You can read more about fulfilled by marketplace orders connections, here.](https://helpcenter.channable.com/list-advertise/orders/processing-orders-returns-and-cancellations/fulfilled-by-marketplace)

</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. [Read this article for more information](https://helpcenter.channable.com/list-advertise/orders/order-connections/supported-ecommerce-platforms-for-order-connections/how-to-set-up-the-channable-api-for-an-order-connection) on how it works and how it can be configured.

</details>

<details>

<summary>I use Magento or PrestaShop.</summary>

* With Magento 2, this functionality is integrated. [Read this article](https://helpcenter.channable.com/list-advertise/orders/order-connections/supported-ecommerce-platforms-for-order-connections/how-do-i-configure-the-channable-orders-plugin-in-magento-2) to learn how to configure the order plugin in Magento 2.
* If you use Prestashop, you need to adjust the settings of the Channable plugin. In the 'Configuration' section of the plugin, you will see all the different parameters that you have to set up for your order connection to work.

</details>