Conector Odoo Amazon: configuración y venta multicanal

Amazon representa casi el 40% de los ingresos del comercio electrónico en EE. UU., lo que lo convierte en un canal obligatorio para los vendedores de productos. Administrar los pedidos, el inventario y el cumplimiento de Amazon por separado de su ERP principal crea silos de datos, dolores de cabeza de conciliación y errores de cumplimiento que cuestan dinero real.

ECOSIRE Odoo Amazon Connector une Odoo 19 Enterprise y Amazon Seller Central, sincronizando productos, pedidos, niveles de inventario y estado de cumplimiento en ambas direcciones. Esta guía cubre el proceso de instalación completo, la configuración del mapeo de datos, las opciones de frecuencia de sincronización, el manejo de errores y las mejores prácticas operativas para ejecutar las ventas de Amazon a través de Odoo.

Conclusiones clave

• El conector es compatible con todos los mercados de Amazon (EE. UU., Reino Unido, UE, Japón, Emiratos Árabes Unidos, etc.)
• La sincronización de pedidos se ejecuta cada 15 minutos de forma predeterminada; configurable hasta 5 minutos
• Los niveles de inventario se envían a Amazon automáticamente con cada movimiento de stock
• Los pedidos de Logística de Amazon y FBM (cumplidos por el comerciante) se manejan en flujos de trabajo separados
• La asignación de productos utiliza ASIN, SKU y EAN/UPC como claves coincidentes
• Las sincronizaciones fallidas se registran con detalles de error y se pueden volver a intentar individualmente
• Las reglas de precios pueden anular los precios de Amazon según las listas de precios de Odoo
• El conector utiliza Amazon SP-API (API de socio vendedor), reemplazando el MWS obsoleto.

---

Requisitos previos y configuración de Amazon SP-API

El conector utiliza la API de socio vendedor de Amazon (SP-API). Antes de instalar el conector, necesita las credenciales SP-API de Amazon.

Paso 1: Regístrese como desarrollador en Amazon Seller Central

1. Inicie sesión en Seller Central → Aplicaciones y servicios → Desarrollar aplicaciones
2. Haga clic en "Agregar nuevo cliente de aplicación" y complete el registro de desarrollador.
3. Amazon revisará su solicitud (de 1 a 3 días hábiles para su aprobación)

Paso 2: crear una aplicación SP-API

Una vez aprobado:

1. Vaya a Aplicaciones y servicios → Desarrollar aplicaciones → Sus aplicaciones
2. Haga clic en "Agregar nuevo cliente de aplicación".
3. Seleccione IAM ARN (primero cree un usuario de AWS IAM) o use OAuth
4. Configure el URI de redireccionamiento a su instancia de Odoo: https://your-odoo.com/amazon/oauth/callback
5. Seleccione los alcances de API requeridos:

• API de pedidos
• API de informes
• API de listados
• API de artículos del catálogo
• API de inventario de Logística de Amazon
• API de feeds

Paso 3: Autoriza tu cuenta de vendedor

Después de la creación de la aplicación, autorícela en cada mercado:

1. Copie las credenciales LWA (Iniciar sesión con Amazon) de su aplicación
2. Vaya a la URL de autorización del conector.
3. Complete el flujo de OAuth para cada cuenta del mercado de Amazon.

Credenciales que necesitarás en Odoo:

• ID de cliente LWA
• Secreto del cliente LWA
• Token de actualización (generado durante el flujo de OAuth)
• Región de AWS (según el mercado)

---

Instalación y configuración del conector

Instale el módulo ECOSIRE Amazon Connector:

El conector está disponible en el mercado ECOSIRE. Después de la compra:

1. Descargue el archivo zip del módulo desde su cuenta ECOSIRE
2. Sube a tu servidor Odoo: cp amazon_connector.zip /opt/odoo/addons/
3. Extraiga e instale: navegue hasta Aplicaciones → Actualizar lista de aplicaciones → busque "Amazon Connector" → Instalar

Configuración inicial:

Navegue a Inventario → Configuración → Mercados de Amazon (o Ventas → Amazon → Configuración dependiendo de su diseño de Odoo).

Haga clic en Crear para agregar una nueva conexión al mercado:

Prueba la conexión:

Después de guardar, haga clic en Probar conexión. Una prueba exitosa devuelve su nombre de comerciante y confirma el acceso a la API. Si falla, verifique:

• Las credenciales de LWA son correctas.
• El token de actualización no ha caducado
• La región de AWS coincide con su mercado
• La aplicación SP-API está en estado "Publicada" (no "Borrador")

---

Mapeo de productos y sincronización de catálogos

El conector asigna productos Odoo a ASIN de Amazon mediante tres métodos:

Método 1: coincidencia de SKU (recomendado)

Si las referencias internas de sus productos (códigos SKU) coinciden con el SKU del vendedor que utiliza en Amazon, habilite Coincidencia automática de SKU en la configuración del mercado. El conector vinculará automáticamente los productos Odoo a sus listados de Amazon.

Método 2: Coincidencia EAN/UPC

