Saltar al contenido principal
Mirakl

Qué añade Mirakl Connector al pedido de venta de Odoo (Ventas)

Mirakl Connector añade al pedido de venta una pestaña Mirakl con la instancia, el pedido, su estado, la última sincronización y los datos de envío y contacto, y solo se ve cuando el pedido trae un Pedido de Mirakl. Además cambia lo que pasa al borrar el pedido, al guardar cambios en sus direcciones y al facturarlo.

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

Qué toca el módulo en Ventas

El módulo amplía el pedido de venta estándar de la app Ventas (Sales) de Odoo. Lo que añade son campos en la ficha, uno de ellos también en la lista de pedidos, y ajustes de comportamiento en el código del pedido. Esto es lo que conviene saber antes de abrir el primer pedido que llegue de un marketplace.

Esquema hecho con código: la app Ventas arriba y, debajo, los campos que le añade Mirakl Connector
Esquema generado a partir del código del módulo, no es una pantalla de Odoo. Los rótulos van en inglés, el texto original del código.
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)

Detalles que no se ven en la ficha

Los campos no aparecen hasta que el pedido tiene Pedido de Mirakl

Los campos del módulo están en la ficha del pedido de venta, en la pestaña Mirakl, repartidos en dos grupos: Marketplace y Envío y contacto (Shipping & Contact). Todos se ocultan mientras Pedido de Mirakl (Mirakl Order) esté vacío, así que en un pedido sin ese valor no verás nada de esto.

En el grupo Marketplace están Instancia de Mirakl (Mirakl Instance), Pedido de Mirakl, Estado de pedido de Mirakl (Mirakl Order State) y Última sincronización de Mirakl el (Mirakl Last Sync At). Los cuatro son de solo lectura: se consultan, no se editan.

Esquema hecho con código con el texto del grupo Marketplace en otros idiomas: Marktplatz, Place de marché y Marktplaats
Esquema generado a partir de las traducciones del módulo, no es una pantalla de Odoo. Con Odoo en alemán el grupo se ve como Marktplatz, en francés como Place de marché y en neerlandés como Marktplaats.

El email del cliente puede ser un relé anonimizado

Email del cliente Mirakl (Mirakl Customer Email) está en el grupo Envío y contacto y es de solo lectura. Según su ayuda, no siempre guarda el correo real del comprador: cuando existe, guarda el relé anonimizado que Mirakl crea para cada pedido, y lo que se envía ahí llega al comprador. Si no hay relé, guarda el correo del cliente que trae el pedido.

El teléfono y la persona de contacto tienen su propia lógica

Teléfono del cliente Mirakl (Mirakl Customer Phone) recoge el teléfono que el comprador indicó en el marketplace, para tenerlo a mano desde el propio pedido. Según su ayuda, también se guarda en el contacto de entrega. Es de solo lectura.

Persona de contacto Mirakl (Mirakl Contact Person) tiene una condición más. Solo se ve si el pedido tiene Pedido de Mirakl y además el propio campo tiene valor. Su ayuda dice que contiene la persona que hizo el pedido cuando el marketplace envía además un nombre de empresa, y que en ese caso la empresa se usa como nombre del contacto de entrega. Si no lo ves, el campo está vacío en ese pedido.

El método de envío también sale en la lista de pedidos

Método de envío Mirakl (Mirakl Shipping Method) está en Envío y contacto y, a diferencia del resto, aparece también en la lista de pedidos de venta. Su ayuda dice que es el método de envío que el comprador eligió en el marketplace (por ejemplo, Estándar o Día siguiente) y que queda vacío cuando el operador no lo envía.

Un campo vacío aquí, por tanto, no indica un fallo: es lo que ocurre cuando el operador no manda ese dato.

Borrar un pedido de Mirakl lo deja borrado

El módulo cambia lo que ocurre al eliminar un pedido de venta. Según el código de Odoo 20, antes de borrarlo busca los pedidos de Mirakl enlazados a él. Si el pedido de venta tiene Pedido de Mirakl, busca también el pedido de Mirakl con ese identificador en su misma instancia, lo que cubre un presupuesto que nunca llegó a enlazarse. Después de borrar, marca esos pedidos de Mirakl como borrados.

La razón está en un comentario del propio código: un pedido de venta borrado debe seguir borrado, porque el pedido de Mirakl lo recuerda y una nueva sincronización no lo crea ni lo confirma automáticamente otra vez.

Cambiar cliente o direcciones en un pedido de Mirakl

En Odoo 20, cuando guardas cambios en el cliente, en la dirección de entrega o en la dirección de facturación de un pedido con Pedido de Mirakl, el módulo hace ese guardado de forma distinta al estándar. En pedidos sin Pedido de Mirakl, el guardado es el estándar.

La factura puede salir simplificada o completa según la instancia

Al preparar la factura desde el pedido, el módulo mira el ajuste de tipo de factura española de la instancia de Mirakl del pedido (código de Odoo 20). Ese ajuste vive en la instancia, no en el pedido; lo repasa Los campos de Instancia de Mirakl en Mirakl Connector.

  • Si el pedido no tiene instancia, o el ajuste está en automático, la factura se prepara como en Odoo estándar.
  • Si la localización española de Odoo no está instalada (las facturas no tienen el campo de factura simplificada), tampoco se toca nada.
  • Si el ajuste es simplificada, la factura se marca como simplificada. Si es completa, se marca como no simplificada.

Cómo encaja con el resto y qué cuesta

El módulo es de pago único por versión y necesita la suscripción a FlexigoTech Cloud: plan Conector, 49 €/mes o 490 €/año sin IVA. La conexión pasa por FlexigoTech Cloud, que guarda cifradas las credenciales, vigila la sincronización y avisa por correo si falla. Está publicado para Odoo 17, 18, 19 y 20; en el Odoo App Store cada versión se compra allí. Más detalle en la ficha de Odoo Apps y en la página del módulo.

Si quieres que revisemos cómo queda el flujo de pedidos en tu Odoo, FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida.

Sigue leyendo

Checklist de la instancia de Mirakl Connector, campo a campoChecklist para rellenar la instancia de Mirakl Connector en Odoo: conexión, cuentas de liquidación y opciones, con lo que dice la ayuda de cada campo.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.
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas

Fuentes