Dónde está el botón y cuándo se ve
¿Dónde está el botón y cómo se llama?
Se llega desde el menú Mirakl › Configuración › Marketplaces (Mirakl › Configuration › Marketplaces), que abre la pantalla Instancias de Mirakl (Mirakl Instances). El tramo Mirakl del menú solo lo ven los usuarios internos de Odoo: si no lo eres, no ves ese tramo. Con Odoo en castellano el botón se llama Obtener motivos de reembolso; en otros idiomas cambia el rótulo, como muestra el segundo esquema.


Obtener motivos de reembolso, en alemán Erstattungsgründe abrufen, en francés Récupérer les motifs de remboursement, en italiano Recupera motivi di rimborso y en portugués Obter motivos de reembolso.¿Cuándo aparece?
El botón se ve siempre en la pantalla Instancias de Mirakl, y está en Odoo 17, 18, 19 y 20. No depende de ningún estado ni de ninguna casilla de la ficha.
¿Para qué sirve?
Según el propio código del módulo, lista los códigos de motivo de reembolso del operador y los publica en el chatter de la instancia, para saber qué poner en Código de motivo de reembolso. El mismo código recuerda que Mirakl rechaza los reembolsos que no llevan un código válido del operador.

Qué hace al pulsarlo
¿Qué hace paso a paso?
Trabaja con la instancia que tienes abierta. Primero pide a Mirakl los motivos del operador. Después se queda con los motivos que le llegan y los convierte en una línea por motivo: código, etiqueta y, entre paréntesis, el tipo (un guion si el motivo no trae tipo). Por último escribe una nota en el chatter y muestra un aviso.
¿Qué motivos incluye la lista?
Primero filtra los motivos cuyo tipo contiene la palabra REFUND, sin distinguir mayúsculas de minúsculas. Si ninguno la contiene, publica todos los motivos que haya recibido. Si no queda ningún motivo que publicar, el botón se detiene con un error (más abajo).
¿Qué cambia en Odoo al terminar?
En el chatter de la instancia aparece una nota que empieza por Códigos de motivo del operador (usa el CÓDIGO en 'Código de motivo de reembolso'): (Operator reason codes (use the CODE in 'Refund Reason Code'):) y sigue con las líneas, una por motivo. Además sale un aviso titulado Mirakl con el texto … códigos de motivo publicados en el chatter. (… reason codes posted to the chatter.), donde los puntos suspensivos son el número de líneas publicadas; el aviso no queda fijo en pantalla. Cada pulsación hace una consulta nueva y añade otra nota, así que puedes volver a pulsar cuando quieras refrescar la lista.
¿Cómo compruebo que ha funcionado?
Abre el chatter de la instancia: ahí queda la nota con una línea por motivo. Esa línea lleva el código, que es lo que el propio código del módulo indica usar en Código de motivo de reembolso.
Errores y requisitos
¿Qué pasa si el operador no devuelve códigos?
La acción se detiene con el mensaje El operador no ha devuelto ningún código de motivo. Consulta los códigos en tu portal de vendedor del marketplace. (The operator returned no reason codes. Check the codes in your marketplace seller portal instead.) No se publica ninguna nota. Lo que toca hacer es lo que dice el propio mensaje: mirar los códigos en tu portal de vendedor del marketplace.
¿Y si falla la conexión con Mirakl?
Al pulsar el botón pueden salir Error de conexión al llamar a Mirakl: … (Connection error calling Mirakl: …) y La solicitud de Mirakl falló tras los reintentos. (Mirakl request failed after retries.) Estos mensajes vienen de la petición a Mirakl, que el módulo repite ante algunas respuestas temporales del servidor antes de rendirse. En ese caso la acción se detiene antes de escribir la nota en el chatter. Como cada pulsación hace una consulta nueva, puedes volver a pulsar el botón.
¿Qué cuesta y qué necesita?
Mirakl Connector es un módulo de pago único por versión, publicado en Odoo Apps para Odoo 17, 18, 19 y 20; el precio de cada versión está en su ficha y la compra directa, en la página del módulo. Además necesita la suscripción a FlexigoTech Cloud, plan Conector: 49 €/mes o 490 €/año sin IVA, hasta 3 cuentas de la plataforma (el plan Pro, 98 €/mes o 980 €/año, hasta 10). La conexión pasa por FlexigoTech Cloud, que guarda cifradas las credenciales y avisa por correo si la sincronización falla. Sin suscripción, o con el servicio suspendido, se para lo que da la suscripción; los datos se quedan en tu Odoo.
Otras llamadas a Mirakl y cómo te ayudamos
Este botón es la consulta de motivos de reembolso. El módulo también llama a Mirakl en otros momentos, con otras peticiones: al validar un albarán puede llamar a Mirakl para leer el pedido o enviar el seguimiento, y la tarea programada Mirakl - Sincronizar pedidos (Mirakl - Sync Orders) corre cada diez minutos y está activa al instalar.
Si estás implantando Odoo y quieres conectar un marketplace Mirakl, FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida.
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_mirakl_connector 20.0 (aa05e537): views/mirakl_instance_views.xml
- Código del módulo: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
- Código del módulo: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_api_mixin.py
- Código del módulo: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- flexigotech.com/precios.html
- flexigotech.com/en/services.html
