Qué rellenar antes de la primera sincronización
¿Qué necesito tener contratado y para qué versiones de Odoo está?
El módulo está publicado en Odoo Apps para Odoo 17.0, 18.0, 19.0 y 20.0 y cuesta 9 € por versión de Odoo, pago único, sin IVA; si lo compras en el Odoo App Store, cada versión de Odoo se compra allí. La conexión con Leroy Merlin necesita además el plan Conector de FlexigoTech Cloud (49 €/mes o 490 €/año sin IVA, hasta 3 cuentas de la plataforma; el plan Pro, 98 €/mes o 980 €/año sin IVA, llega a 10). FlexigoTech Cloud guarda cifradas las credenciales, vigila la sincronización y avisa por correo si falla.
¿Qué campos de configuración tengo que revisar uno por uno?
Estos son los que conviene mirar antes de lanzar nada, con su etiqueta y su nombre técnico para que los encuentres:
Create Sales Orders From(sale_order_start_date), un campo de fecha y hora.Fallback Customer(default_partner_id), que apunta a un cliente de Odoo.Manual Text Language(text_language_code) yEffective Text Language(effective_text_language_code), dos campos de texto sobre el idioma.Mirakl Odoo Root Category(mirakl_category_root_id), que apunta a una categoría de Odoo.
Ten en cuenta también que varios registros del módulo llevan un campo que los enlaza con la instancia (instance_id o leroy_mirakl_instance_id, ambos hacia leroy.mirakl.instance). Por eso, en las listas del conector verás una columna de instancia con el valor Leroy Merlin.
¿Qué fecha pongo en Create Sales Orders From?
Según la descripción del campo, los pedidos de Mirakl creados antes de esa fecha se importan (en Orders) pero nunca se convierten en pedidos de venta. Así que, antes de conectar, decide desde qué momento quieres que los pedidos de Leroy Merlin generen pedidos de venta en tu Odoo y pon esa fecha. Los pedidos anteriores seguirán entrando como pedidos Mirakl, sin pedido de venta.
¿Qué pongo en Manual Text Language?
El campo guarda el código de idioma de Odoo que se usa en modo manual, por ejemplo en_US, fr_FR o pt_PT. Si trabajas en modo manual, escribe ahí el código del idioma tal cual lo tiene Odoo, con el mismo formato que los ejemplos. El módulo tiene además el campo Effective Text Language; míralo junto al anterior cuando repases la configuración.
¿Para qué sirve Mirakl Odoo Root Category?
Según su descripción, es la categoría raíz de Odoo que se usa para reflejar las rutas de categorías de Mirakl en esta instancia. Elige o crea en Odoo la categoría que quieras usar como raíz y asígnala en la instancia antes de traer el catálogo.


Catálogo y mapeos: categorías, atributos y transportistas
¿Dónde veo el catálogo que trae Leroy Merlin?
El módulo guarda el catálogo de Mirakl en tres modelos propios: categorías (leroy.mirakl.catalog.category), atributos (leroy.mirakl.catalog.attribute) y valores (leroy.mirakl.catalog.value). En la lista de categorías ves el camino de cada una, su código y si es hoja; en la de atributos, su código, etiqueta, tipo, código de lista de valores y si es requerido o multivalor. Repasa esta segunda lista con calma: las columnas requerido y multivalor te dicen qué atributos marca así Mirakl.

¿Qué mapeos tengo que preparar?
El módulo tiene dos modelos de mapeo: el de categorías (leroy.mirakl.category.map) y el de transportistas (leroy.mirakl.carrier.map), además de una lista de transportistas disponibles (leroy.mirakl.available.carrier). En el mapeo de categorías, cada fila une una categoría de producto de Odoo con un código de categoría de Mirakl, su etiqueta y su ruta. En el de transportistas, cada fila lleva el portador, el código de operador y el nombre del transportista. Comprueba que las filas que vas a usar tienen marcada la casilla Activo.

La primera semana: estados y pedidos
¿Qué estados tiene el seguimiento y cuál vigilo?
El campo leroy_mirakl_tracking_state solo admite tres valores: pending (Pending), synced (Synced) y error (Error). La primera semana, filtra a diario los registros en Error y no los dejes acumularse; si no entiendes el mensaje que acompaña al fallo, tienes los textos explicados en los mensajes de error de Leroy Merlin Connector.
¿Qué miro en un pedido Mirakl importado?
Abre algunos pedidos Mirakl de los primeros días y revisa el formulario completo: datos del pedido, importes, estado, el pedido de venta enlazado y la sección Aceptación. Arriba aparecen los botones Cancelar y Reembolso en Mirakl. Si un pedido es anterior a la fecha de Create Sales Orders From, recuerda que no tendrá pedido de venta.

¿Qué pasa si la sincronización falla o se corta la suscripción?
Si la sincronización falla, FlexigoTech Cloud avisa por correo, y si Leroy Merlin cambia su API se adaptan el módulo y el servicio. Sin suscripción, o con el servicio suspendido, se para lo que da la suscripción, pero los datos se quedan en tu Odoo.
Cómo te ayuda FlexigoTech
Si prefieres no hacer la puesta en marcha solo, en FlexigoTech implantamos Odoo 17, 18, 19 y 20 y desarrollamos conectores e integraciones a medida. Podemos revisar contigo los campos de configuración, los mapeos y la primera semana de pedidos. Si quieres entender antes qué hace el conector por dentro, lee cómo funciona Leroy Merlin Connector.
Sigue leyendo
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas
Fuentes
- Código del módulo: flexigobe_leroy_merlin_connector 20.0 (fb656d53): models/leroy_mirakl_carrier_map.py
- Código del módulo: flexigobe_leroy_merlin_connector 20.0 (fb656d53): models/leroy_mirakl_category_map.py
- Código del módulo: flexigobe_leroy_merlin_connector 20.0 (fb656d53): models/leroy_mirakl_instance.py
- Código del módulo: flexigobe_leroy_merlin_connector 20.0 (fb656d53): models/leroy_mirakl_instance_advanced.py
- Código del módulo: flexigobe_leroy_merlin_connector 20.0 (fb656d53): models/sale_order.py
- Código del módulo: flexigobe_leroy_merlin_connector 20.0 (fb656d53): models/stock_picking.py
- apps.odoo.com/apps/modules/20.0/flexigobe_leroy_merlin_connector
- apps.odoo.com/apps/modules/17.0/flexigobe_leroy_merlin_connector
- apps.odoo.com/apps/modules/18.0/flexigobe_leroy_merlin_connector
- apps.odoo.com/apps/modules/19.0/flexigobe_leroy_merlin_connector
- flexigotech.com/en/services.html
- flexigotech.com/precios.html
