Qué hace «Ejecutar reparación automática de errores» en Amazon Connector para Odoo

Antes de pulsar: lo que Odoo ya repara solo

En Odoo 20, con los valores por defecto, la tarea programada SP-API de Amazon - Cola de reparación automática v2 (Amazon SP-API - Auto-repair queue v2) corre cada 3 minutos y está activa desde la instalación. Procesa los reintentos en cola con las mismas piezas que usa el botón: corrige unit_count si hay una incidencia de ese tipo, repara el contenido multimedia de conformidad (compliance_media) si la incidencia es de imagen y, si la publicación sigue en error y no tiene ninguna de esas dos incidencias, intenta enviar el catálogo completo, siempre que esté activo el ajuste de la cuenta que permite intentar publicar el catálogo completo (activo por defecto en el código).

Además, cuando falla un envío de existencias, el módulo mira las incidencias guardadas de esa publicación y repara las de unit_count o de imagen. Si la reparación sale bien, vuelve a enviar las existencias; si Amazon aún no ha terminado de validarla, deja el envío en cola. A ese envío se llega al guardar una ficha de producto, al validar un albarán que afecte a productos y en la tarea Amazon SP-API - Sync pendientes (precio/stock) (Amazon SP-API - Sync pending bindings (price/stock)), que corre cada minuto.

El botón es la vía manual: lanza esa reparación de una vez sobre las publicaciones activas en error de la cuenta y de su marketplace.

• Revisa la casilla Los reintentos de reparación se ejecutan en segundo plano (opcional) (Repair retries run in the background (opt-in)) en la ficha de Cuentas (Accounts), pestaña Catálogo y listings (Catalog & Listings), grupo Reparar errores de listing automáticamente (Auto-repair Listing Errors). Su ayuda dice «Activa reintentos en cola para errores transitorios (ej. accepted sin estado final).» y viene activa por defecto. Con ella activa, el botón programa reintentos en los casos que quedan pendientes.

Cuándo aparece y quién puede pulsarlo

• Tu usuario es Responsable (Manager) del conector o tiene acceso de Ajustes. La ruta es Amazon › Configuración › Cuentas (Amazon › Configuration › Accounts): los tramos Configuración y Cuentas piden Responsable, y Amazon pide Lector (Viewer).

• Abre la pantalla de Cuentas: el botón Ejecutar reparación automática de errores se ve sin condición, en las versiones 17, 18, 19 y 20.

Al pulsar: qué hace con cada publicación

En Odoo 20, el botón hace esto:

• Permisos. Lo primero es comprobar tu acceso. Si no eres Responsable ni tienes acceso de Ajustes, se detiene con You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access. y no se guarda nada. También comprueba que puedes escribir en la cuenta.
• Selección. Busca las publicaciones (bindings) de esa cuenta, del marketplace que indica la cuenta (ID del marketplace (Marketplace ID), pestaña Identidad (Identity)), que estén activas y en error.
• Lectura previa. Si la cuenta tiene activa la lectura previa del catálogo (un ajuste activo por defecto en el código), vuelve a leer la publicación en Amazon. Si esa lectura falla, lo anota y pasa a la siguiente.
• ASIN. Si Amazon todavía no ha devuelto el ASIN de la publicación, el botón no la repara: cuenta como no resuelta y deja una nota. La lectura previa es la que puede traer ese ASIN.
• Incidencias guardadas. Relee las incidencias guardadas y recalcula en la publicación los contadores de errores, avisos e información. Si no queda ningún error bloqueante, la publicación deja de estar en error, se limpia su reintento pendiente si lo tenía y cuenta como resuelta.
• unit_count. Si alguna incidencia es de unit_count, lanza su corrección. Según el resultado, cuenta como corregida, pendiente (y en cola si hay reintento programado) o con error. Si Amazon aún no ha dado estado final, queda pendiente y, con la casilla de segundo plano activa, se programa un reintento.
• Imágenes. Si alguna incidencia es de imagen, busca el tipo de producto (si la publicación no lo tiene, lo lee de Amazon) e intenta quitar las entradas de compliance_media con URL temporal o caducada y, si lo consigue, vuelve a leer la publicación. Si no hay nada que limpiar o Amazon lo rechaza, queda como nota.
• Publicación. Solo si el ajuste de publicar el catálogo completo está activo (lo está por defecto en el código), la publicación sigue en error y no tuvo incidencia de unit_count ni de imagen, envía el catálogo completo a Amazon. Si falla, lo cuenta, lo anota y, con la casilla de segundo plano activa, programa un reintento.
• Lectura final y resumen. Vuelve a leer la publicación (si falla, solo lo anota) y la da por no resuelta si sigue en error o con errores. Al terminar guarda en la cuenta la fecha y el resultado, y publica el resumen en el chatter de la cuenta.

Después de pulsar: qué comprobar

El resumen empieza por Auto-repair de errores de listing finalizado. (Listing error auto-repair finished.) y Cuenta: …, y sigue con estas líneas:

Si hay notas, aparecen tras Notas (ultimas 15):, con las últimas y cada una recortada.

• Abre el mensaje del chatter de la cuenta y compara Bindings evaluados con resueltos y no resueltos.

• Lee las notas: indican en qué publicación y en qué paso (lectura, unit_count, imagen, publicación) quedó algo sin arreglar.

• En cada publicación no resuelta, abre su ficha de Listings, pestaña Incidencias (Issues), grupo Cola de reparación (Repair Queue). El campo Reintento de reparación automática pendiente (Auto Repair Retry Pending, solo lectura) lo marca el módulo al programar un reintento; se vacía cuando la publicación se resuelve o cuando se agotan los reintentos.

• Si quedan pendientes o reintentos programados, la tarea de la cola corre cada 3 minutos: vuelve a mirar la ficha de la publicación más tarde.

Cómo ayuda FlexigoTech

El módulo es de pago único por versión de Odoo (publicado para 17, 18, 19 y 20) y necesita la suscripción a FlexigoTech Cloud, plan Conector: 49 €/mes o 490 €/año sin IVA, hasta 3 cuentas de la plataforma. Tienes la ficha en Odoo Apps y la página del módulo. 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_amazon_seller_connector 20.0 (8576afa5): views/amazon_spapi_account_views.xml
• Código del módulo: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_account.py
• Código del módulo: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_product_binding.py
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/precios.html
• flexigotech.com/en/services.html