Steps on how to connect Mirakl with Commercium

You'll require API keys to connect Mirakl with Commercium. Obtaining your API keys from Mirakl is a straightforward process. Follow these simple steps to generate and copy your API keys:

Step 1- Log in to Your Mirakl Account

Begin by logging into your Mirakl account using your credentials.

Step 2- Go to Your Profile

Once logged in, navigate to your profile. This is typically found at the top right corner of the dashboard.

Step 3- Access the API Keys Tab:

• Within your profile settings, locate and click on the "API Keys" tab.

Step 4- Generate API Keys:

• Click on the option to generate new API keys. This will create a new set of keys for you to use.

Step 5- Copy the API Keys:

• Once generated, copy the API keys. Ensure you store them securely, as they will be used to connect Mirakl's API within Commercium.

Please follow the below steps to connect your Mirakl account to commercium:

Step 6: Access Your Commercium Account

• If you already have an account with Commercium, sign in using your login credentials.

• If you’re not yet registered, contact our support team at [email protected] for help getting started.

Step 7: Go to Integrations

• After logging in, head over to the Integrations on your Commercium dashboard and select the Available Integrations option.

• From the available choices, select Connect Mirakl.

Add a friendly name and then enter the API keys you get by following the above-listed steps. You'll also need to enter the base URL for your Mirakl Platform. Base URL is your Mirakl marketplace seller login Url. For Example: For PlanetaHeurto the base URL will be:  https://planetahuerto-prod.mirakl.net/

Lastly, click on Save Changes and your Mirakl account will be connected to the Commercium portal.

Configuration

1. Set Unique Product Identifier
Choose the appropriate identifier for your products—such as SKU, barcode, or another field—depending on how your catalog is structured.

2. Activate Order Sync
Within the Settings, enable the Order Sync option.

Order Sync Configuration Includes:

• Notify on Unlinked Item/Order – Enable this option to receive email alerts if an order or product fails to match or encounters an error during sync.

• Skip Unpaid Orders – When this setting is enabled, any orders from the marketplace that haven't been paid for will not be imported.

• Order Notes Format – You can choose to include the marketplace’s order ID in the order notes. Click the ‘+’ icon to add the ID, and optionally include a prefix or suffix.

• Order Number Format – Similar to the notes, you may configure how the order number appears by inserting the marketplace ID and adding any prefix/suffix as needed.

• Order Import Start Time – Define the timestamp (UTC) from which you want orders to start syncing. You can set this to the present time or a few hours earlier, based on your preference.

3. Turn On Shipment Sync
Enable Shipment Sync in the Settings.

You can link your shipping methods with those used in the marketplace. To set up multiple mappings, use the ‘+’ button.
Once mappings are complete, click Save Shipment, and then make sure to save all your changes by clicking Save at the top or bottom of the page.

4. Activate Inventory Sync
Enable Inventory Sync within the Settings panel.

• Safety Stock Level – Specify a buffer stock quantity that will be retained. This number will be subtracted from your total inventory, and the remaining quantity will be pushed to the marketplace. This helps you prevent overselling while keeping full stock visibility in your system.

5. Enable Price Sync
Switch on Price Sync from the Settings.

Any price changes made to your products will be automatically reflected in the marketplace for the matched listings.

6. Enable Product Sync
Activate Product Sync in the Settings.

• Default Inventory for Non-Tracked Products – Input a default stock quantity for items that aren’t inventory-managed. This ensures that these products still appear in stock in the marketplace, which requires inventory levels even for made-to-order or custom products.

If you have any questions or need any suggestions or assistance, please feel free to contact us at [email protected]