> ## 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).

# Settings

The **Settings** tab groups general module settings for the selected marketplace. In most cases, keep the defaults after installation.

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

Select the correct marketplace first: [Multi-marketplace](https://doc.common-services.com/en/article/multi-marketplace-720rdi/).

**Note:** Some sections are collapsed under **\[ + ] Advanced Settings** (order import and advanced settings). Click to expand.

## Offers / catalog

### Remises / Promotions (Discount/Specials)
When enabled, the module exports PrestaShop **promotional prices**. When disabled, discounted prices are ignored.

### Use Marketplace Name
Uses the **marketplace name** instead of the generic “Mirakl marketplace” label (display / identification in PrestaShop).

### Smart Rounding
“Smart” price rounding (e.g. `15.46` → `15.49`).

### Product Name
Exported product name format:
* Name Only
* Name and Attributes
* Brand, Name and Attributes
* Name, Brand and Attributes
* Name and Reference
* Disable

### Description Field
Description content sent:
* Long Description
* Short Description
* Both (both concatenated)
* None

Check **HTML Descriptions** to allow HTML in the description (depending on what the marketplace accepts).

### Ignore Products without Images
**Yes** (recommended): do not export products without an image.  
**No**: not recommended.

### Include Availability dates
Includes availability dates in the offer.

### Enabled Additional Fields
Includes Mirakl **additional fields** in the offer (depending on marketplace / profile).

### Enabled Combine Resolve Price
Combines PrestaShop **specific prices** and **profile price rules** to compute the exported price (CSV / offer feed).

### Use Default Category For Export Products
Filters export on the product’s **default category**. Related to [Categories](https://doc.common-services.com/en/article/categories-1gpry2n/).

* **No** → export if the product is **in** a checked category (including secondary category).
* **Yes** → export only if the product’s PrestaShop **default category** is checked in Categories.

### Export simple products as variants
Groups simple products (no combinations) as **Mirakl variants** via a PrestaShop feature (value exported as `parent-sku`). Disabled by default.

Mirakl API documentation (product creation): [P41](https://developer.mirakl.com/content/product/mcm/rest/operator/openapi3/products/p41), [P42](https://developer.mirakl.com/content/product/mcm/rest/operator/openapi3/products/p42), [P46](https://developer.mirakl.com/content/product/mcm/rest/operator/openapi3/products/p46).

### Variant parent feature ID
PrestaShop **feature** ID used as the variant family key (`parent-sku`). `0` = disabled. Leave the feature empty on a product to export it as standalone.

## Taxes

### Taxes
When enabled: adds / computes taxes on products and orders per module logic. In most cases: **Yes**.

## Order Import Settings (advanced)

Click **\[ + ] Advanced Settings** under *Order Import Settings*.

### Import By ID Product
Identifies the PrestaShop product by **product ID** (special cases).

### SKU format
How the module builds / reads the Mirakl **shop SKU** (offers + order import), **per marketplace**:
* **PrestaShop reference (default)** — PrestaShop product / combination reference (standard)
* **Iziflux** — format `id_product#IZI#id_product_attribute` (e.g. `42#IZI#0`, `100#IZI#15`)

**Note:** Enable Iziflux only if your Mirakl offers already use this format (migration). Otherwise you risk **duplicate offers**.

### Allow Empty VAT/DNI
Allows import without VAT ID / DNI: substitute value (e.g. `no-disponible` or country equivalent).

### Use Standard Carrier
Uses the **Standard** carrier from [Transport](https://doc.common-services.com/en/article/transport-19lde4g/) as the default carrier on import.

### Use Standard Customer Email
Uses the standard customer email from the Mirakl order.

### Override Generate Invoice
Forces / overrides invoice generation on import.

### Allow Negative Stock on Import
Imports the order even if stock is 0 or negative (PrestaShop stock may go negative).

## Stock

### Out of Stock
Minimum stock quantity to export the product (e.g. `1` = do not export if stock < 1).

### Override Stock
Leave **empty** to use PrestaShop stock. Otherwise sets the **same stock quantity for all products** on export.

## Catalog

### Use Default Category
Default profile / category when a category has no mapping. See [Profiles](https://doc.common-services.com/en/article/profiles-16bb40d/) and [Categories](https://doc.common-services.com/en/article/categories-1gpry2n/).

### Warehouses
If PrestaShop advanced stock management is enabled: warehouse used for stock / picking.

## Identifiers & images

### Product ID Type
Product identifier type sent to Mirakl (e.g. **EAN**, **SKU**, **SHOP_SKU**, depending on options shown). Must match what the marketplace expects. See also [Validate your catalog structure](https://doc.common-services.com/en/article/validate-your-catalog-structure-c1n5kh/).

### Image Type
PrestaShop image type used (ideally the largest, often `thickbox_default` or equivalent). Check **Design / Appearance → Images** (or Preferences → Images on older versions).

## Customers

### Customer Group
PrestaShop customer group linked to this marketplace (useful for group prices / promotions).

## Languages

### Languages
Language(s) used for offers (multiple selection). At least one language is required.

## Advanced Settings

Click **\[ + ] Advanced Settings** at the bottom of the tab.

### Disable SSL Check
Disables SSL verification on API calls. Use only for host / certificate troubleshooting. **Not recommended** in production.

### Refresh Product Option Tbl (Expert)
**Development** option only. Do not enable in production without support instruction.

## Next

* [Transport](https://doc.common-services.com/en/article/transport-19lde4g/), [Orders](https://doc.common-services.com/en/article/orders-w2n36p/), [Filters](https://doc.common-services.com/en/article/filters-fsvt4n/)
* [Export offers](https://doc.common-services.com/en/article/export-offers-7dacds/), [Import orders](https://doc.common-services.com/en/article/import-orders-1roj2fa/)
* [Mirakl tab on Product page](https://doc.common-services.com/en/article/mirakl-tab-on-product-page-9c0ufe/), [Scheduled tasks](https://doc.common-services.com/en/article/scheduled-tasks-2og48k/)