La confusión más común con Mirakl es tratarlo como si fuera Amazon. No lo es. Mirakl es la plataforma que Decathlon, Leroy Merlin, Bricodepot, GACD y decenas de cadenas más usan para abrir su propio marketplace a vendedores externos. Para ti eso tiene una consecuencia muy buena y una regular.
La buena: la API es la misma para todos. Una integración bien hecha con Mirakl te vale para el primer operador y para el quinto, cambiando la URL del operador y la clave de API. La regular: encima de esa base común, cada operador pone sus reglas —su árbol de categorías, sus atributos obligatorios, sus plazos, sus penalizaciones, e incluso qué partes de la API tiene abiertas— y ésas no se comparten.
Lo que comparten todos
El ciclo es siempre el mismo: publicas ofertas (producto, precio, stock, plazo), el operador te manda pedidos, tú los aceptas o rechazas, envías con seguimiento y cobras por liquidación. El conector de Mirakl lleva ese ciclo a documentos normales de Odoo en 17, 18 y 19: publica ofertas con precio, stock y plazo de envío, importa los pedidos como pedidos de venta, los acepta (a mano o en automático si lo activas), manda a Mirakl el transportista y el número de seguimiento del albarán e importa las liquidaciones para asentarlas en contabilidad.
Detalle que sorprende: en Mirakl puedes rechazar líneas de un pedido. No es un fallo, es parte del protocolo. Nuestro conector no rechaza líneas sueltas: acepta el pedido entero. Si hay una línea que no puedes servir, recházala en el back office de Mirakl antes de aceptar, y ten en cuenta que la aceptación automática, que viene desactivada, acepta todo lo que entra.
Lo que cambia con cada operador
El árbol de categorías y los atributos obligatorios, que no se parecen entre una cadena de deporte y una de bricolaje. El plazo de aceptación, que en algunos operadores se mide en horas. Y la exigencia de datos del producto: hay operadores que rechazan una oferta si falta el EAN, y otros que además piden ficha técnica completa.
Por eso tenemos página por operador además de la del conector: Decathlon, Leroy Merlin, Brico Depot y GACD. El conector base es el mismo y cada operador es una instancia más, con su URL y su clave; para algunos operadores hay además un perfil complementario que deja puestos la URL y sus valores por defecto. Lo que cambia de verdad es la preparación del catálogo.
Lo que hay que preparar antes de pedir el alta
Tres cosas, y ninguna es técnica. EAN en todas las referencias que vayas a publicar: hay operadores que sin él no te aceptan la oferta. Un plazo de preparación que puedas cumplir de verdad, no el que te gustaría; prometer 24 horas y servir en 72 se paga en cuenta. Y fotos que cumplan su norma, que suele ser más estricta que la de tu propia web.
Y una advertencia por experiencia propia
Auditamos nuestro propio conector de Mirakl cuando su suite de pruebas pasaba en verde en Odoo 19, 18 y 17, y encontramos 18 fallos confirmados, entre ellos un registro de llamadas que nunca escribía nada y una sincronización que miraba la fecha equivocada. Lo contamos entero en auditar un conector heredado. Si te van a vender una integración de Mirakl, pregunta qué pasa cuando la API devuelve un error, no cuántos tests tiene.
Preguntas frecuentes
¿Un alta en Mirakl me abre todos los operadores?
No. Cada operador te acepta o no por separado, con su propio proceso comercial. Lo que se reutiliza es la integración técnica, no la relación comercial.
¿Puedo tener precios distintos por operador?
Sí, y deberías: las comisiones no son iguales. En el conector cada operador es una instancia, y cada instancia calcula su precio con su propia estrategia: precio de venta del producto, una tarifa de Odoo o coste más margen.
¿Qué pasa con las liquidaciones?
Llegan por operador y hay que conciliarlas contra las ventas, descontando comisión. Es la parte que más se descuida y donde más dinero se escapa sin que nadie lo note.
Enlaces útiles dentro de FlexigoTech
Lo que hacemos sobre esto
¿Te han aceptado en un marketplace de Mirakl?
Dinos qué operador y cuántas referencias quieres publicar. Revisamos si tu catálogo cumple lo que te van a pedir antes de que te lo rechacen. Escribe a comercial@flexigobe.com o agenda una llamada.