El conector consulta la API del catálogo de Amazon para encontrar listados que coincidan con el código de barras de su producto (EAN13 o UPC). Esto funciona para productos de marca que figuran en el catálogo de Amazon.

Método 3: Mapeo manual de ASIN

Para productos o paquetes personalizados:

1. Vaya al formulario del producto → pestaña Amazon
2. Ingrese el ASIN para cada mercado.
3. Asigna variantes a sus ASIN específicos

Importando el catálogo de Amazon:

En lugar de mapear uno por uno, importe su catálogo de Amazon:

1. Vaya a Amazon → Catálogo → Importar listados
2. Seleccione el mercado
3. El conector descarga todos sus listados activos y crea/actualiza productos Odoo.
4. Revisar los productos importados para verificar la precisión del mapeo de campo.

Configuración de mapeo de campos del producto:

---

Sincronización de pedidos

Los pedidos fluyen de Amazon a Odoo automáticamente. Comprender el ciclo de vida del pedido evita confusiones y errores de cumplimiento.

Flujo de trabajo de sincronización de pedidos:

Amazon Order Created (status: Pending)
        ↓ [15-minute sync interval]
Odoo receives order → creates sale.order in DRAFT
        ↓
Amazon confirms payment (status: Unshipped)
        ↓ [next sync]
Odoo sale.order auto-confirmed → delivery order created
        ↓
Warehouse picks, packs, ships
        ↓
Odoo records shipment → sends tracking to Amazon via API
        ↓
Amazon status: Shipped → Customer receives
        ↓
Amazon releases payment to seller
        ↓
Odoo invoice created and posted (auto or manual)

Configuración de sincronización de pedidos:

Manejo de pedidos cancelados:

Cuando Amazon cancela un pedido (cancelación del cliente o error en el pago):

1. El conector detecta la cancelación en la siguiente sincronización.
2. Si el pedido de entrega no ha sido validado: se cancela automáticamente
3. Si la entrega ya fue validada: el conector crea un RMA de devolución
4. La factura se cancela o revierte con nota de crédito

---

Sincronización de inventario

La precisión del inventario en tiempo real evita la sobreventa, lo que genera sanciones en la cuenta del vendedor de Amazon.

Envío de inventario a Amazon:

Cada vez que ocurre un movimiento de existencias de Odoo (entrega, recepción, devolución, ajuste), el conector envía la cantidad actualizada a la API de inventario de Amazon:

• Productos FBM: cantidad disponible de Odoo menos el stock de seguridad
• Productos Logística de Amazon: Amazon gestiona el inventario de Logística de Amazon; Odoo recibe niveles de Logística de Amazon a través de la API de inventario de Amazon

Configuración del stock de seguridad:

Available for Amazon = On-Hand Quantity - Safety Stock Buffer - Reserved Quantity

Configurar stock de seguridad por producto o de forma global:

• Navegar al producto → pestaña Amazon → Stock de seguridad: 5
• O globalmente en la configuración del mercado → Stock de seguridad predeterminado: 2

Frecuencia de sincronización de inventario:

A diferencia de la sincronización de pedidos (basada en eventos + programada), la sincronización de inventario se basa en lotes:

• Predeterminado: cada 30 minutos
• Después de cualquier movimiento de acciones: dentro de los 5 minutos (estilo webhook)
• Antes de los períodos pico: ejecute sincronización manual

Inventario de varios almacenes:

Si realiza el despacho desde varios almacenes:

1. Cree configuraciones de Amazon Marketplace independientes para cada almacén.
2. El conector agrega inventario en todos los almacenes vinculados.
3. O: utilice la función de inventario de múltiples ubicaciones de Amazon con asignación de cantidad específica del almacén

---

Integración de Logística de Amazon (gestionada por Amazon)

Los pedidos de Logística de Amazon se procesan en el almacén de Amazon, pero Odoo aún necesita conocerlos para la conciliación financiera.

Flujo de trabajo de pedidos de Logística de Amazon en Odoo:

1. Amazon recibe y completa el pedido (Odoo no tiene función de cumplimiento)
2. El conector crea un pedido de venta en Odoo marcado como "FBA"
3. La orden de entrega se valida automáticamente (no hay recogida física en Odoo)
4. Se reduce una ubicación virtual de "Amazon FBA"
5. Se crea y publica la factura.
6. El envío de Amazon se concilia con la factura.

Gestión de existencias de Logística de Amazon:

Enviar inventario a Amazon FBA a través de Odoo:

1. Cree un envío de Logística de Amazon en Odoo (o en Seller Central y vincúlelo)
2. El conector crea una transferencia de stock desde su almacén a la ubicación "Amazon FBA"
3. Validar la transferencia cuando la mercancía se envíe a Amazon.
4. Las cantidades de Logística de Amazon se rastrean en Odoo con fines de generación de informes.

Conciliación de tarifas de Logística de Amazon:

Amazon deduce tarifas (cumplimiento, almacenamiento, referencia) antes de realizar el pago. Configure el conector para:

• Importar informes de liquidación de Amazon
• Creación automática de asientos de diario para tarifas de Logística de Amazon
• Conciliar el importe neto de liquidación con las facturas pendientes

