Saltar al contenido principal
Mirakl

Checklist de la instancia de Mirakl Connector, campo a campo

La ficha de instancia de Mirakl reúne la conexión, las cuentas de liquidación y unas opciones; aquí tienes, campo a campo, qué significa cada uno según su ayuda y qué conviene poner.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 5 de noviembre de 2026

Lo esencial

Módulo
Mirakl
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 20.0 · en las fuentes enlazadas al final
Lectura
5 min

Las fichas se abren desde el menú Mirakl › Configuración › Marketplaces (Mirakl › Configuration › Marketplaces), en la lista Instancias de Mirakl (Mirakl Instances).

Esquema con el menú Mirakl, Configuración, Marketplaces y los campos de la ficha de instancia
Esquema hecho con código a partir del código publicado del módulo (no es una captura de Odoo): el menú y los campos de la ficha.

Antes de tocar la ficha

  • Permiso. Para ver la clave hace falta ser Mirakl Manager: la ayuda de Clave de API dice que solo los Mirakl Managers pueden verla o cambiarla, y la Clave API de Mirakl (FlexigoTech Cloud) solo la ven los usuarios con ese permiso.
  • Cuenta de vendedor del marketplace. Ábrela en otra pestaña: de ahí sale el host del operador y la clave de API, según la ayuda de esos campos.
  • Suscripción. El módulo necesita la suscripción a FlexigoTech Cloud (plan Conector). El precio está 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 inglés)

Perfil del marketplace

  • Código de proveedor (Provider Code). Se ve en la ficha y también en la lista de Instancias de Mirakl. Es el perfil de marketplace/proveedor que usa la instancia; según su ayuda, al instalar los complementos de proveedor aparecen perfiles específicos del operador, como Leroy Merlin. El valor por defecto es Mirakl genérico (Generic Mirakl).

Pestaña Conexión, grupo Acceso

Estos campos están en la pestaña Conexión (Connection), grupo Acceso (Access).

  • Conexión con Mirakl (Mirakl connection). Es de solo lectura y vale FlexigoTech Cloud por defecto. Su ayuda dice que los marketplaces nuevos se conectan a través de FlexigoTech Cloud y que Directa (clave API guardada en Odoo) solo se mantiene para los que ya existían antes de esta versión, que siguen funcionando tal como se compraron. No hay nada que poner: solo comprueba qué ruta tiene tu instancia.
  • Clave API de Mirakl (FlexigoTech Cloud) (Mirakl API key (FlexigoTech Cloud)). Está en el grupo FlexigoTech Cloud. Con los valores por defecto se ve, y se oculta si la conexión no es la de FlexigoTech Cloud. Su ayuda dice que se envía una vez, cifrada, a FlexigoTech Cloud y que nunca se guarda en Odoo.
  • URL base (Base Url). Es el host real del operador. Su ayuda avisa de que Mirakl no proporciona un host universal compartido por todos los marketplaces. Para operadores conocidos se rellena sola; en otro caso, introdúcela desde tu cuenta de vendedor. Ejemplo de la ayuda: https://adeo-marketplace.mirakl.net. Es obligatoria antes de poder probar la conexión o sincronizar.
  • URL base de la API (API Base URL). Es la URL base real de la API para el operador elegido. Su ayuda dice que normalmente es la URL base más /api, con este ejemplo: https://adeo-marketplace.mirakl.net/api.
  • Clave de API (Api Key). Con los valores por defecto no se ve: se oculta cuando la conexión es FlexigoTech Cloud, así que aparece en las instancias con conexión Directa. Es la clave de API de vendedor (Settings > API key en tu cuenta de vendedor) y hace falta antes de poder usar Probar conexión o sincronizar.
  • Tienda (Shop). Se ve en la ficha y en este grupo. Es un identificador opcional para entornos multitienda. Según su ayuda, Probar conexión lo rellena automáticamente cuando Mirakl expone la tienda del vendedor.

Pestaña Finanzas

