Salta al contingut principal
Mirakl

Checklist de la instància de Mirakl Connector, camp a camp

La fitxa d'instància de Mirakl reuneix la connexió, els comptes de liquidació i unes opcions; aquí tens, camp a camp, què significa cadascun segons la seva ajuda i què convé posar.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 5 de novembre de 2026

L'essencial

Mòdul
Mirakl
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
5 min

Les fitxes s'obren des del menú Mirakl › Configuration › Marketplaces, a la llista Mirakl Instances.

Esquema amb el menú Mirakl, Configuració, Marketplaces i els camps de la fitxa d'instància
Esquema fet amb codi a partir del codi publicat del mòdul (no és una captura d'Odoo): el menú i els camps de la fitxa.

Abans de tocar la fitxa

  • Permís. Per veure la clau cal ser Mirakl Manager: l'ajuda de Api Key diu que només els Mirakl Managers poden veure-la o canviar-la, i la Mirakl API key (FlexigoTech Cloud) només la veuen els usuaris amb aquest permís.
  • Compte de venedor del marketplace. Obre'l en una altra pestanya: d'allà surt el host de l'operador i la clau d'API, segons l'ajuda d'aquests camps.
  • Subscripció. El mòdul necessita la subscripció a FlexigoTech Cloud (pla Connector). El preu és al final.
Same stock on every Mirakl marketplace, sent from Odoo
Vídeo: Same stock on every Mirakl marketplace, sent from Odoo (vídeo en anglès)

Perfil del marketplace

  • Provider Code. Es veu a la fitxa i també a la llista de Mirakl Instances. És el perfil de marketplace/proveïdor que fa servir la instància; segons la seva ajuda, en instal·lar els complements de proveïdor apareixen perfils específics de l'operador, com Leroy Merlin. El valor per defecte és Generic Mirakl.

Pestanya Connexió, grup Accés

Aquests camps són a la pestanya Connection, grup Access.

  • Mirakl connection. És de només lectura i val FlexigoTech Cloud per defecte. La seva ajuda diu que els marketplaces nous es connecten a través de FlexigoTech Cloud i que Direct (API key stored in Odoo) només es manté per als que ja existien abans d'aquesta versió, que continuen funcionant tal com es van comprar. No hi has de posar res: només comprova quina ruta té la teva instància.
  • Mirakl API key (FlexigoTech Cloud). És al grup FlexigoTech Cloud. Amb els valors per defecte es veu, i s'amaga si la connexió no és la de FlexigoTech Cloud. La seva ajuda diu que s'envia una vegada, xifrada, a FlexigoTech Cloud i que mai es desa a Odoo.
  • Base Url. És el host real de l'operador. La seva ajuda avisa que Mirakl no proporciona un host universal compartit per tots els marketplaces. Per a operadors coneguts s'omple sola; en cas contrari, introdueix-la des del teu compte de venedor. Exemple de l'ajuda: https://adeo-marketplace.mirakl.net. És obligatòria abans de poder provar la connexió o sincronitzar.
  • API Base URL. És la URL base real de l'API per a l'operador triat. La seva ajuda diu que normalment és la URL base més /api, amb aquest exemple: https://adeo-marketplace.mirakl.net/api.
  • Api Key. Amb els valors per defecte no es veu: s'amaga quan la connexió és FlexigoTech Cloud, així que apareix a les instàncies amb connexió Directa. És la clau d'API de venedor (Settings > API key al teu compte de venedor) i cal abans de poder fer servir Test Connection o sincronitzar.
  • Shop. Es veu a la fitxa i en aquest grup. És un identificador opcional per a entorns multibotiga. Segons la seva ajuda, Test Connection l'omple automàticament quan Mirakl exposa la botiga del venedor.

Pestanya Finances

Aquí hi ha la comptabilitat de les liquidacions. A la pestanya Finances hi ha dos grups.

Grup Comptabilitat de liquidacions

  • Settlement Journal. Un diari entre diversos per comptabilitzar els apunts de liquidació de Mirakl. Si el deixes buit, es crea un diari dedicat, Mirakl Settlements, en el primer ús. Tria'n un de teu si prefereixes que no es creï aquest.
  • Marketplace Clearing Account. Un compte pont del balanç que representa el que el marketplace et deu per les comandes: la carreguen les vendes i s'abona quan la liquidació fa el pagament.
  • Commission Expense Account. El compte de despeses per a la comissió i les tarifes del marketplace.
  • Payout / Bank Suspense Account. Es carrega amb el pagament net que et transfereixen i després es concilia amb l'ingrés bancari real: a mà a Community, amb sincronització bancària a Enterprise, segons la seva ajuda.

Grup Opcions

  • Analytic Account. Opcional. Serveix perquè les liquidacions d'aquest marketplace alimentin un P&L per canal als informes analítics d'Odoo. Posa-la si vols aquesta lectura per canal.
  • Auto-post settlements. Crea automàticament l'assentament comptable quan s'importa una liquidació. Ve desactivada per defecte: marca-la només si vols aquest assentament en importar.

Pestanya IA (opcional)

  • Enable AI insights. És a la pestanya AI (optional) i ve desactivada. Amb Odoo en català, la seva ajuda diu 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. Si no la necessites, deixa-la tal com està.
Esquema amb el text d'ajuda del camp d'anàlisi d'IA en cinc idiomes
Esquema fet amb codi a partir de les traduccions publicades del mòdul (no és una captura d'Odoo): l'ajuda de Enable AI insights en castellà, alemany, francès, italià i portuguès.

Revisió abans de donar la instància per bona

  • Comprova que Base Url i API Base URL apunten al mateix operador; normalment la segona és la primera més /api, com als exemples de l'ajuda.
  • Si la teva instància fa servir la connexió Directa, confirma que Base Url i Api Key estan omplertes abans d'intentar provar la connexió o sincronitzar.
  • Després de provar la connexió, mira Shop: la seva ajuda diu que s'omple sola quan Mirakl exposa la botiga del venedor.
  • Repassa amb el teu comptable els comptes del grup Settlement Accounting.

Preu i ajuda amb la posada en marxa

El mòdul és de pagament únic per versió d'Odoo i està publicat a Odoo Apps per a 17, 18, 19 i 20 (consulta la fitxa d'Odoo Apps o la pàgina del mòdul). Necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 € al mes o 490 € a l'any, sense IVA, fins a 3 comptes de la plataforma. La connexió passa per FlexigoTech Cloud, que desa xifrades les credencials, vigila la sincronització i avisa per correu si falla. Amb la subscripció, el mòdul per a les versions noves d'Odoo va inclòs si el vas comprar a flexigotech.com; a l'Odoo App Store, cada versió d'Odoo es compra allà.

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. Si vols que revisem amb tu la fitxa de la teva instància, escriu-nos.

Continua llegint

Camps d'Instància de Mirakl a Mirakl Connector: què signifiquen i què posarGuia comparada dels camps de la fitxa Instàncies de Mirakl a Mirakl Connector per a Odoo: què diu cada ajuda, el seu valor per defecte i què posar-hi.Els camps de la instància de Mirakl a Odoo: què vol dir cadascun i què posar-hiGuia dels camps de la instància de Mirakl Connector per a Odoo: enviament, descompte, comissió, idioma, factures i sincronització, segons la seva ajuda.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts