Qué hace el botón «Sincronizar detalle del libro mayor FBA» en Odoo

Lo que hace Odoo solo, sin pulsar nada

La tarea programada Amazon SP-API - Sincronizar informe de detalle del libro FBA (opt-in) (Amazon SP-API - Sync FBA ledger detail report (opt-in)) se ejecuta una vez al día y está activa desde que se instala el módulo. Solo trata las cuentas activas que tienen activada la sincronización del detalle, y para cada una lanza la misma sincronización que el botón.

Hay diferencias con la ejecución manual: el resumen marca como origen la tarea programada en lugar de manual, no se publica en el chatter de la cuenta y, si falla una cuenta, la tarea deja un aviso en el registro del servidor y sigue con la siguiente. El botón no hace esa selección de cuentas: trabaja sobre la cuenta en la que lo pulsas.

El botón está en las ramas de Odoo 17, 18, 19 y 20 y se ve siempre en la pantalla Cuentas (Accounts), sin ninguna condición.

El caso de Casa Olivar: del menú al resumen

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

Casa Olivar es una tienda inventada que vende aceite y conservas con FBA y lleva el conector en Odoo 20. Marta, de administración, tiene el permiso Responsable y quiere revisar el historial de eventos de una cuenta sin esperar a la tarea del día.

1. Entra por Amazon › Configuración › Cuentas (Amazon › Configuration › Accounts) y abre la cuenta.
2. En la pestaña Informes FBA (opt-in) (FBA Reports (opt-in)), dentro del grupo Auditoría de reclamaciones de reembolso (encuentra el dinero que Amazon te debe) (Reimbursement Claim Audit (find money Amazon owes you)), está la casilla Auditoría de reembolsos FBA (FBA reimbursement audit), desactivada por defecto. Marta quiere que la sincronización pase también por la auditoría de reclamaciones de la cuenta, así que la activa.
3. Pulsa Sincronizar detalle del libro mayor FBA. La acción se queda consultando a Amazon, con una pausa entre consulta y consulta, hasta que el informe termina, falla o se agotan los intentos.
4. Cuando acaba con resumen, la cuenta guarda la fecha y el texto de la ejecución y publica ese resumen en su chatter.
5. Si el estado del informe que figura en el resumen no es DONE, de esa ejecución no se importa nada y Marta puede volver a lanzarla más tarde. Si es DONE pero Amazon no entrega el documento del informe, el resumen lo indica y tampoco se importa nada. Si hay documento, el resumen añade cuántas filas traía el informe y cuántas se han capturado, actualizado o saltado.

Su compañero Íñigo solo tiene el permiso Lector: no ve los tramos Configuración y Cuentas del menú, así que no llega a esta pantalla.

Al día siguiente la tarea programada vuelve a hacer lo mismo sin que nadie pulse nada, pero solo en las cuentas activas que tengan activada la sincronización del detalle.

Qué comprueba antes de llamar a Amazon

La ruta Amazon › Configuración › Cuentas tiene permisos por tramo: Amazon pide Lector, y tanto Configuración como Cuentas piden Responsable. Sin ese permiso no ves esos tramos.

Al pulsar el botón, lo primero es una comprobación en el servidor: si no eres superusuario, tienes que tener el permiso Responsable (Manager) del conector o el de Ajustes. Después comprueba que puedas escribir en esa cuenta. El superusuario pasa sin la comprobación de grupos, y la tarea programada tampoco pasa por ella porque llama directamente a la sincronización.

Qué hace por dentro, en orden

1. Comprueba los permisos, como acabas de ver.
2. Trabaja con una sola cuenta.
3. Pide a Amazon que cree el informe de detalle del libro FBA. Si Amazon no devuelve el identificador del informe, la acción se detiene.
4. Consulta el estado del informe hasta que sea DONE, CANCELLED o FATAL, o hasta agotar los intentos. El número de intentos y los segundos entre ellos los toma de la cuenta; si no hay valor, el código usa doce intentos con diez segundos de pausa.
5. Si el informe no queda en DONE, guarda la fecha y el resumen con el estado en que se quedó, lo publica en el chatter y termina sin importar nada.
6. Si está en DONE pero Amazon no da documento del informe, hace lo mismo: resumen guardado, sin importar nada y sin recuentos de filas.
7. Si hay documento, lo descarga y lo pasa a la importación del historial de eventos del libro de la cuenta.
8. Si Auditoría de reembolsos FBA está activada, la sincronización pasa también por la auditoría de reclamaciones de la cuenta.
9. Guarda la fecha y el resumen y publica el resumen en el chatter.

El resumen recoge la cuenta, el origen (manual si lo lanzas tú), el identificador y el estado del informe y, si se llega a importar, el recuento de filas, capturadas, actualizadas y saltadas.

Qué cambia en tu Odoo y qué no

• Se acumula el historial de eventos del libro de la cuenta.
• La cuenta guarda la fecha y el resumen de la última ejecución, y el chatter recibe una nota con el resumen.
• Con Auditoría de reembolsos FBA activada, la sincronización pasa también por la auditoría de reclamaciones. Su ayuda dice que, al activarla, la sincronización también acumula eventos de perdido, dañado y encontrado, y que la auditoría los contrasta con los reembolsos de las liquidaciones para sacar las unidades que Amazon aún debe, con valor estimado y fecha límite de reclamación. Es un análisis de solo lectura.
• Según el propio código, es una sincronización independiente que no toca el stock FBA: solo acumula historial por evento para la auditoría de reembolsos.

El aviso que puede parar la acción

Al pulsar Sincronizar detalle del libro mayor FBA puede salir este aviso: You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

Sale cuando no eres superusuario y no tienes el permiso Responsable del conector ni el de Ajustes. Se arregla como dice el propio texto: pide a un responsable que te conceda el acceso de Responsable.

Qué aprender del caso

• La tarea diaria sincroniza las cuentas activas que tienen activada la sincronización del detalle; el botón sirve para lanzarla a mano en la cuenta que tienes abierta.
• El permiso se comprueba al pulsar, además de limitar el menú.
• El estado del informe en el resumen te dice si hubo importación.
• La casilla Auditoría de reembolsos FBA decide si la sincronización pasa también por la auditoría de reclamaciones.

Cómo te ayuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida. La página del módulo y su ficha en Odoo Apps tienen los detalles de compra. El módulo es 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). La conexión pasa por FlexigoTech Cloud, que guarda cifradas las credenciales, vigila la sincronización y avisa por correo si falla.

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