Saltar al contenido principal
Amazon

Tarea «Sincronizar informe de reembolsos FBA» de Amazon Connector: glosario

La tarea Amazon SP-API - Sincronizar informe de reembolsos FBA (opt-in) (Amazon SP-API - Sync FBA reimbursements report (opt-in)) corre una vez al día y viene activa al instalar. En cada pasada recorre las cuentas de Amazon activas con la sincronización de reembolsos FBA habilitada, pide un informe a Amazon, espera a que esté listo, entrega sus filas al importador y guarda el resultado en la cuenta.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 5 de noviembre de 2026

Lo esencial

Módulo
Amazon
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 17.0 y 20.0 · en las fuentes enlazadas al final
Lectura
6 min

La tarea existe, con el mismo nombre, en las ramas 17, 18, 19 y 20 de Amazon Connector for Odoo, FBA & FBM Seller SP-API.

Esquema con la tarea programada de reembolsos FBA, que corre una vez al día y viene activa al instalar, y el menú Amazon, Configuration, Accounts
Esquema hecho con código a partir del código publicado del módulo, no es una captura de Odoo. Los rótulos van en inglés, como en el código.

La tarea y su calendario

Tarea programada
La tarea Amazon SP-API - Sincronizar informe de reembolsos FBA (opt-in) trabaja sobre las cuentas de Amazon del módulo y ejecuta un método que las recorre. El rótulo lleva (opt-in): en el código, la tarea solo recorre las cuentas que tienen habilitada la sincronización de reembolsos FBA.
Frecuencia
Corre una vez al día, es decir, cada día, y viene activa al instalar el módulo. En Odoo 17 la tarea está definida para repetirse sin fin.
Cuenta incluida
En cada pasada la tarea busca las cuentas que están activas y tienen habilitada la sincronización de reembolsos FBA. Si una cuenta no cumple las dos condiciones, la tarea no la toca; si ninguna las cumple, no hay nada que recorrer.

Con Odoo en castellano, la tarea se llama Amazon SP-API - Sincronizar informe de reembolsos FBA (opt-in). El esquema recoge cómo se llama con Odoo en otros idiomas.

Esquema con el nombre de la tarea en castellano, alemán, francés, italiano y portugués
Esquema hecho con código a partir de las traducciones publicadas del módulo, no es una captura de Odoo. Castellano: Amazon SP-API - Sincronizar informe de reembolsos FBA (opt-in). Alemán: Amazon SP-API - FBA-Erstattungsbericht synchronisieren (Opt-in). Francés: Amazon SP-API - Synchroniser le rapport des remboursements FBA (opt-in). Italiano: Amazon SP-API - Sincronizza report rimborsi FBA (opt-in). Portugués: Amazon SP-API - Sincronizar relatório de reembolsos FBA (opt-in).
Your Odoo doesn't talk to Amazon, Temu or Shopify?
Vídeo: Your Odoo doesn't talk to Amazon, Temu or Shopify? (vídeo en inglés)

Qué hace en cada pasada con una cuenta

