# How to set up an ePrice channel (API)

ePrice is an Italian ecommerce company specializing in electronic goods. 

In this article, you'll learn how to set up an ePrice channel to create, update and manage your ePrice listings in Channable.

***

### Before you start

**You'll need**

* A Mirakl account
* A project in Channable with your imported products
* Products with EAN codes

**Good to know**

* ePrice uses the Mirakl platform
* Some attributes may be mandatory even if they don't seem relevant for your specific situation (e.g. an attribute for adding a Spanish title when you’re only selling in Germany). You can leave these attributes unmapped.

{% stepper %}
{% step %}

### Create a ePrice channel

1. In Channable, go to **Projects > \[Your project] > Channels**.
2. In the search bar, enter “ePrice” and select **ePrice**.
3. Set your channel settings:
   1. For **Name**, give your channel a name.
   2. For **Unique ID per item**, select a field containing your products EAN codes (e.g. `ean`, `id`)
   3. For **Language**, choose the language your product data is in. 
   4. For **Use master rule group**, you can set a rule group if you already have one to apply to your channel.
4. Click **Save**.

{% endstep %}

{% step %}
{% hint style="warning" %}
**Important:** ePrice requires that IDs have a minimum of 5 digits. They will not accept anything with fewer than 5 digits, as this may result in errors or the listing being rejected by ePrice.
{% endhint %}

{% hint style="info" %}
Note for Magento users: IDs in Magento start counting from 1. Consequently, customers will be unable to utilize Magento via Channable to ePrice for products with fewer than 5 digits. This issue must be addressed and resolved within Magento.
{% endhint %}
{% endstep %}

{% step %}

### Create your product listings in Channable

Once you have created the ePrice API, set up your product data:

{% stepper %}
{% step %}

#### Categorize your products

To set up your product data, assign categories to your products.

* **AI product categorization:** Automatically assigns product categories through our algorithm.
* **Manual Categorization:** Manually assign product categories with custom rules. You can create detailed filters to map each product to the correct category.
* **Uncategorized Items:** Products that still need to be reviewed and categorized

[Learn more about categorizing for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-categorization-step)
{% endstep %}

{% step %}

#### Set up rules

Rules help you quickly optimize your product data for the marketplace you want to sell on.

* **Rule templates:** Commonly used rules you can adjust for your use case.
* **Rules setup:** Set up rules to refine your product data. This can include filtering, modifying, or enhancing data fields to meet marketplace requirements.

[Read more about using rules for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-rules-step)
{% endstep %}

{% step %}

#### Build your listings

The **Build** step is where you configure your product listings to match marketplace requirements. It’s an essential step for getting your products live and avoiding errors.

**Mandatory and optional fields**

* **Mandatory fields**: Required to list your products on this marketplace
* **Recommended**: Recommended to avoid errors and improve performance

**Shared attributes**

* Shared attributes are common fields that apply across your products, such as EAN, prices, and titles.
* **Use static or dynamic Values**
  * **Static values:** Fixed values that don’t change (e.g. brand name, manufacturer)
  * **Dynamic values:** Fields that automatically change based on the linked data (e.g. stock, prices)

**Category-specific attributes**

* Fields that specifically apply to the category for your products (e.g. size for clothing or dimensions for furniture).
* Fill in attributes that are specific to the selected category.

[Learn more about the Build step for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-build-step)
{% endstep %}

{% step %}

#### Check the quality of your set up

The **Quality** step provides feedback on your channel before you activate it. It highlights mandatory and optional errors to ensure your product data meets requirements to list on the marketplace.

* Solve errors, prioritizing mandatory errors first.

**Actions**

* **View items**: See products with specific issues.
* **View in build**: Redirects to the **Build** step to map missing information.
* **Set categories**: Directs to the **Categories** step to categorize items.
* **Show source**: Available for ID fields. Directs to the **Settings** step.

[Learn more about the Quality step for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-quality-step)
{% endstep %}

{% step %}

#### Preview before activating

The **Preview** step displays the attributes you mapped in the **Build** step, helping you check if everything is configured correctly by providing an overview of your products and potential errors.

Filtering:

* **Filter by error:** Click the **All** dropdown and select if you would like to filter to display only products with errors, or products with a specific error.
* **Filter by category:** Click the **All categories** dropdown and select the category you want to filter by.

Before you continue:

* **Review Shared attributes**: Ensure all mandatory shared attributes are filled.
* **Review Category-specific attributes**: Ensure all mandatory category-specific attributes are filled.
* **Check for errors**: Correct any red-marked fields.

[Learn more about the Preview step for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-preview-step)
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Tip:** Hover over <i class="fa-circle-question">:circle-question:</i> for more information on specific field requirements.
{% endhint %}

{% hint style="info" %}
Adding multiple attribute values: When adding multiple values in an attribute field for Mirakl Marketplaces, separate each value with a pipe symbol "|" to ensure proper detection and processing.
{% endhint %}

{% hint style="info" %}
Seller's Product ID for single/simple products: There are two attributes named `SellerArticleId` and `SellerProductId`. `SellerProductId` refers to the Parent ID, while `SellerArticleId` refers to the variant items. For single products, both attributes must be filled with the same value.
{% endhint %}
{% endstep %}

{% step %}

### Additional requirements for ePrice

#### Fulfillment latency

<figure><img src="https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/oefcj3wGCf1FGjRonifN/15231987808146" alt=""><figcaption></figcaption></figure>

&#x20;ePrice has a fulfillment latency field indicating the number of days it takes for the package to arrive. ePrice always adds +3 days on their end. Therefore, you can select negative days in Channable for this field (e.g., -1 means -1 + 3 = 2 days).&#x20;
{% endstep %}

{% step %}

### Connect to ePrice

To send your listings to ePrice, you need to connect your channel to your seller account account.

{% hint style="warning" %}
**Important:** Nothing changes when you link an account - any existing listings stay exactly the same until you activate.
{% endhint %}

1. In **\[your ePrice channel]**, go to the **Settings** step.
2. At **Linked seller account**, click **Select seller account**.
3. Select an existing account, or add a new account.
   1. If adding a new seller account:
      * For **Label**: Name your seller account connection.
      * Click **Connect with 2dehands Admarkt/2ememain Admarkt**. We'll redirect you to TikTok to log in with your credentials and accept permissions.
        {% endstep %}

{% step %}

### Activate and send your listings

1. In the **Settings** step in **\[your ePrice channel],** click **Activate API**.
2. Click **Save**.
3. Click **Run now** to send your product listings to ePrice.
   {% endstep %}

{% step %}

### Review and fix listing errors

After sending your listings, you can get feedback to see which listings require more data to list.

Go to the **Result** step and click on the **Feedback** tab. This page displays all possible processing feedback your product data has at a given moment.

**Resolving errors**

1. In **Description**, click on the error name. This takes you to an overview of the products with that error.
2. In **ID**, click the ID number and scroll. You should see a red highlighted callout in the section where the error occurred. Hover over the callout for more information.
3. If the error is a mapping error, click **View in build** to be directed to the attribute you need to map/re-map, which is highlighted in blue.
4. For more information about the attribute and its accepted values, hover over the info <i class="fa-circle-question">:circle-question:</i> icon.
5. Resolve the error.
   {% endstep %}
   {% endstepper %}

For more information on Mirakl Marketplace errors, how‑to's, and best practices, check out [our dedicated guide](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces/mirakl-guide-settings-and-solutions).