Skip to main content
Mirakl

Mirakl Connector instance fields: a checklist for Odoo

The Mirakl instance form brings together the connection, the settlement accounts and a few options; here is each field in turn, what it means according to its help text and what to enter.

FlexigoTech · Editor in charge: Víctor Gómez · Updated 5 November 2026

Key facts

Module
Mirakl
Versions
Odoo 17, 18, 19 and 20
Checked
in the connector's source code, version 20.0 · against the sources linked at the end
Reading time
5 min

The instance forms open from the menu Mirakl › Configuration › Marketplaces, in the Mirakl Instances list.

Diagram of the Mirakl, Configuration, Marketplaces menu and the fields of the instance form
Diagram built with code from the module's published code (not an Odoo screenshot): the menu and the form fields.

Before you open the form

  • Permission. To see the key you need to be a Mirakl Manager: the help for Api Key says only Mirakl Managers can see or change it, and Mirakl API key (FlexigoTech Cloud) is visible only to users with that permission.
  • Seller account on the marketplace. Keep it open in another tab: the operator host and the API key come from there, according to the help for those fields.
  • Subscription. The module needs the FlexigoTech Cloud subscription (Connector plan). The price is at the end.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo

Marketplace profile

  • Provider Code. It shows on the form and also in the Mirakl Instances list. It is the marketplace/provider profile the instance uses; according to its help, installing the provider add-ons exposes operator-specific profiles such as Leroy Merlin. The default is Generic Mirakl.

Connection tab, Access group

These fields are in the Connection tab, Access group.

  • Mirakl connection. It is read-only and defaults to FlexigoTech Cloud. Its help says new marketplaces connect through FlexigoTech Cloud, and that Direct (API key stored in Odoo) is kept only for the marketplaces that already existed before this version, which keep working as they were bought. There is nothing to enter: just check which route your instance has.
  • Mirakl API key (FlexigoTech Cloud). It sits in the FlexigoTech Cloud group. With the default values it is visible, and it is hidden when the connection is not the FlexigoTech Cloud one. Its help says it is sent once, encrypted, to FlexigoTech Cloud and is never stored in Odoo.
  • Base Url. The real operator host. Its help warns that Mirakl does not provide a universal host shared by every marketplace. For known operators it is filled in for you; otherwise, enter it from your seller account. Example from the help: https://adeo-marketplace.mirakl.net. It is required before you can test the connection or sync.
  • API Base URL. The real API base URL for the selected operator. Its help says it is usually the base URL plus /api, with this example: https://adeo-marketplace.mirakl.net/api.
  • Api Key. With the default values it is not visible: it is hidden when the connection is FlexigoTech Cloud, so it appears on instances with the Direct connection. It is the seller API key (Settings > API key in your seller account) and is required before you can use Test Connection or sync.
  • Shop. It shows on the form and in this group. It is an optional identifier for multi-shop environments. According to its help, Test Connection fills it in automatically when Mirakl exposes the seller shop.

Finances tab

This is where settlement accounting lives. The Finances tab has two groups.

Settlement Accounting group

  • Settlement Journal. A miscellaneous journal used to post Mirakl settlement entries. If you leave it empty, a dedicated Mirakl Settlements journal is created on first use. Pick one of your own if you would rather not have that one created.
  • Marketplace Clearing Account. A balance-sheet clearing account that represents what the marketplace owes you for orders: sales debit it and it is credited when the settlement pays out.
  • Commission Expense Account. The expense account for the marketplace commission and fees.
  • Payout / Bank Suspense Account. It is debited with the net payout transferred to you and later reconciled against the real bank deposit: manually in Community, with bank sync in Enterprise, according to its help.

Options group

  • Analytic Account. Optional. It lets this marketplace's settlements feed a per-channel P&L in Odoo's analytic reporting. Set it if you want that per-channel view.
  • Auto-post settlements. It automatically creates the accounting entry when a settlement is imported. It is off by default: tick it only if you want that entry created on import.

AI (optional) tab

  • Enable AI insights. It is in the AI (optional) tab and is off by default. Its help says Optional. The connector works fully without AI. If you don't enable this / don't set a key, no AI call is ever made and nothing changes. If you do not need it, leave it as it is.
Diagram of the help text of the AI insights field in five languages
Diagram built with code from the module's published translations (not an Odoo screenshot): the help for Enable AI insights in Spanish, German, French, Italian and Portuguese.

Review before you call the instance done

  • Check that Base Url and API Base URL point to the same operator; the second is usually the first plus /api, as in the help examples.
  • If your instance uses the Direct connection, confirm that Base Url and Api Key are filled in before you try to test the connection or sync.
  • After testing the connection, look at Shop: its help says it is filled in automatically when Mirakl exposes the seller shop.
  • Go through the accounts in the Settlement Accounting group with your accountant.

Price and help with the set-up

The module is a one-off payment per Odoo version and is published on Odoo Apps for 17, 18, 19 and 20 (see the Odoo Apps listing or the module page). It needs the FlexigoTech Cloud subscription, Connector plan: €49 a month or €490 a year, excluding VAT, for up to 3 marketplace accounts. The connection goes through FlexigoTech Cloud, which stores the credentials encrypted, watches the synchronisation and emails you if it fails. With the subscription, the module for newer Odoo versions is included if you bought it on flexigotech.com; on the Odoo App Store, each Odoo version is bought there.

FlexigoTech implements Odoo 17, 18, 19 and 20 and builds custom connectors and integrations. If you would like us to go through your instance form with you, get in touch.

Keep reading

Mirakl Instance fields in Mirakl Connector: what each means and what to setA side-by-side guide to the Mirakl Instance fields in Mirakl Connector for Odoo: what each help text says, the default value and what to set.The Mirakl instance fields in Odoo: what each one means and what to setA guide to the Mirakl Connector instance fields in Odoo: shipping, discount, commission, language, invoicing and sync, as their own help describes them.
Checked in the connector's source code (version 20.0) and the linked sources

Sources