> For the complete documentation index, see [llms.txt](https://ezom.gitbook.io/ezom-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ezom.gitbook.io/ezom-docs/our-features/sku-mapping/single-sku-mapping.md).

# Single SKU Mapping

All SKUs should be already registered in your 3PL system (e.g., 4PX, JDL). EzOM is able to sync existing SKUs and quantities to the \<Inventory> page.

Sometimes, the store SKU and warehouse SKU are different. In order to tell the warehouse to find the correct items, SKU mapping is very important! There are 2 methods to do the SKU mappings.

***

## Understanding SKU Mapping Fields

Before creating SKU mappings, it's important to understand what each field means and where the values come from:

| Field                  | Description                                                                   | Source                                   | Required                       |
| ---------------------- | ----------------------------------------------------------------------------- | ---------------------------------------- | ------------------------------ |
| **Store**              | The sales channel where orders come from                                      | Select from your connected stores        | Optional                       |
| **Store SKU**          | The SKU code used in your sales channel listing (e.g., eBay, Shopify, Amazon) | Your store/marketplace listing           | Required (or Store Product ID) |
| **Store Product ID**   | The product identifier from your sales channel                                | Your store/marketplace                   | Required (or Store SKU)        |
| **Store Product Name** | A friendly name for reference                                                 | Your own description                     | Optional                       |
| **Warehouse SKU**      | The SKU code registered in your 3PL/warehouse system                          | Your warehouse provider (e.g., 4PX, JDL) | Required                       |
| **Quantity**           | How many warehouse items equal one store item                                 | Typically 1                              | Required                       |
| **Warehouse Code**     | The specific warehouse location                                               | Select from your warehouse locations     | Optional                       |

{% hint style="warning" %}
**Common Mistake:** Do not confuse Store SKU with Warehouse SKU. The Store SKU is the code from your sales channel (eBay, Shopify, etc.), while the Warehouse SKU is the code from your 3PL/warehouse system (4PX, JDL, etc.). These may be the same value, but they come from different systems.
{% endhint %}

### Example: eBay Store with 4PX Warehouse

If you sell on eBay and use 4PX as your warehouse:

| Field            | Example Value | Where to Find It                   |
| ---------------- | ------------- | ---------------------------------- |
| Store            | My eBay Store | Your connected store in EzOM       |
| Store SKU        | HGS180        | Your eBay listing SKU              |
| Store Product ID | (optional)    | Your eBay product ID               |
| Warehouse SKU    | HGS180        | The SKU code in your 4PX inventory |
| Quantity         | 1             | How many 4PX items per eBay order  |
| Warehouse Code   | AU Sydney WHS | Your 4PX warehouse location        |

{% hint style="info" %}
In this example, the Store SKU and Warehouse SKU happen to be the same (HGS180), but they represent different things: one is from eBay, the other is from 4PX. If your warehouse uses different codes, you would enter the warehouse's code in the Warehouse SKU field.
{% endhint %}

***

## Manual add

<figure><img src="/files/RMOuYk6eqIWfJbFvl1Hn" alt=""><figcaption></figcaption></figure>

In the SKU mappings page, Click bottom right icon and Click add \<SKU Mapping>.

<figure><img src="/files/MMRh9TfFsqsRhtC0ppR5" alt=""><figcaption></figcaption></figure>

* **Store**: Select the sales channel (eBay, Shopify, etc.) where orders come from
* **Store SKU**: Enter the SKU from your store listing (this is what appears on your orders)
* **Store Product ID**: Enter the product ID from your store (at least one of Store SKU or Store Product ID is required)
* **Store Product Name**: Optional - for your reference only
* **Warehouse SKU**: Enter the SKU code from your warehouse/3PL system (this is what EzOM sends to the warehouse)
* **Quantity**: How many warehouse items to pick for each store item (usually 1)

## Template Upload

SKU mapping template is attached below. The store ID can be found in Dashboard page.

<figure><img src="/files/Ltx8nyG7RIlh3KJGOxKd" alt=""><figcaption></figcaption></figure>

{% file src="/files/i6nEH33jXznR4qZ9LKNS" %}

***

## Troubleshooting

### "Unmapped products" or "No shippable warehouse SKU"

If you see these errors on your orders, it means EzOM cannot find a matching SKU mapping. Check the following:

1. **Verify the Store SKU matches your order**: Open the order details and check the "Store SKU" shown. This exact value must exist in your SKU mapping.
2. **Verify the Warehouse SKU exists in your inventory**: The Warehouse SKU in your mapping must match a SKU that exists in your 3PL/warehouse system. Check the Inventory page to confirm.
3. **Check the warehouse assignment**: Make sure the warehouse in your SKU mapping matches the warehouse assigned to your store in Automation Settings.
4. **Check for typos or case sensitivity**: SKU codes are case-sensitive. "HGS180" is different from "hgs180".

{% hint style="warning" %}
**Common Fix:** If your mapping isn't working, delete the incorrect mapping and create a new one. Make sure:

* Store SKU = the SKU from your sales channel (what appears on your orders)
* Warehouse SKU = the SKU from your 3PL system (what appears in your Inventory page)
  {% endhint %}

### Submit button is disabled

The Submit button remains disabled until all required fields are filled:

* At least one of Store SKU or Store Product ID must be provided
* Warehouse SKU is required
* Quantity is required (minimum 1)