Casi todas las empresas que conectan Amazon Seller Central con Odoo pasan por lo mismo: el primer mes todo funciona bien en las pruebas, y a las pocas semanas de operar con volumen real empiezan a aparecer los mismos síntomas. Stock que no cuadra, pedidos que se duplican, tracking que llega tarde, la API que empieza a devolver errores 429, o un token que deja de funcionar un lunes por la mañana sin previo aviso.
Idea clave: casi ninguno de estos errores es un problema de Amazon ni de Odoo por separado. Aparecen en la capa de sincronización, cuando el conector no respeta el modelo asíncrono de la SP-API (notificaciones en tiempo real, límites de peticiones por endpoint, tokens OAuth con caducidad corta) y en su lugar hace un sondeo simple cada X minutos y confía en que todo llegue a tiempo.
Por qué falla la integración Amazon-Odoo (y no siempre es evidente)
La SP-API de Amazon no es una API REST simple de petición-respuesta. Combina llamadas síncronas con un sistema de notificaciones asíncrono (Notifications API, entregado vía SQS o EventBridge), un modelo de reports que se generan en segundo plano y hay que consultar hasta que están listos, y un límite de peticiones por segundo distinto para cada operación, no uno global para toda la cuenta. La autenticación se hace con Login With Amazon (LWA): el access token caduca cada hora y hace falta renovarlo con el refresh_token antes de que expire.
Muchas integraciones (sobre todo las montadas con automatizaciones genéricas tipo Zapier, Make o un iPaaS sin lógica específica para Amazon) simplifican todo esto a un cron que consulta pedidos cada X minutos y da por hecho que con eso basta. Esa simplificación es el origen directo de la mayoría de los errores de la tabla siguiente.
Tabla: síntoma, causa probable y cómo se evita
Ocho síntomas reales que vemos repetirse en operaciones que venden en Amazon desde Odoo, con la causa técnica más probable en cada caso y la solución que aplica un conector construido para operar de verdad, no solo para pasar una demo.
| Síntoma | Causa probable | Cómo se evita |
|---|---|---|
| Stock descuadrado / oversell en Amazon | Sincronización por sondeo cada 30-60 minutos; no se consume la Notifications API de inventario en tiempo real | Suscripción a notificaciones de inventario con empuje inmediato tras cada movimiento de stock en Odoo, más un buffer de seguridad configurable |
| Pedidos duplicados en Odoo | Reintentos del conector sin idempotencia; no se usa el AmazonOrderId como clave única | Upsert idempotente indexado por AmazonOrderId, con restricción de unicidad a nivel de base de datos |
| Tracking llega tarde a Amazon (sube el Late Shipment Rate) | El envío del tracking se hace en un cron nocturno por lotes, en vez de al validar el albarán | Acción automática que llama a la Shipping API en el instante en que se valida la entrega en Odoo |
| Errores 429 / "Request throttled" | No se respeta el rate limit específico de cada operación de la SP-API (cada endpoint tiene su propio bucket) | Cola de trabajos con backoff exponencial y un rate limiter propio por endpoint, no uno global |
| Token OAuth caducado o refresh_token inválido | No hay renovación automática del access token LWA, o se revocó el consentimiento en Seller Central sin que nadie se entere | Renovación automática con margen de seguridad, más una alerta cuando el refresh falla (no cuando ya falla un pedido real) |
| Precios distintos entre Amazon y el resto de canales | No hay una fuente de verdad única; se edita el precio a mano en Seller Central | Odoo como fuente de verdad de precios, con reglas de conflicto explícitas si se detecta una edición manual en Amazon |
| Reembolsos y devoluciones que no cuadran en contabilidad | Solo se procesan los pedidos; no se importan los informes de Returns/Refunds de Amazon | Importación automática de los Returns Reports a asientos contables de abono, no solo al stock |
| Funciona en pruebas pero falla con varias cuentas o marketplaces | Credenciales y estado de sincronización hardcodeados para una sola cuenta vendedor | Modelo de credenciales por empresa/marketplace desde el propio modelo de datos, no como un parche añadido después |
Checklist: qué debe tener un conector Amazon-Odoo bien construido
Antes de dar por bueno un conector Amazon-Odoo (el tuyo o uno que estés evaluando comprar), repasa esta lista. No es teoría: son los puntos exactos donde hemos visto fallar integraciones reales.
- Consume la Notifications API de Amazon (SQS/EventBridge) en vez de depender solo de sondeo periódico
- Importa pedidos de forma idempotente usando el AmazonOrderId como clave única
- Envía el tracking a Amazon en el momento de validar el albarán, no por lotes en un cron nocturno
- Aplica un rate limiter y backoff exponencial por endpoint, no un límite global aproximado
- Renueva el token OAuth (LWA) de forma automática, con alerta temprana si el refresh falla
- Deja log de cada llamada a la API con código de respuesta y payload, no solo un genérico "sync OK"
- Soporta varias cuentas y marketplaces desde el propio modelo de datos, no como un añadido posterior
Qué hacemos en FlexigoTech: nuestro Conector Amazon para Odoo
Nuestro Conector Amazon para Odoo está construido con FBA y FBM en producción real vía SP-API, precisamente para no caer en ninguno de los ocho puntos de la tabla anterior: importación idempotente por AmazonOrderId, envío de tracking al validar el albarán y renovación automática de tokens, entre otros. No es una capa de automatización genérica montada sobre la API: es un módulo Odoo nativo pensado para operar con volumen real, no solo para superar una demo.
Si ya tienes Odoo pero el conector actual (propio o de terceros) te está dando alguno de estos síntomas, muchas veces el problema no es cambiar de conector sino revisar cómo está desplegado dentro de tu instancia. Eso suele resolverse dentro de un proyecto de implantación de Odoo 19 bien hecho, con la sincronización de marketplaces como parte del alcance desde el principio, no como un parche posterior.
Enlaces útiles dentro de FlexigoTech
Preguntas frecuentes
¿Por qué se desincroniza el stock entre Amazon y Odoo aunque tengo un conector instalado?
Casi siempre porque el conector sincroniza por sondeo (polling) cada cierto tiempo, en vez de reaccionar a las notificaciones de inventario de Amazon en tiempo real. Entre una pasada y la siguiente hay una ventana en la que Amazon y Odoo no coinciden, y en catálogos con rotación alta eso basta para vender algo que ya no tienes.
¿Cómo evito pedidos duplicados cuando Amazon reenvía la misma notificación?
Amazon puede reenviar la misma notificación de pedido más de una vez; es parte normal de su modelo de entrega. La solución no es filtrar reenvíos a mano, sino que el conector use el AmazonOrderId como clave única y haga un upsert idempotente: si el pedido ya existe, lo actualiza; si no, lo crea. Nunca inserta dos veces.
¿Qué es un error 429 de Amazon SP-API y cómo se soluciona desde Odoo?
Es un error de throttling: has superado el límite de peticiones por segundo de ese endpoint concreto (cada operación de la SP-API tiene su propio límite, no uno global). Se soluciona con una cola de trabajos que respeta el rate limit de cada endpoint y reintenta con backoff exponencial, no llamando de nuevo a los pocos segundos.
¿Qué pasa si mi token OAuth de Amazon caduca en producción?
Amazon usa Login With Amazon (LWA): el access token caduca cada hora y hay que renovarlo con el refresh_token antes de que expire. Si el conector no automatiza esa renovación, o si el vendedor revocó el consentimiento en Seller Central sin avisar a nadie, las llamadas empiezan a fallar con errores de autorización hasta que se reconecta la cuenta a mano.
¿El tracking que llega tarde a Amazon afecta a mi cuenta de verdad?
Sí. Amazon mide el Late Shipment Rate y, si sube por encima de su umbral, puede afectar a la salud de la cuenta y a la visibilidad de tus listings, además del impacto directo en la experiencia del comprador. Si el tracking se envía en un cron nocturno en vez de en el momento de validar el albarán en Odoo, ese retraso es responsabilidad del conector, no de Amazon.
¿Quieres que revisemos tu integración con Amazon?
Cuéntanos qué síntoma tienes (stock, pedidos duplicados, tracking o tokens) y en la primera llamada te decimos si es un ajuste puntual o si el conector necesita revisión de fondo. Escríbenos a comercial@flexigobe.com o llama al +34 639 913 105.