Salta al contingut principal
Amazon

Què fa el botó «Sync FBA Ledger Detail» a Odoo

El botó Sync FBA Ledger Detail llança a mà, sobre un compte, la sincronització que la tasca programada diària fa als comptes actius que tenen activat el detall: demana a Amazon l'informe de detall del llibre FBA, espera que estigui llest, n'importa les files i deixa un resum. Abans de res comprova els teus permisos; si no tens el permís Manager ni el de Configuració, t'atura amb un avís.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 5 de novembre de 2026

L'essencial

Mòdul
Amazon
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
6 min

El que fa Odoo sol, sense prémer res

La tasca programada Amazon SP-API - Sync FBA ledger detail report (opt-in) s'executa un cop al dia i està activa des que s'instal·la el mòdul. Només tracta els comptes actius que tenen activada la sincronització del detall, i per a cadascun llança la mateixa sincronització que el botó.

Hi ha diferències amb l'execució manual: el resum marca com a origen la tasca programada en lloc de manual, no es publica al chatter del compte i, si falla un compte, la tasca deixa un avís al registre del servidor i continua amb el següent. El botó no fa aquesta selecció de comptes: treballa sobre el compte en què el prems.

El botó és a les branques d'Odoo 17, 18, 19 i 20 i es veu sempre a la pantalla Accounts, sense cap condició.

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 anglès)

El cas de Casa Olivar: del menú al resum

Exemple Cas il·lustratiu: l'empresa i les seves dades són inventades per explicar el flux.

Casa Olivar és una botiga inventada que ven oli i conserves amb FBA i porta el connector a Odoo 20. La Marta, d'administració, té el permís Manager i vol revisar l'historial d'esdeveniments d'un compte sense esperar la tasca del dia.

  1. Entra per Amazon › Configuration › Accounts i obre el compte.
  2. A la pestanya FBA Reports (opt-in), dins del grup Reimbursement Claim Audit (find money Amazon owes you), hi ha la casella FBA reimbursement audit, desactivada per defecte. La Marta vol que la sincronització passi també per l'auditoria de reclamacions del compte, així que l'activa.
  3. Prem Sync FBA Ledger Detail. L'acció es queda consultant Amazon, amb una pausa entre consulta i consulta, fins que l'informe acaba, falla o s'esgoten els intents.
  4. Quan acaba amb resum, el compte desa la data i el text de l'execució i publica aquest resum al seu chatter.
  5. Si l'estat de l'informe que figura al resum no és DONE, d'aquesta execució no s'importa res i la Marta la pot tornar a llançar més tard. Si és DONE però Amazon no lliura el document de l'informe, el resum ho indica i tampoc no s'importa res. Si hi ha document, el resum afegeix quantes files portava l'informe i quantes s'han capturat, actualitzat o saltat.

El seu company Íñigo només té el permís Viewer: no veu els trams Configuration i Accounts del menú, així que no arriba a aquesta pantalla.

L'endemà la tasca programada torna a fer el mateix sense que ningú premi res, però només als comptes actius que tinguin activada la sincronització del detall.

Esquema fet amb codi amb el nom del botó en castellà, alemany, francès, italià i portuguès
Esquema fet amb codi a partir de les traduccions publicades del mòdul, no és una pantalla d'Odoo: el nom del botó segons l'idioma d'Odoo.

Què comprova abans de cridar Amazon

La ruta Amazon › Configuration › Accounts té permisos per tram: Amazon demana Viewer, i tant Configuration com Accounts demanen Manager. Sense aquest permís no veus aquests trams.

Al prémer el botó, el primer és una comprovació al servidor: si no ets superusuari, has de tenir el permís Manager del connector o el de Configuració. Després comprova que puguis escriure en aquest compte. El superusuari passa sense la comprovació de grups, i la tasca programada tampoc no hi passa perquè crida directament la sincronització.

Esquema fet amb codi: la ruta de menú Amazon, Configuration, Accounts, el botó Sync FBA Ledger Detail i a un costat l'avís de permisos que pot aturar-lo
Esquema fet amb codi a partir del codi del mòdul, no és una pantalla d'Odoo: el menú, el botó i l'avís que pot aturar l'acció.

Què fa per dins, per ordre

  1. Comprova els permisos, com acabes de veure.
  2. Treballa amb un sol compte.
  3. Demana a Amazon que creï l'informe de detall del llibre FBA. Si Amazon no retorna l'identificador de l'informe, l'acció s'atura.
  4. Consulta l'estat de l'informe fins que sigui DONE, CANCELLED o FATAL, o fins a esgotar els intents. El nombre d'intents i els segons entre ells els pren del compte; si no hi ha valor, el codi fa servir dotze intents amb deu segons de pausa.
  5. Si l'informe no queda en DONE, desa la data i el resum amb l'estat en què es va quedar, el publica al chatter i acaba sense importar res.
  6. Si és en DONE però Amazon no dona document de l'informe, fa el mateix: resum desat, sense importar res i sense recomptes de files.
  7. Si hi ha document, el descarrega i el passa a la importació de l'historial d'esdeveniments del llibre del compte.
  8. Si FBA reimbursement audit està activada, la sincronització passa també per l'auditoria de reclamacions del compte.
  9. Desa la data i el resum i publica el resum al chatter.

El resum recull el compte, l'origen (manual si el llances tu), l'identificador i l'estat de l'informe i, si s'arriba a importar, el recompte de files, capturades, actualitzades i saltades.

Què canvia al teu Odoo i què no

  • S'acumula l'historial d'esdeveniments del llibre del compte.
  • El compte desa la data i el resum de l'última execució, i el chatter rep una nota amb el resum.
  • Amb FBA reimbursement audit activada, la sincronització passa també per l'auditoria de reclamacions. La seva ajuda diu que, en activar-la, la sincronització també acumula esdeveniments de perdut, danyat i trobat, i que l'auditoria els contrasta amb els reemborsaments de les liquidacions per treure les unitats que Amazon encara deu, amb valor estimat i data límit de reclamació. És una anàlisi de només lectura.
  • Segons el propi codi, és una sincronització independent que no toca l'estoc FBA: només acumula historial per esdeveniment per a l'auditoria de reemborsaments.

L'avís que pot aturar l'acció

Al prémer Sync FBA Ledger Detail pot sortir aquest avís: You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

Surt quan no ets superusuari i no tens el permís Manager del connector ni el de Configuració. Es resol com diu el propi text: demana a un responsable que et concedeixi l'accés de Manager.

Què aprendre del cas

  • La tasca diària sincronitza els comptes actius que tenen activada la sincronització del detall; el botó serveix per llançar-la a mà al compte que tens obert.
  • El permís es comprova en prémer, a més de limitar el menú.
  • L'estat de l'informe al resum et diu si hi va haver importació.
  • La casella FBA reimbursement audit decideix si la sincronització passa també per l'auditoria de reclamacions.

Com t'ajuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. La pàgina del mòdul i la seva fitxa a Odoo Apps tenen els detalls de compra. El mòdul és de pagament únic per versió i necessita la subscripció a FlexigoTech Cloud, pla Connector (49 € al mes o 490 € a l'any, sense IVA). La connexió passa per FlexigoTech Cloud, que desa xifrades les credencials, vigila la sincronització i avisa per correu si falla.

Continua llegint

Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts