Español
English
Deutsch
Français
Português
Italiano
Nederlands
Polski
Gairebé totes les empreses que connecten Amazon Seller Central amb Odoo passen pel mateix: el primer mes tot funciona bé a les proves, i a les poques setmanes d'operar amb volum real comencen a aparèixer els mateixos símptomes. Estoc que no quadra, comandes que es dupliquen, tracking que arriba tard, l'API que comença a retornar errors 429, o un token que deixa de funcionar un dilluns al matí sense previ avís.
Idea clau: gairebé cap d'aquests errors és un problema d'Amazon ni d'Odoo per separat. Apareixen a la capa de sincronització, quan el connector no respecta el model asíncron de la SP-API (notificacions en temps real, límits de peticions per endpoint, tokens OAuth amb caducitat curta) i, en lloc d'això, fa un sondeig simple cada X minuts i confia que tot arribi a temps.
Per què falla la integració Amazon-Odoo (i no sempre és evident)
La SP-API d'Amazon no és una API REST simple de petició-resposta. Combina crides síncrones amb un sistema de notificacions asíncron (Notifications API, lliurat via SQS o EventBridge), un model de reports que es generen en segon pla i cal consultar fins que estan llestos, i un límit de peticions per segon diferent per a cada operació, no un de global per a tot el compte. L'autenticació es fa amb Login With Amazon (LWA): l'access token caduca cada hora i cal renovar-lo amb el refresh_token abans que expiri.
Moltes integracions (sobretot les muntades amb automatitzacions genèriques tipus Zapier, Make o un iPaaS sense lògica específica per a Amazon) simplifiquen tot això a un cron que consulta comandes cada X minuts i dona per fet que amb això n'hi ha prou. Aquesta simplificació és l'origen directe de la majoria dels errors de la taula següent.
Taula: símptoma, causa probable i com s'evita
Vuit símptomes reals que veiem repetir-se en operacions que venen a Amazon des d'Odoo, amb la causa tècnica més probable en cada cas i la solució que aplica un connector construït per operar de debò, no només per superar una demo.
| Símptoma | Causa probable | Com s'evita |
|---|---|---|
| Estoc desquadrat / oversell a Amazon | Sincronització per sondeig cada 30-60 minuts; no es consumeix la Notifications API d'inventari en temps real | Subscripció a notificacions d'inventari amb enviament immediat després de cada moviment d'estoc a Odoo, més un buffer de seguretat configurable |
| Comandes duplicades a Odoo | Reintents del connector sense idempotència; no s'usa l'AmazonOrderId com a clau única | Upsert idempotent indexat per AmazonOrderId, amb restricció d'unicitat a nivell de base de dades |
| El tracking arriba tard a Amazon (puja el Late Shipment Rate) | L'enviament del tracking es fa en un cron nocturn per lots, en lloc de fer-ho en validar l'albarà | Acció automàtica que crida la Shipping API en el moment en què es valida el lliurament a Odoo |
| Errors 429 / "Request throttled" | No es respecta el rate limit específic de cada operació de la SP-API (cada endpoint té el seu propi bucket) | Cua de feines amb backoff exponencial i un rate limiter propi per endpoint, no un de global |
| Token OAuth caducat o refresh_token invàlid | No hi ha renovació automàtica de l'access token LWA, o es va revocar el consentiment a Seller Central sense que ningú se n'assabentés | Renovació automàtica amb marge de seguretat, més una alerta quan falla el refresh (no quan ja falla una comanda real) |
| Preus diferents entre Amazon i la resta de canals | No hi ha una font de veritat única; s'edita el preu a mà a Seller Central | Odoo com a font de veritat de preus, amb regles de conflicte explícites si es detecta una edició manual a Amazon |
| Reemborsaments i devolucions que no quadren a comptabilitat | Només es processen les comandes; no s'importen els informes de Returns/Refunds d'Amazon | Importació automàtica dels Returns Reports a assentaments comptables d'abonament, no només a l'estoc |
| Funciona a les proves però falla amb diversos comptes o marketplaces | Credencials i estat de sincronització hardcodejats per a un sol compte de venedor | Model de credencials per empresa/marketplace des del mateix model de dades, no com un pedaç afegit després |
Checklist: què ha de tenir un connector Amazon-Odoo ben construït
Abans de donar per bo un connector Amazon-Odoo (el teu o un que estiguis avaluant comprar), repassa aquesta llista. No és teoria: són els punts exactes on hem vist fallar integracions reals.
- Consumeix la Notifications API d'Amazon (SQS/EventBridge) en lloc de dependre només de sondeig periòdic
- Importa comandes de manera idempotent usant l'AmazonOrderId com a clau única
- Envia el tracking a Amazon en el moment de validar l'albarà, no per lots en un cron nocturn
- Aplica un rate limiter i backoff exponencial per endpoint, no un límit global aproximat
- Renova el token OAuth (LWA) de manera automàtica, amb alerta primerenca si falla el refresh
- Deixa log de cada crida a l'API amb codi de resposta i payload, no només un genèric "sync OK"
- Suporta diversos comptes i marketplaces des del mateix model de dades, no com un afegit posterior
Què fem a FlexigoTech: el nostre Conector Amazon per a Odoo
El nostre Conector Amazon per a Odoo està construït amb FBA i FBM en producció real via SP-API, precisament per no caure en cap dels vuit punts de la taula anterior: importació idempotent per AmazonOrderId, enviament de tracking en validar l'albarà i renovació automàtica de tokens, entre altres. No és una capa d'automatització genèrica muntada sobre l'API: és un mòdul d'Odoo natiu pensat per operar amb volum real, no només per superar una demo.
Si ja tens Odoo però el connector actual (propi o de tercers) et dona algun d'aquests símptomes, moltes vegades el problema no és canviar de connector sinó revisar com està desplegat dins la teva instància. Això sol resoldre's dins d'un projecte d'implantació d'Odoo 19 ben fet, amb la sincronització de marketplaces com a part de l'abast des del principi, no com un pedaç posterior.
Enllaços útils dins de FlexigoTech
Preguntes freqüents
Per què es desincronitza l'estoc entre Amazon i Odoo encara que tinc un connector instal·lat?
Gairebé sempre perquè el connector sincronitza per sondeig (polling) cada cert temps, en lloc de reaccionar a les notificacions d'inventari d'Amazon en temps real. Entre una passada i la següent hi ha una finestra en què Amazon i Odoo no coincideixen, i en catàlegs amb rotació alta això basta per vendre alguna cosa que ja no tens.
Com evito comandes duplicades quan Amazon reenvia la mateixa notificació?
Amazon pot reenviar la mateixa notificació de comanda més d'una vegada; és part normal del seu model de lliurament. La solució no és filtrar reenviaments a mà, sinó que el connector usi l'AmazonOrderId com a clau única i faci un upsert idempotent: si la comanda ja existeix, l'actualitza; si no, la crea. Mai la insereix dues vegades.
Què és un error 429 d'Amazon SP-API i com se soluciona des d'Odoo?
És un error de throttling: has superat el límit de peticions per segon d'aquell endpoint concret (cada operació de la SP-API té el seu propi límit, no un de global). Se soluciona amb una cua de feines que respecta el rate limit de cada endpoint i reintenta amb backoff exponencial, no tornant a cridar als pocs segons.
Què passa si el meu token OAuth d'Amazon caduca en producció?
Amazon usa Login With Amazon (LWA): l'access token caduca cada hora i cal renovar-lo amb el refresh_token abans que expiri. Si el connector no automatitza aquesta renovació, o si el venedor va revocar el consentiment a Seller Central sense avisar ningú, les crides comencen a fallar amb errors d'autorització fins que es reconnecta el compte a mà.
El tracking que arriba tard a Amazon afecta de debò el meu compte?
Sí. Amazon mesura el Late Shipment Rate i, si puja per sobre del seu llindar, pot afectar la salut del compte i la visibilitat dels teus listings, a més de l'impacte directe en l'experiència del comprador. Si el tracking s'envia en un cron nocturn en lloc de fer-ho en el moment de validar l'albarà a Odoo, aquest retard és responsabilitat del connector, no d'Amazon.
El que fem sobre això
Vols que revisem la teva integració amb Amazon?
Explica'ns quin símptoma tens (estoc, comandes duplicades, tracking o tokens) i en la primera trucada et diem si és un ajust puntual o si el connector necessita revisió de fons. Escriu-nos a comercial@flexigobe.com o truca al +34 616 809 504.