Petición del informe
Para cada cuenta, la pasada pide a Amazon que cree un informe de reembolsos. Con el identificador que Amazon devuelve sigue adelante; la línea ID del informe: … (Report ID: …) lo recoge en el resultado.
Consulta del estado
La pasada pregunta a Amazon por el informe hasta que su estado sea DONE, CANCELLED o FATAL, o hasta agotar los intentos. Entre un intento y el siguiente espera unos segundos. Si el número de intentos o la espera de la cuenta están vacíos o a cero, usa doce intentos y diez segundos de espera; como mínimo hace un intento y espera un segundo.
Estado reporte
La línea Estado reporte: … (Report status: …) muestra el último estado que dio Amazon, o UNKNOWN si no llegó ninguno. Si no es DONE, la pasada se detiene ahí y no importa nada. Con CANCELLED o FATAL añade Amazon no generó un informe de reembolsos utilizable. (Amazon did not generate a usable reimbursements report.). En cualquier otro estado añade Timeout haciendo polling del reporte. Reintenta en unos minutos. (Report polling timed out. Try again in a few minutes.).
Documento del informe
Con el informe en DONE, la pasada necesita el identificador de su documento. Si falta, añade Reporte DONE sin reportDocumentId. (DONE report without reportDocumentId.) y se detiene. Si lo tiene, obtiene el contenido del documento y se lo pasa al importador.
Importación
El contenido obtenido del documento pasa al importador de las líneas de reembolso FBA del módulo, junto con la cuenta, el identificador del informe y el de su documento, el marketplace de la cuenta y el límite de líneas por pasada de la cuenta. Si ese límite está vacío o a cero, la pasada entrega 10000.
Contadores
Tras importar, el resultado suma estas líneas: Filas reporte (Report rows), Filas procesadas (Processed rows), Creadas (Created), Actualizadas (Updated), Saltadas (Skipped) y Con error (With error), cada una con su cifra.
Auditoría de reembolsos
Si la cuenta tiene activada la auditoría de reembolsos, justo después de importar la pasada refresca las reclamaciones de reembolso de esa cuenta.
Resultado guardado
Al terminar, tanto si importó como si se detuvo antes, la pasada escribe en la cuenta la fecha y hora de la ejecución y el texto del resultado, cortado a cinco mil caracteres. El texto empieza con Sincronización de reembolsos FBA de Amazon finalizada. (Amazon FBA reimbursements sync finished.), Cuenta: … (Account: …) y Origen: … (Source: …); el origen es CRON si la lanza la tarea y Manual en otro caso. Cuando la lanza la tarea, no publica ese texto en el chatter de la cuenta.

Qué mirar si no hace nada

Aviso en el registro
Si la pasada de una cuenta lanza un error, la tarea lo atrapa, anota un aviso en el registro del servidor con el nombre de la cuenta y sigue con la siguiente. Por eso el fallo de una cuenta no detiene a las demás. El nombre es el campo Nombre (Name), que se ve en la ficha de Cuentas (Accounts), en la pestaña Identidad (Identity), grupo Cuenta (Account), y también en la lista de Cuentas.
Menú y permisos
Las cuentas se abren desde Amazon › Configuración › Cuentas (Amazon › Configuration › Accounts). El tramo Amazon pide el permiso Lector (Viewer); Configuración (Configuration) y Cuentas piden Responsable (Manager). Si no tienes el permiso de un tramo, no lo ves.

Con esto, una revisión ordenada cuando la tarea parece no hacer nada:

  • La tarea viene activa al instalar: comprueba que sigue activa.
  • La cuenta tiene que estar activa y con la sincronización de reembolsos FBA habilitada; si no, la tarea no la recorre.
  • El texto del resultado queda guardado en la cuenta: si la línea Estado reporte no es DONE, la pasada se detuvo antes de importar; la línea siguiente del resultado dice si Amazon no generó un informe utilizable o si venció el tiempo de espera del informe.
  • Si el informe llegó a DONE, mira los contadores Saltadas y Con error del resultado.
  • Busca en el registro del servidor el aviso con el nombre de la cuenta.

Suscripción y ayuda de 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 € al mes o 490 € al año, sin IVA, hasta tres cuentas de la plataforma. La conexión pasa por FlexigoTech Cloud, que guarda cifradas las credenciales, vigila la sincronización y avisa por correo si falla. Sin suscripción, o con el servicio suspendido, se para lo que da la suscripción; los datos se quedan en tu Odoo. Puedes ver el módulo en la página de FlexigoTech.

Si estás implantando Odoo y quieres revisar cómo encaja la sincronización de reembolsos con tus cuentas de Amazon, 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 17.0 y 20.0) y en las fuentes enlazadas

Fuentes