La tarea «Mirakl - Sincronizar devoluciones» de Mirakl Connector: qué hace y qué mirar

Qué hace la tarea en cada pasada

La tarea programada Mirakl - Sincronizar devoluciones está en todas las versiones publicadas de Mirakl Connector (Odoo 17, 18, 19 y 20), corre cada 30 minutos y viene activa al instalar.

En Odoo 20.0, en cada pasada, la tarea comprueba que quien la ejecuta es administrador, busca los marketplaces activos con la sincronización de devoluciones activada, se queda con los que puede llamar y, para cada uno, pide sus devoluciones al marketplace por páginas y procesa una a una las que llegan. Las fichas de los marketplaces se abren desde el menú Mirakl › Configuración › Marketplaces (Mirakl › Configuration › Marketplaces); para ver el menú Mirakl basta con ser usuario interno de Odoo.

Con Odoo en castellano la tarea se llama Mirakl - Sincronizar devoluciones; el esquema siguiente recoge su nombre en otros idiomas.

Cómo se comporta la tarea

Corre cada 30 minutos y exige un administrador

La frecuencia es cada 30 minutos. En Odoo 17.0 la tarea se repite sin fin. En Odoo 20.0, lo primero que hace cada pasada es comprobar el usuario: si se lanza con alguien que no es administrador, se detiene con Solo un administrador puede ejecutar esta acción planificada. (Only an administrator can run this scheduled action.) y no se procesa ningún marketplace.

No todos los marketplaces entran en la pasada

En Odoo 20.0, la búsqueda parte de los marketplaces activos con la sincronización de devoluciones activada; el resto no se toca. Después, el módulo filtra los que puede llamar: primero los de conexión directa y luego los que van por FlexigoTech Cloud, y de estos solo los que tienen una clave guardada. Además, si el permiso guardado no incluye el servicio del módulo (esto se comprueba sin salir a la red), ninguno de los de FlexigoTech Cloud se llama en esa pasada. Los de conexión directa siguen su curso.

Una pausa de FlexigoTech Cloud corta el resto de la pasada

Si FlexigoTech Cloud no deja pasar la petición (porque no hay suscripción o hay una pausa del servicio), no se marca ni se borra nada y la pasada se corta ahí: los marketplaces que quedaban esperan a la siguiente, que sigue su curso. Por eso los de conexión directa van primero: una pausa no deja a ninguno de ellos sin atender. La pausa solo cuenta para el informe de salud de FlexigoTech Cloud, con códigos y nunca texto. Sin suscripción, o con el servicio suspendido, se para lo que da la suscripción; los datos se quedan en tu Odoo.

Un fallo en un marketplace no frena a los demás

Cualquier otro error en un marketplace se anota en el registro del servidor de Odoo y el módulo intenta dejar una línea de registro de tipo error con el texto del error; después pasa al siguiente marketplace. Si ni siquiera se puede escribir esa línea, el módulo deja un aviso en el registro del servidor, y ese fallo del registro no sustituye al error original.

Si el marketplace responde con un 404 a las devoluciones

Si el marketplace responde con un 404 (HTTP 404) a la petición de devoluciones, el módulo deja una línea de registro de tipo aviso con el texto Endpoint de devoluciones no disponible (HTTP 404). (Returns endpoint not available (HTTP 404).). Después, si el marketplace tiene activado el respaldo por pedidos, el módulo pasa a otro método de sincronización; si no, adelanta a este momento la marca de última sincronización de devoluciones y termina sin procesar nada.

Una respuesta que el conector no reconoce no es una página vacía

Si llega una página sin devoluciones, la pasada de ese marketplace termina. Pero si la respuesta tiene una forma que el conector no reconoce, el módulo deja una línea de registro de tipo error y no adelanta la ventana de sincronización, para no pasar de largo devoluciones que no ha leído.

Páginas, tope y cuándo se para

La tarea pide páginas de un tamaño fijado, procesa cada devolución y la cuenta. Se detiene cuando una página trae menos devoluciones que el tamaño de página, cuando ya ha leído el total que anuncia el marketplace o cuando llega al tope de páginas por pasada (como mínimo, una página).

Qué mirar si no parece hacer nada

• La tarea aparece entre las acciones planificadas de Odoo con el nombre Mirakl - Sincronizar devoluciones y está activa.
• El marketplace está activo y con la sincronización de devoluciones activada; si no, no entra en la búsqueda (sus fichas se abren desde Mirakl › Configuración › Marketplaces).
• Si se conecta por FlexigoTech Cloud, tiene una clave guardada y el servicio está vigente. FlexigoTech Cloud vigila la sincronización y avisa por correo si falla.
• Si otro marketplace de la misma pasada dio una pausa de FlexigoTech Cloud, la pasada se cortó y los que quedaban esperan a la siguiente.
• Si el marketplace respondió con un 404, busca una línea de registro de tipo aviso con el texto Endpoint de devoluciones no disponible (HTTP 404).
• Si hay una línea de registro de tipo error, lee su texto: es el error de ese marketplace.

Cómo ayuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida. Mirakl Connector es un módulo de pago único por versión y necesita la suscripción a FlexigoTech Cloud (plan Conector: 49 € al mes o 490 € al año, sin IVA). Puedes ver el módulo en su página o en la ficha de Odoo Apps.

Sigue leyendo

Comprobado en el código del conector (versión 17.0 y 20.0) y en las fuentes enlazadas

Fuentes

• Código del módulo: flexigobe_mirakl_connector 20.0 (aa05e537): data/ir_cron_data.xml
• Código del módulo: flexigobe_mirakl_connector 17.0 (e430de3e): data/ir_cron_data.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_ai.py
• apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html