Platform Model Transition

Custom Feed Setup

Prepare your internal data files as coded or mapped templates in .xlsx, .csv, or .xml formats to upload a catalogue.

Create a Coded Product Feed (Option 1)

Use this method if you have the technical resources to manage data coding. A coded template uses value IDs instead of labels. You can retrieve all category attribute IDs via the API request PM11 and the list of values via the API request VL11.

Ensure the final file contains only one header with attribute IDs. Enter all data required by the Catalogue Requirements guide. Use value IDs for attributes with several options.

Create a Mapped Product Feed (Option 2)

Use this method if you have the time and resources to manage data mapping. Use the Mapping Wizard in the Mirakl Platform to align your internal file structure with the Catalogue Requirements guide. This method requires manual maintenance; you must update mappings within Mirakl Platform whenever you add new categories, attributes, or values.

1. Import Product File

Log in to Mirakl Platform. Navigate to Settings > Catalog mapping > Use the mapping wizard. Click Select file and choose a UTF-8 encoded .xlsx or .csv file. Click Next step.

2. Categorisation

Select the column matching your product category in Column corresponding to the category. For subcategories, enter the divider in the Subcategory separator (optional) field. Click Next step.

3. Category Mapping

Click the two crossed arrows icon in Root to automap matching categories. Manually drag and drop any remaining categories to the corresponding Mirakl categories. Use the search panel to find specific categories. Click the X icon to unassign a category if needed. Click Next step.

4. Attribute Mapping

Click Automap to link attributes with matching names. Manually assign remaining attributes (mandatory attributes with red circle, recommended with orange, optional with grey) by selecting the platform attribute and choosing your corresponding file column. Click Next step.

5. Value Mapping

Open an attribute and click Automap. For remaining values, select your value on the left and the platform value on the right. Contact your Marketplace Representative if a required system value is missing. Click Next step.

6. Define Rules

Apply optional validation rules to change or verify assigned attributes, such as character limits for a Manufacturer Part Number.

7. Summary and Validation

Review the mapping overview. Click the provided links to return to previous steps if the system flags errors. Troubleshoot the errors. Review the mapping overview.

Upload a Product Feed

Navigate to Catalog > Import Products. Click Select file, choose your file, and click Confirm.

Monitor the status under the Catalog tab. Ensure the status is Complete and verify there are no errors in File details or Integration details, and in the Legal dashboard in Seller Portal (updated daily in the morning).

If errors exist, download the source file error or non-integrated products reports. Resolve errors using the Troubleshooting guide. Reupload the feed.

Create a Coded Offer Feed

Navigate to Price and stock > File imports. Click Offers Excel template. Click Generate template. Open the file and delete the first header containing attribute names to convert it into a coded offer template. Include all data required by the Catalogue Requirements guide.

Upload an Offer Feed

Navigate to Price and stock > File imports. Select your file and set the Import mode to Normal. Click Import. Navigate to Price and stock > File imports > Track offer imports. Once the status is Import complete, click the ⓘ icon to check processing details. Check the Legal dashboard in Seller Portal (updated daily in the morning).

If the system returns errors, download the offer import report via the ☰ icon. Resolve errors using the Troubleshooting guide. Reupload the feed.

Report abuse