Aquí está la contabilidad de las liquidaciones. En la pestaña Finanzas (Finances) hay dos grupos.

Grupo Contabilidad de liquidaciones

  • Diario de liquidaciones (Settlement Journal). Un diario de varios para contabilizar los apuntes de liquidación de Mirakl. Si lo dejas vacío, se crea un diario dedicado, Liquidaciones de Mirakl, en el primer uso. Elige uno tuyo si prefieres que no se cree ese.
  • Cuenta puente del marketplace (Marketplace Clearing Account). Una cuenta puente del balance que representa lo que el marketplace te debe por los pedidos: la cargan las ventas y se abona cuando la liquidación realiza el pago.
  • Cuenta de gastos de comisiones (Commission Expense Account). La cuenta de gastos para la comisión y las tarifas del marketplace.
  • Cuenta puente de pago neto / banco (Payout / Bank Suspense Account). Se carga con el pago neto que te transfieren y después se concilia con el ingreso bancario real: a mano en Community, con sincronización bancaria en Enterprise, según su ayuda.

Grupo Opciones

  • Cuenta analítica (Analytic Account). Opcional. Sirve para que las liquidaciones de este marketplace alimenten un P&L por canal en los informes analíticos de Odoo. Ponla si quieres esa lectura por canal.
  • Contabilizar liquidaciones automáticamente (Auto-post settlements). Crea automáticamente el asiento contable cuando se importa una liquidación. Viene desactivada por defecto: márcala solo si quieres ese asiento al importar.

Pestaña IA (opcional)

  • Habilitar análisis de IA (Enable AI insights). Está en la pestaña IA (opcional) (AI (optional)) y viene desactivada. Con Odoo en castellano, su ayuda dice Opcional. El conector funciona completamente sin IA. Si no activas esto / no configuras una clave, nunca se realiza ninguna llamada de IA y nada cambia. Si no la necesitas, déjala como está.
Esquema con el texto de ayuda del campo de análisis de IA en cinco idiomas
Esquema hecho con código a partir de las traducciones publicadas del módulo (no es una captura de Odoo): la ayuda de Habilitar análisis de IA en castellano, alemán, francés, italiano y portugués.

Revisión antes de dar la instancia por buena

  • Comprueba que URL base y URL base de la API apuntan al mismo operador; normalmente la segunda es la primera más /api, como en los ejemplos de la ayuda.
  • Si tu instancia usa la conexión Directa, confirma que URL base y Clave de API están rellenas antes de intentar probar la conexión o sincronizar.
  • Tras probar la conexión, mira Tienda: su ayuda dice que se rellena sola cuando Mirakl expone la tienda del vendedor.
  • Repasa con tu contable las cuentas del grupo Contabilidad de liquidaciones.

Precio y ayuda con la puesta en marcha

El módulo es de pago único por versión de Odoo y está publicado en Odoo Apps para 17, 18, 19 y 20 (consulta la ficha de Odoo Apps o la página del módulo). Necesita la suscripción a FlexigoTech Cloud, plan Conector: 49 € al mes o 490 € al año, sin IVA, hasta 3 cuentas de la plataforma. La conexión pasa por FlexigoTech Cloud, que guarda cifradas las credenciales, vigila la sincronización y avisa por correo si falla. Con la suscripción, el módulo para las versiones nuevas de Odoo va incluido si lo compraste en flexigotech.com; en el Odoo App Store, cada versión de Odoo se compra allí.

FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida. Si quieres que revisemos contigo la ficha de tu instancia, escríbenos.

Sigue leyendo

Campos de Instancia de Mirakl en Mirakl Connector: qué significan y qué ponerGuía comparada de los campos de la ficha Instancias de Mirakl en Mirakl Connector para Odoo: qué dice cada ayuda, su valor por defecto y qué poner.Los campos de la instancia de Mirakl en Odoo: qué significa cada uno y qué ponerGuía de los campos de la instancia de Mirakl Connector para Odoo: envío, descuento, comisión, idioma, facturas y sincronización, según su ayuda.
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas

Fuentes