Salta al contingut principal
Amazon

Tasca «Sincronitzar informe de reemborsaments FBA» d'Amazon Connector: glossari

La tasca Amazon SP-API - Sync FBA reimbursements report (opt-in) corre un cop al dia i ve activa en instal·lar. A cada passada recorre els comptes d'Amazon actius amb la sincronització de reemborsaments FBA habilitada, demana un informe a Amazon, espera que estigui llest, lliura les seves files a l'importador i desa el resultat al compte.

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ó 17.0 i 20.0 · a les fonts enllaçades al final
Lectura
5 min

La tasca existeix, amb el mateix nom, a les branques 17, 18, 19 i 20 d'Amazon Connector for Odoo, FBA & FBM Seller SP-API.

Esquema amb la tasca programada de reemborsaments FBA, que corre un cop al dia i ve activa en instal·lar, i el menú Amazon, Configuration, Accounts
Esquema fet amb codi a partir del codi publicat del mòdul, no és una captura d'Odoo. Els rètols van en anglès, com al codi.

La tasca i el seu calendari

Tasca programada
La tasca Amazon SP-API - Sync FBA reimbursements report (opt-in) treballa sobre els comptes d'Amazon del mòdul i executa un mètode que els recorre. El rètol porta (opt-in): al codi, la tasca només recorre els comptes que tenen habilitada la sincronització de reemborsaments FBA.
Freqüència
Corre un cop al dia, és a dir, cada dia, i ve activa en instal·lar el mòdul. A Odoo 17 la tasca està definida per repetir-se sense fi.
Compte inclòs
A cada passada la tasca cerca els comptes que estan actius i tenen habilitada la sincronització de reemborsaments FBA. Si un compte no compleix les dues condicions, la tasca no el toca; si cap les compleix, no hi ha res a recórrer.

Amb Odoo en català, la tasca es diu Amazon SP-API - Sync FBA reimbursements report (opt-in). L'esquema recull com es diu amb Odoo en altres idiomes.

Esquema amb el nom de la tasca 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 captura d'Odoo. Castellà: Amazon SP-API - Sync FBA reimbursements report (opt-in). Alemany: Amazon SP-API - FBA-Erstattungsbericht synchronisieren (Opt-in). Francès: Amazon SP-API - Synchroniser le rapport des remboursements FBA (opt-in). Italià: 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 anglès)

Què fa a cada passada amb un compte

Petició de l'informe
Per a cada compte, la passada demana a Amazon que creï un informe de reemborsaments. Amb l'identificador que Amazon retorna continua endavant; la línia Report ID: … el recull al resultat.
Consulta de l'estat
La passada pregunta a Amazon per l'informe fins que el seu estat sigui DONE, CANCELLED o FATAL, o fins a esgotar els intents. Entre un intent i el següent espera uns segons. Si el nombre d'intents o l'espera del compte estan buits o a zero, fa servir dotze intents i deu segons d'espera; com a mínim fa un intent i espera un segon.
Estat de l'informe
La línia Report status: … mostra l'últim estat que va donar Amazon, o UNKNOWN si no en va arribar cap. Si no és DONE, la passada s'atura allà i no importa res. Amb CANCELLED o FATAL afegeix Amazon did not generate a usable reimbursements report.. En qualsevol altre estat afegeix Report polling timed out. Try again in a few minutes..
Document de l'informe
Amb l'informe en DONE, la passada necessita l'identificador del seu document. Si falta, afegeix DONE report without reportDocumentId. i s'atura. Si el té, obté el contingut del document i el passa a l'importador.
Importació
El contingut obtingut del document passa a l'importador de les línies de reemborsament FBA del mòdul, juntament amb el compte, l'identificador de l'informe i el del seu document, el marketplace del compte i el límit de línies per passada del compte. Si aquest límit està buit o a zero, la passada en lliura 10000.
Comptadors
Després d'importar, el resultat suma aquestes línies: Filas reporte, Filas procesadas, Creadas, Actualizadas, Saltadas i Con error, cadascuna amb la seva xifra.
Auditoria de reemborsaments
Si el compte té activada l'auditoria de reemborsaments, just després d'importar la passada refresca les reclamacions de reemborsament d'aquest compte.
Resultat desat
En acabar, tant si ha importat com si s'ha aturat abans, la passada escriu al compte la data i hora de l'execució i el text del resultat, tallat a cinc mil caràcters. El text comença amb Amazon FBA reimbursements sync finished., Account: … i Source: …; l'origen és CRON si la llança la tasca i Manual en un altre cas. Quan la llança la tasca, no publica aquest text al chatter del compte.

Què mirar si no fa res

Avís al registre
Si la passada d'un compte llança un error, la tasca l'atrapa, anota un avís al registre del servidor amb el nom del compte i continua amb el següent. Per això la fallada d'un compte no atura els altres. El nom és el camp Name, que es veu a la fitxa de Accounts, a la pestanya Identity, grup Account, i també a la llista de Accounts.
Menú i permisos
Els comptes s'obren des de Amazon › Configuration › Accounts. El tram Amazon demana el permís Viewer; Configuration i Accounts demanen Manager. Si no tens el permís d'un tram, no el veus.

Amb això, una revisió ordenada quan la tasca sembla no fer res:

  • La tasca ve activa en instal·lar: comprova que continua activa.
  • El compte ha d'estar actiu i amb la sincronització de reemborsaments FBA habilitada; si no, la tasca no el recorre.
  • El text del resultat queda desat al compte: si la línia Estado reporte no és DONE, la passada s'ha aturat abans d'importar; la línia següent del resultat diu si Amazon no ha generat un informe utilitzable o si ha vençut el temps d'espera de l'informe.
  • Si l'informe ha arribat a DONE, mira els comptadors Saltadas i Con error del resultat.
  • Cerca al registre del servidor l'avís amb el nom del compte.

Subscripció i ajuda de FlexigoTech

El mòdul és de pagament únic per versió d'Odoo (publicat per a 17, 18, 19 i 20) i necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 € al mes o 490 € a l'any, sense IVA, fins a tres comptes de la plataforma. La connexió passa per FlexigoTech Cloud, que desa xifrades les credencials, vigila la sincronització i avisa per correu si falla. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció; les dades es queden al teu Odoo. Pots veure el mòdul a la pàgina de FlexigoTech.

Si estàs implantant Odoo i vols revisar com encaixa la sincronització de reemborsaments amb els teus comptes d'Amazon, FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida.

Continua llegint

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

Fonts