> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://doc.common-services.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Profiles

On the **Profiles** tab you create **export recipes**: how prices, stock, warranty, variant titles, and marketplace extras are sent to Mirakl.

A checked category **must** have a profile assigned, or its products are **not** exported. See [Categories](https://doc.common-services.com/en/article/categories-1gpry2n/).

**Important:** Profiles are saved **per marketplace**. Choose the right marketplace first ([Multi-marketplace](https://doc.common-services.com/en/article/multi-marketplace-720rdi/)) before you create or edit profiles.

![Profile](https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd13200/screencapture-ps8-common-servi_qlj7d6.png)

---

## Create a profile

1. Select the marketplace.
2. Open **Profiles** → click **Add a profile to the list**.
3. Fill in the fields (details below).
4. Click **Save** (bottom right of the module page).

**Tip:** Nothing is kept until you click **Save**.

Optional: **Migrate profiles from old module** — paste the encoded profiles from a previous install and click **Migrate**. Use this only when support asks you to (old module upgrade).

---

## Most common need: +5% (or −5%) on the whole catalog

To cover marketplace commissions (or to discount everything):

1. Create one profile (e.g. name it `Marketplace +5%`).
2. Under **Price Rule**, choose **Percentage**.
3. Set **From** `0`, **To** `99999` (or your highest product price), then pick **+5%** (or a negative % to lower prices).
4. **Save**.
5. On [Categories](https://doc.common-services.com/en/article/categories-1gpry2n/), assign **this same profile** to every category you export (**Profiles Mapping**).
6. Run [Export offers](https://doc.common-services.com/en/article/export-offers-7dacds/).

**Note:** This changes the **price sent to Mirakl**, not necessarily the price on your PrestaShop shop.

This is **not** the same as **Transport → Shipping Fees → Additional** (that only affects **shipping**, not product price).

---

## How price rules work

**Price Rule**, channel price rules, and **Discount Price Rule** all use the same idea:

* **Type:** **Percentage** (e.g. `+10` or `-5` %) or **Value** (fixed amount in your shop currency, e.g. `+2` or `-1` €).
* **Ranges:** **From** / **To** = product price band in your shop currency. Click **+** to add another band.
* For each product, the module takes the PrestaShop price **before** the rule, finds the band that contains it, and applies that % or amount.
* If the price is **outside** every band you set, that rule does **not** change the price.
* **+** raises the price; **−** lowers it.

**Shipping Increase/Decrease** (see below) is applied **after** the price rule on the offer price in the export.

Other options in [Settings](https://doc.common-services.com/en/article/settings-19rveg8/) can also change prices: **Remises / Promotions (Discount/Specials)**, **Enabled Combine Resolve Price**, taxes, **Smart Rounding**.

A per-product **Price Override** on the [Mirakl tab on Product page](https://doc.common-services.com/en/article/mirakl-tab-on-product-page-9c0ufe/) **replaces** the calculated price for that product only.

---

## Profile fields (in screen order)

### Profile Name

A name for you only (e.g. `Standard`, `Promo`, `Outlet`). You will pick it again under **Categories** → **Profiles Mapping**.

---

### Price Rule

Default markup or markdown on the **regular (list) price** sent to Mirakl.

* Use this for one commercial rule for all products in categories linked to this profile.
* Example: **From** `0` → **To** `9999` with **+15%** → Mirakl gets catalog price + 15% (before shipping adjustment).

---

### Price Rule: `<channel>` (channel price fields)

Appears only if **your marketplace** has extra price columns (e.g. different prices per sales channel).

* Same logic as the main **Price Rule**, but for that channel’s price in the feed.
* Leave ranges empty to apply the rule to **all** prices for that field. If a channel rule is empty, the **main Price Rule** is used.

---

### Apply rule to discount price only

* **Unchecked (default):** **Price Rule** changes the **normal** export price.
* **Checked:** **Price Rule** does **not** change the list price; it only changes the **promo / sale** price (PrestaShop specific prices, when [Settings](https://doc.common-services.com/en/article/settings-19rveg8/) → **Remises / Promotions** is on).

Use this when Mirakl’s list price must stay equal to your shop’s public price, but promotions still need a markup.

---

### Discount Price Rule

Shown only when the marketplace has **no** channel price fields.

Builds or overrides the **sale price** on the Mirakl offer:

* If this rule is filled in correctly, the module calculates a sale price from the **regular export price** (same From / To logic), then applies **Shipping Increase/Decrease**.
* That sale price is sent as the discounted price on Mirakl (it can replace a promo that came only from PrestaShop).

Leave empty if PrestaShop discounts are enough and you only use **Price Rule** (and optionally **Apply rule to discount price only**).

---

### Shipping Increase/Decrease

Fixed amount in **shop currency** added to the **offer price** **after** price rules (e.g. `-1` = −1 € on the computed price; `+2` = +2 €).

This is **not** the shipping fee the buyer sees on Mirakl. It is a profile adjustment on the exported **offer price**. Real shipping still comes from [Transport](https://doc.common-services.com/en/article/transport-19lde4g/) and Mirakl.

---

### Stock Break-Even

Number added to the **quantity sent to Mirakl** (your PrestaShop stock is unchanged).

* `0` — send real stock (still limited by [Settings](https://doc.common-services.com/en/article/settings-19rveg8/) → **Out of Stock**).
* `-1` — send one unit less (safety buffer).
* `+1` — send one more than available (rare; use with care).

---

### Warranty

Manufacturer warranty on the offer, in **years** (digits only, e.g. `2`).

Fill this only if your marketplace expects it.

---

### Combinations Parameters

How size / colour / etc. appear in the **product title** on Mirakl for variants:

| Option | Effect |
| ---- | ---- |
| **Short Attributes** (default) | Short form (e.g. `30cm`). |
| **Long Attributes** | Full label (e.g. `Height - 30cm`). |
| **No Attributes** | Do not add combination attributes to the title. |

---

### Min Quantity Alert

Minimum quantity shown for the offer on Mirakl (customer must buy at least this many). Leave empty if you do not use a minimum.

---

### Logistic Class

Mirakl **logistic class** code for offers using this profile (depends on your marketplace). Leave empty if you do not use logistic classes.

---

### Delay Preparing

**Preparation / shipping delay** for offers in this profile (lead time before shipment). Works with the global **Delivery time** on [Transport](https://doc.common-services.com/en/article/transport-19lde4g/); the profile value applies to exports that use this profile.

---

### Specific Fields / Additional Specific Fields

Extra fields for **your marketplace**, loaded after **Verify** on the Authentication tab (dropdowns or text). Values go into the Mirakl feed as required by that operator.

Labels and allowed values come from Mirakl, not from PrestaShop.

---

### Marketplace mapping fields (when shown)

Some marketplaces show extra rows: map a Mirakl attribute to a PrestaShop **attribute**, **feature**, or **product field** (“Choose a field”). Other rows may appear after verify (text, checkbox, textarea).

Fill these when Mirakl requires that data on every offer.

---

**Note:** Not every field appears for every marketplace. After you change marketplace or Mirakl catalog setup, run **Verify** again and review your profiles.

---

## Common mistakes

* Profile created but **not** assigned on **Categories** → products are not exported.
* Looking under **Transport** for a catalog markup → use **Price Rule** here instead.
* Forgot **Save**, or forgot **Export offers** → Mirakl still shows old prices.

---

## Next steps

1. Assign the profile in [Categories](https://doc.common-services.com/en/article/categories-1gpry2n/) (**Profiles Mapping**).
2. Run a test [Export offers](https://doc.common-services.com/en/article/export-offers-7dacds/).
3. Adjust individual products on the [Mirakl tab on Product page](https://doc.common-services.com/en/article/mirakl-tab-on-product-page-9c0ufe/) if needed.