Botón «Sincronizar reembolsos» de Amazon en Odoo: qué hace paso a paso

Antes de pulsar: dónde está y quién puede usarlo

El botón Sincronizar reembolsos está en la pantalla Cuentas (Accounts), a la que se llega por Amazon › Configuración › Cuentas (Amazon › Configuration › Accounts). Cada tramo del menú pide un permiso y, si no lo tienes, no ves ese tramo: Amazon pide Lector (Viewer), mientras que Configuración (Configuration) y Cuentas piden Responsable (Manager).

• Abre Amazon › Configuración › Cuentas y entra en la cuenta que quieres sincronizar. El botón actúa sobre una sola cuenta.

• Comprueba que tu usuario tiene acceso de responsable del conector de Amazon o de Ajustes. El botón se ve siempre, y está en las cuatro ramas publicadas (Odoo 17, 18, 19 y 20), pero verlo no equivale a tener permiso: la acción lo comprueba nada más empezar.

Primero el camino automático, después el botón

En las cuentas activas que tienen activada la sincronización del informe de reembolsos FBA, la tarea programada Amazon SP-API - Sincronizar informe de reembolsos FBA (opt-in) (Amazon SP-API - Sync FBA reimbursements report (opt-in)) lanza la misma sincronización una vez al día. Viene activa al instalar el módulo.

• Comprueba que esa tarea programada sigue activa en tu base de datos.

• Comprueba que la cuenta está activa y que tiene activada la sincronización del informe de reembolsos: la tarea solo recorre las cuentas que cumplen las dos condiciones.

• Ten en cuenta que, si la sincronización de una cuenta lanza un error que llega a la tarea, esta lo anota en el registro del servidor y sigue con las demás cuentas. Además, la tarea no publica el resumen como mensaje en la ficha.

• Usa el botón cuando quieras lanzarla a mano. En el resumen, el origen figura como manual (en la tarea, CRON) y el resumen se publica como mensaje en la ficha de la cuenta.

Al pulsar: qué comprueba y qué hace, en orden

• Permisos primero. Si no eres superusuario, el botón exige acceso de responsable del conector o de Ajustes y, después, que puedas escribir en esa cuenta. Si no se cumple, la acción se detiene ahí y no se guarda nada de lo que iba a cambiar.

• A continuación pide a Amazon que genere el informe de reembolsos FBA de la cuenta.

• Después pregunta por el estado del informe varias veces, con una pausa entre intentos, hasta que está listo, cancelado o ha fallado. La acción espera mientras tanto, así que no esperes respuesta inmediata.

• Si el informe está listo, descarga su documento y lo pasa a la importación de Odoo.

• Si la casilla Auditoría de reembolsos FBA (FBA reimbursement audit) está activada, el botón lanza la actualización de la auditoría de reclamaciones justo después de la importación. La casilla está en la ficha de Cuentas, pestaña Informes FBA (opt-in) (FBA Reports (opt-in)), grupo Auditoría de reclamaciones de reembolso (encuentra el dinero que Amazon te debe) (Reimbursement Claim Audit (find money Amazon owes you)), y viene desactivada por defecto. Su ayuda la presenta como análisis de solo lectura.

• Por último, la cuenta guarda la fecha y el resultado de la última ejecución, y el resumen se publica como mensaje en su ficha.

Después de pulsar: qué revisar

• Abre la ficha de la cuenta y lee el mensaje nuevo. Empieza con Sincronización de reembolsos FBA de Amazon finalizada. (Amazon FBA reimbursements sync finished.) y sigue con Cuenta: … (Account), Origen: … (Source: Manual si pulsaste el botón), ID del informe: … (Report ID) y Estado reporte: … (Report status).

• Si el informe se importó, lee también Filas reporte, Filas procesadas, Creadas, Actualizadas, Saltadas y Con error (Report rows, Processed rows, Created, Updated, Skipped, With error).

• Mira el recuento de Con error antes de dar la importación por buena.

Si algo no sale bien

No tienes acceso

Sale al pulsar el botón, cuando tu usuario no es de responsable del conector ni de Ajustes. El mensaje es este:

You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

• Pide a un responsable que te dé acceso de responsable, como dice el propio mensaje.

• Si ya tienes el grupo y la acción sigue parando, la comprobación pide además permiso de escritura sobre esa cuenta.

El informe no llega a importarse

En estas situaciones la ejecución termina, anota el resultado en la cuenta y no importa filas.

• Si Amazon cancela el informe o este falla, el resumen añade Amazon no generó un informe de reembolsos utilizable. (Amazon did not generate a usable reimbursements report.)

• Si se agotan los intentos de espera, el resumen añade Timeout haciendo polling del reporte. Reintenta en unos minutos. (Report polling timed out. Try again in a few minutes.)

• Si el informe está listo pero Amazon no da el documento, el resumen añade Reporte DONE sin reportDocumentId. (DONE report without reportDocumentId.) y tampoco se importa nada.

Coste y ayuda

El módulo es de pago único por versión de Odoo (17, 18, 19 y 20) y necesita la suscripción a FlexigoTech Cloud: el plan Conector cuesta 49 €/mes o 490 €/año, sin IVA. La conexión pasa por ese servicio, que guarda cifradas las credenciales y avisa por correo si la sincronización falla. Puedes ver el módulo en la página de FlexigoTech o en la ficha de Odoo Apps.

Si estás implantando Odoo y quieres que alguien revise contigo los permisos y la puesta en marcha del conector, 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
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/precios.html
• flexigotech.com/en/services.html