> 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/configure-order-setup/alternative-product-ids.md).

# Match orders with alternative IDs

Learn how alternative product IDs work in order connections, when to use them, and which webshop identifier fields Channable supports.

When you import items into Channable, we track the primary identifiers from your main import source (e.g. your webshop, data file) and commonly used alternative identifiers like `EAN` and `SKU` codes.

Different IDs can result from existing marketplace listings, platform migrations, or channel-specific SKU rules. Without a match, orders can fail because the marketplace identifier doesn't exist in your eCommerce platform.

You can combat this by enabling **Alternative ID mapping** in your channel and/or project settings.

***

## **When to use Alternative ID mapping**

Alternative ID mapping helps match order items to existing eCommerce platform products.

**They're best used when:**

* Your marketplace uses different product IDs than your eCommerce platform/webshop
* You need region-specific SKU matching
* You’re migrating from another platform with legacy IDs
* Your products have multiple marketplace listings per item

|                                                                                                                                                                                                                                           |                                                                                                                                                                                                                                                            |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><i class="fa-square-check">:square-check:</i></p><p><strong>What Alternative ID mapping can do</strong></p>                                                                                                                            | <p><i class="fa-square-xmark">:square-xmark:</i></p><p><strong>What Alternative ID mapping won't do</strong></p>                                                                                                                                           |
| <ul><li>Match incoming orders to the correct products.</li><li>Use marketplace-specific identifiers without changing eCommerce platform identifiers.</li><li>Identify missing and duplicate IDs before they cause order errors.</li></ul> | <ul><li>Change the identifier you send to a marketplace when listing products.</li><li>Fix duplicate EAN/SKU values in your eCommerce platform catalog.</li><li>Guarantee order creation when the marketplace sends unknown product identifiers.</li></ul> |

## How Alternative ID mapping works

{% stepper %}
{% step %}

#### Marketplace → Channable

* A customer places an order on a marketplace.
* The marketplace sends its product identifier with the order.
* Channable receives the order through your order connection.
  {% endstep %}

{% step %}

#### Channable → Your eCommerce platform

* Channable looks at the channel specific ID and maps it back to the unique platform ID to create the order.
  {% endstep %}
  {% endstepper %}

## Mapping methods

You can set up alternative ids that match how you use Channable:

### <i class="fa-circle-1">:circle-1:</i> **Alternative channel ID**

<div data-with-frame="true"><figure><img src="https://3067532480-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8GepmoSonQRG6RnHOxJ%2Fuploads%2FNF9P9S1T84Gfwen36n7y%2FAlternative-channel-ID%20(2).gif?alt=media&amp;token=aafd93e2-9906-4212-a10b-3d36bd78818d" alt="Alternative channel ID mapping settings"><figcaption></figcaption></figure></div>

Use this when you list on a marketplace via a marketplace/API channel in Channable.

Channable matches the identifier sent to the marketplace with the correct eCommerce platform product.

### <i class="fa-circle-2">:circle-2:</i> **Alternative import ID**

<figure><img src="https://3067532480-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8GepmoSonQRG6RnHOxJ%2Fuploads%2FuEwv6lCeRCP4FC6wrCAs%2FAlternative-import-ID%20(1).gif?alt=media&amp;token=3636af54-fad3-46af-b54b-f00ab541c600" alt="Alternative import ID mapping settings"><figcaption></figcaption></figure>

Use this when you only use an order connection, and don't have accompanying channels in Channable.

Channable matches orders using identifiers recorded from your main import source.

#### Supported ID fields (alternative import ID)

Channable supports these eCommerce platform fields for alternative import ID mapping:

{% hint style="info" %}
We'll look for these specific alternative IDs per platform. You **can't** set it up to look for a different field type.
{% endhint %}

| Platform           | Identifier fields                        |
| ------------------ | ---------------------------------------- |
| BigCommerce        | `sku`, `GTIN`                            |
| CCVShop            | `sku_number`, `ean`, `ean_number`, `mpn` |
| Lightspeed Eseries | `sku`                                    |
| Lightspeed         | `sku`, `article_code`, `ean`             |
| Magento            | `sku`, `ean`                             |
| MijnWebWinkel      | `sku`, `uuid`                            |
| Odoo               | `barcode`, `code`                        |
| Prestashop         | `ean13`, `GTIN`, `reference`             |
| Shopify            | `sku`, `GTIN`                            |
| Shoptrader         | `sku`, `ean`                             |
| Shopware           | `ean`, `article_number`                  |
| Squarespace        | `sku`                                    |
| WooCommerce        | `sku`                                    |

## Learn more

{% content-ref url="/spaces/F8GepmoSonQRG6RnHOxJ/pages/xK38nlAnINYAhnC70HDB" %}
[Order connections](https://helpcenter.channable.com/list-advertise/orders/order-connections.md)
{% endcontent-ref %}

{% content-ref url="/spaces/F8GepmoSonQRG6RnHOxJ/pages/ThnfGSjQP4molJqnkEcL" %}
[Supported eCommerce platforms for order connections](https://helpcenter.channable.com/list-advertise/orders/order-connections/supported-ecommerce-platforms-for-order-connections.md)
{% endcontent-ref %}

{% content-ref url="/spaces/F8GepmoSonQRG6RnHOxJ/pages/EbcOfYTcqI5ABhARqpAc" %}
[How to add the order-sync add-on](https://helpcenter.channable.com/list-advertise/orders/order-connections/how-to-add-the-order-sync-add-on.md)
{% endcontent-ref %}


---

# 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 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/configure-order-setup/alternative-product-ids.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 `automate deployments from our CI pipeline` 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.
