User Guide for PrestaShop Mirakl Connector

PrestaShop Mirakl Connector facilitates you to establish synchronization between PrestaShop store and Mirakl. Synchronize products from Mirakl to PrestaShop and vice-versa.

Easily import orders from Mirakl into your PrestaShop store. Automatically import new products or update imported products on PrestaShop via cron.

Note:

1. PrestaShop Mirakl Connector module is compatible with PrestaShop multi-store feature.
2. Our module relies on the Mirakl API for functionality, so feature availability depends on the API’s data.
3. Our module accepts all orders, but we need to create products before importing orders, so make sure all orders product are available in the Mirakl Connect catalog.
4. For product import, you need to import all sales channel products into the Mirakl catalog.
5. The module is integrated this APIs: https://developer.mirakl.com/content/product/connect
6. This connector only connects with Mirakl Connect, not with individual Mirakl Marketplaces.

Export Products

• Export all the PrestaShop products to Mirakl at once or specific products.
• Update all the exported products on Mirakl at once or specific products.
• Delete all the exported products on Mirakl at once or specific products.
• Update exported products on Mirakl when they are updated on PrestaShop.
• Export the default product category while exporting products to the Mirkal end.

Import Products

• Configure the number of products that you can import at once via cron.
• Option to import image while importing the product.
• While importing product, choose to keep product status as online or offline.
• Update imported products on Mirakl when they are updated on PrestaShop.
• Automatically import products or update imported products via cron.

Map products manually

• Map Prestashop and Mirakl products manually by entering the Mirakl product ID and selecting the Prestashop product.

Import Orders

• Import orders from Mirakl to PrestaShop.
• Import orders from Mirakl to PrestaShop by “From Date” and “order status”.

Configuration Settings

• Select the default shipping and payment method for imported orders.
• Map Mirakl order status with PrestaShop order status.
• Select the default category and associated categories for imported products.
• Map GTIN with UPC, EAN, ISBN, or MPN.
• Select the default group for Mirakl order customers.

• Firstly, go to the module manager in the back office and click on ‘upload a module’.
• After that, drag and drop the module file or select the file from the system.
• In this way, the module installation will be successful.

After the successful installation of the module, few new tabs get added in the back office.

From these tabs, the admin can configure module settings, import/export products, and import orders.

After the successful installation of the module, admin needs to configure it.

API Configuration

Under API configuration, the admin needs to specify some credentials that are required to integrate the PrestaShop store to Mirakl.

The admin needs to specify the seller company ID, client ID, and client secret that he got from his Mirakl account.

To get the required keys, you need to login to your Mirakl account.

Once you have created an account, click on “API integrations” under Settings.

Now, click on “Create API integration” button.

Enter the name of API integration in popup. After entering the name, click on Create button.

If admin has not saved the client secret key, he can reset it on the API integration information page.

Order Settings

Under Order Settings, the admin can:

• Configure default shipping and payment method for orders imported from Mirakl to PrestaShop.
• Select the PrestaShop order status that he wants to map with Mirakl order status.

Send new order email to admin: If the ps_emailalerts module has been configured for the new order email, then new order email will be sent to the admin on enabling this field.

Product Settings

Under Product Settings, the admin can:

• Choose to keep the status of an imported product online or offline.
• Configure the default category and associated categories for the products imported from Mirakl to PrestaShop.
• Choose to import image during product import.
• Map GTIN with UPC, EAN, ISBN, or MPN.
• Choose to automatically update imported/exported products on Mirakl when they are updated on PrestaShop.

Customer Settings

While importing the orders from Mirakl to PrestaShop, the customers also get imported. Under customer settings, the admin can select the default customer group for the customers.

Cron Settings

Import product

Enable the option to automatically import the products from Mirakl to PrestaShop as per the product settings.

Choose you action

The admin can choose to:

• Update only imported products on PrestaShop.
• Update the imported products on PrestaShop and if the product is unavailable, then a new product will create on PrestaShop.
• Import only new product in PrestaShop.

Number of days

In this field, the admin needs to set the number of days for which the imported products will not update.

Suppose the admin has imported the products from Mirakl to PrestaShop on 01/01/2024 and set 2 in this field.

If the cron runs on 02/01/2024, the imported products will not update. After two days, the imported products will be updated.

Number of products

This option lets admin set the number of products that can be imported via cron at once.

Import order

Enable the option to automatically import orders from Mirakl to PrestaShop as per the order settings.

Choose order status

The orders with selected Mirakl status will import from Mirakl to PrestaShop.

Please note that only the orders received in the last 24 hours can be imported via cron.

Under Products tab, the admin can:

• Manual mapping of products.
• Import products from Mirakl to PrestaShop.
• Export products from PrestaShop to Mirakl.

Manual Map

From the “Manual Map” option, the admin will be able to map the Prestashop and Mirakl manually.

The admin can map the Mirakl and Prestashop products by entering the Mirakl Product ID and selecting the Prestashop product.

After the admin clicks on the “Map” button, the product will map successfully.

When the admin maps the product successfully, it will be considered an exported product.

Import Products

Click on ‘Import products’ button.

Now, click on “Import now” button.

While importing the products from Mirakl to Prestashop, the following information will import with the products on Prestashop:

• Product Name/Title (if available)
• Price (tax excluded)
• Images
• Quantity
• Reference (if not available in Prestashop)
• ISBN/UPC/MPN/EAN
• Description
• Short Description

Note:

• If the admin imports the already mapped/imported product, then that product will be updated.
• While updating the products on the Prestashop end, if the admin deletes any image and adds a new image to the product on the Mirakl end, then the new image will be added to the Prestashop end without deleting any image.

Export Products

Click on ‘Export products’ button.

The admin can export all the products to Mirakl at once or export specific products to Mirakl.

Export specific products to Mirakl

While exporting the products to the Mirakl end, the following information will be exported to the Mirakl end:

• ID – Unique ID (module will generate)
• Product Title/name
• Images
• Quantity
• Description
• Price (tax excluded)
• Brand
• Attributes
• Product default category

Note:

• If the admin exports the already mapped/exported product, then that product will be updated on the Mirakl end.
• While updating the products on the Mirakl end, if the admin deletes any image and adds a new image to the product on the Prestashop end, then the new image will be added to the Mirakl end without deleting any image.

Update Exported Products on Mirakl

The admin can choose to update all the exported products on Mirakl at once or export a specific product to Mirakl.

Delete Product on Mirakl

Similarly, the admin can delete all the exported products on Mirakl at once or delete specific products.

Click on ‘Import orders’ button to import orders from Mirakl to PrestaShop.

The admin can import orders from Mirakl to PrestaShop according to date and order status.

Updated Mirakl from date

Here the admin needs to select the date from which he wants to import the orders. Suppose the admin selects 01/03/2024 and today is 10/03/2024.

Now, all the orders received between 1st March and 10th march will import from Mirakl to PrestaShop.

Choose order status

Orders with status selected by admin in this field will be imported from Mirakl to PrestaShop.

Note: The module do not import tax rule while importing product and order. The order is imported from Mirakl with tax amount.

Customers

While importing the orders, the customer details also get imported. Admin can view a list of the customers under this tab.

This was all about Prestashop Mirakl Connector module. I hope this document will help you in checking the functionality of the module in a better way.

Also, do let us know about your views in the comments.

For any kind of technical assistance or query, please raise a ticket or send us a mail at support@webkul.com

Also, please explore our Prestashop development services and a vast range of quality Prestashop addons.