With the wizard, you connect Xentral to your Mirakl marketplace. You enter the credentials and select the features you want to use. You create a separate integration for each marketplace.
-
You have the URL and the API key of your marketplace (see the article Mirakl: Setting up the marketplace).
-
You know whether there is a dedicated integration for your marketplace (for example Conrad, Hornbach, voelkner). For all other Mirakl marketplaces, you use Mirakl (see the article Mirakl: Overview).
-
Navigate to Settings > Integrations and click on New integration.
-
In the Search filter, enter the name of your marketplace or "Mirakl". Each Mirakl marketplace has its own card. If needed, you can narrow down the list further with the Price, Provider, and Category filters. You find integrations that are already installed in the Installed section and all others in the Available section.
-
Click on the integration.
-
If it is already installed, Xentral opens the wizard directly. Continue with the section "Going through the wizard".
-
If it is not installed yet, Xentral opens the details page. Below the name, you see "Book this integration", followed by the sections About this integration, Included features, Booking, and Provider. Click on Install.
-
Xentral opens the wizard for creating the integration, for example Create new Mirakl integration. It guides you through the setup in three steps: Credentials (enter the credentials), Details (name and features), and Review (confirm and create).
In the Credentials step ("Enter the credentials"), the wizard asks: "How should Xentral sign in to Mirakl?" Enter the credentials of your marketplace:
Field name |
Description |
|---|---|
|
URL |
URL of the Mirakl interface of your marketplace |
|
API Key |
API key of your seller account from the Mirakl back office |
Click on Test connection to check the credentials. As soon as the connection is established, click on Next. With Cancel, you leave the wizard without saving anything.
Field name |
Description |
|---|---|
|
Integration name |
Name under which you find the integration in the overview, for example "Conrad DE". The name must be unique. |
|
Activate production mode |
Turns on the automatic data exchange. Leave the option deactivated when you create the integration and activate it only after your tests. |
Select the features you want to exchange between the marketplace and Xentral and click on Next. You define exactly what is transferred later for each feature in the Workflows tab.
Field name |
Description |
|---|---|
|
Synchronize articles (excl. prices and stocks) (Xentral > sales channel) |
Transfers your product master data to the marketplace. Only required if you supply product data from Xentral. |
|
Synchronize offers (incl. prices and stocks) (Xentral > sales channel) |
Creates offers and keeps prices and stock levels up to date |
|
Synchronize orders (sales channel > Xentral) |
Imports orders from the marketplace |
|
Synchronize order statuses and tracking (Xentral > sales channel) |
Reports shipping, tracking number, and cancellations to the marketplace |
|
Synchronize receipts (Xentral > sales channel) |
Transfers invoices as PDF. Not available for Hornbach and voelkner. |
Tip
Activate all features that you are likely to need. You turn on each feature individually later in the workflows, and only then does Xentral transfer data.
-
Multiple shops in one Mirakl account: Create a separate integration for each shop and enter the respective Shop-Id in the general settings (see the article Mirakl: General settings).
-
You can change the name of the integration afterward in the general settings in the Identity section.