---

Gestión de precios

Reajuste de precios automatizado:

El conector admite actualizaciones automáticas de precios en Amazon según las reglas de la lista de precios de Odoo:

Amazon Price = Odoo List Price × Marketplace Multiplier + Fixed Offset

Configuración:

• Vaya a la configuración del mercado → Precios
• Establecer Fuente de precio: Lista de precios, Costo + margen o Fijo
• Establecer Multiplicador (por ejemplo, 1,0 por el mismo precio, 1,15 por un margen de beneficio del 15%)
• Habilitar Precios de sincronización automática: los precios se envían a Amazon cuando se cambian en Odoo

Manejo de divisas:

Para mercados distintos del dólar estadounidense (EUR, GBP, JPY), el conector:

1. Lee los precios de la lista de precios específica del mercado si está configurado
2. O convierte desde su moneda base utilizando tipos de cambio diarios de Odoo

---

Manejo y monitoreo de errores

Registro de errores de sincronización:

Navegue hasta Amazon → Registros de sincronización para ver todas las operaciones de sincronización:

• Verde: sincronización exitosa
• Amarillo: sincronización parcial (algunos registros fallaron)
• Rojo: error de sincronización total

Cada entrada de error muestra:

• Marca de tiempo y tipo de sincronización (pedidos, inventario, listados)
• Código de error de la API de Amazon
• ID de registro afectado
• Mensaje de error
• Botón de reintento

Errores y soluciones comunes:

Alertas automáticas:

Configure alertas de correo electrónico para errores de sincronización:

• Navega a la configuración del mercado → Notificaciones
• Agregar direcciones de correo electrónico para notificar errores de sincronización
• Establecer umbral de alerta: notificar después de 3 fallas consecutivas

---

Preguntas frecuentes

¿El conector es compatible con el cumplimiento multicanal (MCF) de Logística de Amazon de Amazon?

Sí. MCF le permite utilizar el inventario de Logística de Amazon de Amazon para gestionar pedidos de otros canales de ventas (su sitio web, otros mercados). El conector puede crear solicitudes de cumplimiento de MCF cuando se recibe un pedido de venta de un canal que no es de Amazon, siempre que el producto esté almacenado en Logística de Amazon. Los pedidos de MCF se rastrean en Odoo con los movimientos de ubicación de Logística de Amazon.

¿Cómo maneja el conector las complejas normas fiscales de Amazon (VAT OSS, Marketplace Facilitator)?

Para los mercados donde Amazon recauda y remite impuestos (reglas del Facilitador del Mercado, aplicables en la mayoría de los estados de EE. UU. y la UE para vendedores fuera de la UE), el conector crea pedidos con $0 de impuestos, ya que Amazon maneja la obligación fiscal. Para situaciones que no son de Facilitador, el conector aplica posiciones fiscales configuradas en Odoo en función de la dirección de entrega del comprador.

¿Puedo administrar varias cuentas de Amazon (diferentes cuentas de vendedor) desde una instancia de Odoo?

Sí. Cree múltiples configuraciones de mercado, cada una con sus propias credenciales SP-API. Puede tener configuraciones separadas para diferentes cuentas de vendedor, diferentes mercados bajo la misma cuenta o diferentes empresas en una configuración de Odoo multiempresa. Los pedidos, el inventario y los precios se gestionan según la configuración del mercado.

¿Qué sucede si Amazon cambia un pedido después de haberlo importado a Odoo?

El conector busca modificaciones de orden en cada ciclo de sincronización. Si Amazon actualiza un pedido (por ejemplo, cambio de cantidad antes del envío, corrección de dirección), el conector actualiza el pedido de venta de Odoo correspondiente si aún no ha sido confirmado. Las modificaciones a los pedidos confirmados crean una alerta del sistema para su revisión manual.

¿El conector maneja contenido A+ de Amazon o contenido de marca mejorado?

No. La gestión de contenido A+ es contenido de marketing gestionado exclusivamente a través de Seller Central. El conector se centra en datos operativos: pedidos, inventario, precios y cumplimiento. El contenido del producto (descripciones, imágenes) se puede enviar a los listados básicos de Amazon, pero no a las plantillas de contenido A+.

---

Próximos pasos

Vender en Amazon a través de Odoo es significativamente más eficiente que administrar dos sistemas por separado, pero el conector debe configurarse correctamente desde el principio. Las asignaciones de productos mal configuradas, las configuraciones de sincronización de inventario incorrectas o las configuraciones de impuestos incorrectas crean problemas que se agravan con el tiempo.

El módulo Amazon Connector de ECOSIRE está diseñado específicamente para Odoo 19 Enterprise, y nuestro equipo brinda asistencia de configuración, capacitación y soporte continuo para los vendedores del mercado que administran Amazon a través de Odoo.

Obtenga el conector de Amazon ECOSIRE para Odoo 19 →

La compra incluye licencia del módulo, documentación y 30 días de soporte de implementación para que su integración Amazon-Odoo funcione correctamente desde el primer día.