Qué hace el botón «Encolar sync de cache de referencias» de Temu Connector for Odoo

Un caso para seguir el botón de principio a fin

Ejemplo Caso ilustrativo: la empresa y sus datos son inventados para explicar el flujo.

Imagina una tienda inventada, Hogar Levante, que acaba de instalar Temu Connector for Odoo y quiere que Odoo vuelva a leer desde cero las categorías de referencia de Temu. Quien administra Odoo abre el menú Temu, entra en la ficha de su instancia (la reconoce por el campo Name) y pulsa Encolar sync de cache de referencias. Lo que sigue es lo que ocurre por dentro, según el código del módulo en Odoo 19.

El botón está en la pantalla Temu Dashboard en las ramas 17, 18 y 19 del módulo. La vista no le impone condición alguna: se ve siempre.

Lo que Odoo hace solo, sin pulsar nada

Pulsar el botón no es el camino normal. La tarea programada Temu Sync Reference Cache se ejecuta cada cinco minutos y está activa desde la instalación del módulo. Esa tarea llega a la rutina que va leyendo la cola de categorías: si hay una cola guardada, sigue por ella, y si la cola está vacía, parte del punto de partida (el nivel inicial de Temu).

El botón es la excepción: sirve para pedir a mano un arranque desde cero y para que la tarea no espere a su próximo turno.

Paso a paso: qué ocurre al pulsar el botón

1. El botón trabaja sobre la ficha abierta. Anota la hora de la petición y deja la sincronización como pendiente.
2. Borra lo que dejara una ejecución anterior: la hora de inicio, la de fin, el error, el resumen y la marca de sincronización de los datos que no son categorías.
3. Reinicia la cola de categorías con un único punto de partida, vacía la lista de categorías ya visitadas y pone a cero el contador de procesadas.
4. Busca la tarea programada Temu Sync Reference Cache. Si existe y está desactivada, la activa, salvo en una base de datos neutralizada, donde la deja apagada. Si la tarea no tenía próxima ejecución o la tenía en el futuro, la fija para ahora.
5. Publica el texto del aviso como mensaje en el chatter de la ficha y muestra una notificación en pantalla.

Nada de esto lee todavía las categorías de Temu: el botón solo prepara el terreno y despierta la tarea.

Cuándo la notificación es una advertencia

Si todo va bien, la notificación es de éxito. En los casos siguientes sale como advertencia, y esa advertencia se queda en pantalla hasta que la cierras:

• Base de datos neutralizada con la tarea apagada. El botón nunca vuelve a encender una tarea programada en una copia neutralizada. La petición queda anotada, pero la tarea sigue apagada y no se pondrá en marcha sola: tendrás que ejecutar a mano la tarea programada Temu Sync Reference Cache, como indica el propio aviso.
• La tarea programada no existe. El botón deja anotada la petición y no tiene a quién despertar. El aviso indica que hay que actualizar el módulo para crearla.

En ambos casos el mismo texto del aviso queda también en el chatter de la ficha, así que puedes consultarlo después.

Qué hace la tarea cuando recoge la cola

Cada pasada de la tarea trabaja así, según el código:

• Saca nodos de la cola hasta alcanzar un límite de nodos por pasada o un presupuesto de tiempo, lo que llegue antes.
• Salta los nodos que ya figuran como visitados.
• Pide a Temu las categorías hijas de cada nodo.
• Si el nodo ya tenía registro, lo marca como hoja según haya o no filas en la respuesta.
• Crea o actualiza un registro por cada categoría recibida, identificada por la instancia y el identificador de Temu. Guarda nombre, nivel, estado de disponibilidad, tipo, padre y la respuesta original.
• Añade a la cola las categorías hijas, salvo que sean el propio padre, ya estén visitadas o ya estén en cola. Se procesan en esta misma pasada o en una posterior, según se alcance antes o no el límite de nodos o el de tiempo.
• Al terminar guarda la cola, la lista de visitadas y suma las procesadas al contador.

La pasada devuelve también si la cola se ha vaciado.

Un detalle que conviene saber

Si la consulta a Temu no devuelve filas, el nodo se trata como si no tuviera hijas. Eso vale tanto si de verdad no hay categorías hijas como si la llamada falló: en ese segundo caso, el código puede dejar un aviso en el registro del servidor. Si el nodo tenía registro, queda marcado como hoja. Merece la pena mirar ese registro si un nodo sale como hoja y no lo esperabas.

Qué comprobar después en el caso de Hogar Levante

• Que el chatter de la ficha tenga el mensaje de la petición.
• Que la tarea Temu Sync Reference Cache esté activa. Si la base de datos es una copia neutralizada, seguirá apagada y habrá que ejecutarla a mano, como indica el aviso.
• Que, pasados unos minutos y con la tarea activa, haya empezado a procesar la cola.

Qué aprender del caso

• El botón reinicia y encola; la lectura de Temu la hace la tarea programada.
• Reinicia el estado y la cola, así que úsalo cuando quieras volver a empezar, no para un simple repaso.
• Las advertencias tienen que ver con la tarea programada, no con Temu.

Coste y ayuda

Temu Connector for Odoo es un módulo 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. El módulo está publicado en Odoo Apps para 17, 18, 19 y 20; tienes más datos en la ficha de Odoo Apps y en la página del módulo.

Si necesitas implantar Odoo con Temu o una integración a medida, FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones.

Sigue leyendo

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

Fuentes

• Código del módulo: flexigobe_temu_connector 19.0 (455b3f0f): views/temu_instance_views.xml
• Código del módulo: flexigobe_temu_connector 19.0 (455b3f0f): models/temu_instance.py
• Código del módulo: flexigobe_temu_connector 19.0 (455b3f0f): models/fgt_cloud.py
• apps.odoo.com/apps/modules/19.0/flexigobe_temu_connector
• flexigotech.com/precios.html
• flexigotech.com/en/services.html