Conector Odoo eBay: listado, pedidos y sincronización de inventario

eBay sigue siendo uno de los mercados más grandes del mundo con 132 millones de compradores activos en todo el mundo. Para los vendedores que utilizan tanto eBay como Odoo 19 Enterprise, administrar dos sistemas separados para pedidos, inventario y datos de clientes es ineficiente y propenso a errores. El conector ECOSIRE Odoo eBay sincroniza su tienda eBay con Odoo, automatizando todo el flujo de trabajo de ventas, desde la creación de listados hasta el cumplimiento de pedidos y la contabilidad posventa.

Esta guía cubre todo, desde la configuración de credenciales API de eBay hasta la gestión de listados, la automatización de pedidos, la sincronización de inventario, el manejo de devoluciones y el monitoreo del desempeño del vendedor.

Conclusiones clave

• El conector utiliza las API REST de eBay y OAuth 2.0 para la autenticación
• Admite eBay Motors, eBay Business & Industrial y categorías de consumidores
• Se admiten listados de precio fijo y de subasta (importación de pedidos solo para subastas)
• La sincronización del inventario actualiza las cantidades de eBay dentro de los 10 minutos posteriores a los cambios en las existencias de Odoo.
• La configuración de Agotado (OOS) de eBay se gestiona automáticamente cuando la cantidad llega a 0
• La importación de pedidos incluye detalles del comprador, requisitos de envío y montos de pago de eBay.
• Los casos de devoluciones y garantía de devolución de dinero de eBay se sincronizan con el flujo de trabajo RMA de Odoo
• Soporte para múltiples tiendas: administre múltiples cuentas de vendedor de eBay desde una instancia de Odoo

---

Configuración y autorización de la API de eBay

El conector utiliza la suite REST API de eBay, reemplazando la antigua API comercial para la mayoría de las operaciones.

Paso 1: crea una cuenta de desarrollador de eBay

1. Regístrese en developer.ebay.com
2. Cree una nueva aplicación en Mi cuenta → Conjuntos de claves de aplicación
3. Anote su ID de aplicación (ID de cliente), ID de desarrollo y ID de certificado (secreto de cliente).
4. Genere un RuName (nombre de URL de redireccionamiento de eBay) para el flujo de OAuth.

Paso 2: Configurar ámbitos de OAuth

Su aplicación necesita los siguientes ámbitos de OAuth:

https://api.ebay.com/oauth/api_scope
https://api.ebay.com/oauth/api_scope/sell.inventory
https://api.ebay.com/oauth/api_scope/sell.inventory.readonly
https://api.ebay.com/oauth/api_scope/sell.fulfillment
https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly
https://api.ebay.com/oauth/api_scope/sell.account
https://api.ebay.com/oauth/api_scope/sell.account.readonly
https://api.ebay.com/oauth/api_scope/commerce.identity.readonly

Paso 3: Generar tokens de usuario

Se requieren tokens de usuario de OAuth 2.0 (no tokens de aplicación) para las operaciones del vendedor:

1. En la configuración del conector, haga clic en Autorizar con eBay
2. Complete el flujo de consentimiento de eBay OAuth
3. El conector almacena el token de acceso y el token de actualización automáticamente.
4. Los tokens caducan después de 18 meses; el conector se actualiza automáticamente usando el token de actualización

Sandbox frente a producción

Pruebe siempre primero con el entorno sandbox de eBay:

• API de zona de pruebas: api.sandbox.ebay.com
• Las credenciales de Sandbox son diferentes de las credenciales de producción.
• Crear cuentas de vendedor y comprador de sandbox en developer.ebay.com/sandbox

---

Instalación y configuración del conector

Instalar desde el mercado ECOSIRE:

1. Compre el módulo Conector de eBay en Productos ECOSIRE
2. Instalar a través de Aplicaciones → Actualizar lista de aplicaciones → buscar "Conector de eBay" → Instalar
3. Vaya a Inventario → Configuración → Tiendas eBay o Ventas → eBay

Configuración de la tienda:

Políticas de Cumplimiento:

Antes de publicar, configure las políticas de cumplimiento de eBay en Seller Hub:

• Política de envío: transportistas, tiempo estimado de entrega, tiempo de manipulación
• Política de devoluciones: devoluciones en 30 días, tarifa de reposición
• Política de pago: pagos gestionados por eBay requeridos desde 2021

El conector hace referencia a estos por ID de política. Vincúlalos en la configuración de la tienda.

---

Gestión de listados

El conector admite la creación y gestión de listados de precio fijo directamente desde los registros de productos de Odoo.

Crear un listado a partir de un producto Odoo:

1. Abra el formulario del producto → pestaña eBay
2. Haga clic en Listar en eBay
3. Configure los campos del listado:

• Título: hasta 80 caracteres, completado automáticamente a partir del nombre del producto
• Categoría: seleccione la categoría de eBay (busque por palabra clave o ID)
• Condición: Nuevo, Usado, Para piezas/No funciona, etc.
• Precio: utiliza la lista de precios de productos o el precio anulado
• Cantidad: stock disponible o cantidad personalizada
• Duración: GTC (válido hasta cancelar) recomendado para precio fijo
• Detalles del artículo: atributos requeridos por eBay para la categoría

4. Haga clic en Publicar en eBay

Plantillas de listado:

Para vendedores con muchos productos en la misma categoría, cree plantillas de listado:

• Vaya a eBay → Plantillas → Crear plantilla
• Configurar campos compartidos: categoría, envío, política de devolución, detalles del artículo
• Aplicar plantillas a múltiples productos simultáneamente.

Listado masivo:

Para catálogos con más de 100 productos:

1. Exporte la lista de productos a CSV con los campos obligatorios de eBay
2. Utilice la importación masiva en eBay → Listado masivo → Cargar CSV
3. Revisar y publicar por lotes

Sincronización de listado:

Cambios realizados en la sincronización de Odoo con eBay:

• Cambios de precio → Precio de eBay actualizado en 15 minutos
• Cambios en la descripción del producto → Listado de eBay actualizado en la próxima sincronización
• Cambios en las imágenes → Imágenes de eBay actualizadas (es necesario volver a publicar algunos cambios)

Especificaciones del artículo de la categoría de eBay:

eBay requiere atributos específicos de cada categoría (por ejemplo, marca, talla, color de la ropa). El conector asigna los atributos del producto Odoo a los detalles del artículo de eBay:

---

Sincronización de pedidos

Proceso de importación de pedidos:

Los pedidos fluyen de eBay a Odoo automáticamente:

1. El comprador realiza el pedido en eBay y completa el pago.
2. eBay crea un pedido en estado "En espera de envío".
3. El conector sondea la API de pedidos de eBay cada 15 minutos (configurable)
4. Odoo crea un pedido de venta con detalles del comprador de eBay
5. La orden de entrega se crea automáticamente.
6. El almacén cumple el pedido y valida la entrega.
7. El conector envía el número de seguimiento a eBay
8. eBay marca el pedido como "Enviado"

Mapeo de datos del pedido:

Enviando información de seguimiento:

Cuando validas una entrega en Odoo e ingresas un número de seguimiento:

1. El conector detecta el número de seguimiento en el stock.picking
2. Llama a la API de cumplimiento de pedidos de eBay para agregar seguimiento.
3. El comprador recibe una notificación de eBay con detalles de seguimiento.
4. eBay actualiza el estado del pedido a "Enviado".

Transportistas admitidos para actualizaciones automáticas de seguimiento: USPS, UPS, FedEx, DHL, Royal Mail, Deutsche Post y más de 100 a través de la lista de códigos de transportistas de eBay.

---

Sincronización de inventario

Un inventario preciso evita que las métricas de "defectos" de eBay se produzcan en situaciones de falta de existencias.

Mecanismo de sincronización de inventario:

El conector utiliza la API de inventario de eBay con la siguiente lógica:

eBay Quantity = Odoo On-Hand - Safety Stock Buffer - Odoo Reserved Quantity

Cuando el inventario se sincroniza:

• Después de cada orden de entrega confirmada (inmediata)
• Después de cada recibo validado (inmediato)
• Sincronización completa programada cada 30 minutos
• Sincronización manual disponible en cualquier momento

Manejo de existencias agotadas:

Configure qué sucede cuando la cantidad llega a 0:

• Opción A: modo OOS (Recomendación de Odoo): mantenga el listado activo con 0 cantidades usando la opción Agotado de eBay: el listado mantiene su historial y reseñas
• Opción B: Finalizar anuncio: eliminar anuncio de eBay cuando el stock llegue a 0 y volver a ponerlo en venta cuando se reponga
• Opción C: Establecer mínimo: establezca una cantidad mínima (por ejemplo, 1) y vaya a 0 en Odoo solo cuando se active el mínimo OOS

Finalizar y volver a publicar anuncios con frecuencia perjudica la ubicación de búsqueda de eBay. Se recomienda el modo OOS.

Inventario de múltiples ubicaciones:

Si realiza el despacho desde varios almacenes:

• Establecer un almacén principal para eBay en la configuración de la tienda
• O agregar inventario en múltiples almacenes
• Configurar por producto si algunos SKU se envían desde ubicaciones específicas

---

Manejo de devoluciones y reembolsos

La Garantía de devolución de dinero de eBay significa que los vendedores deben aceptar devoluciones. El conector maneja el flujo de trabajo de devolución en Odoo.

Flujo de trabajo de sincronización de retorno:

1. El comprador abre una solicitud de devolución en eBay.
2. El conector importa el caso de devolución a Odoo como una RMA (Autorización de devolución de mercancía)
3. El equipo de operaciones revisa el motivo de la devolución en Odoo.
4. Si se acepta: genere una etiqueta de envío de devolución (si proporciona etiquetas prepagas)
5. El comprador devuelve el artículo
6. Recibir productos devueltos en Odoo → validar recibo
7. Procesar reembolso: crear una nota de crédito en Odoo → el conector activa el reembolso de eBay

Seguimiento de los estados de los casos de devolución:

---

Supervisión del rendimiento del vendedor de eBay

eBay evalúa a los vendedores según métricas que afectan directamente la visibilidad de los anuncios. Monitorearlos en Odoo:

Métricas clave del vendedor de eBay:

Panel de rendimiento en Odoo:

Navegue a eBay → Rendimiento para ver:

• Pedidos por estado durante los últimos 30 días
• Envíos tardíos (pedidos enviados después del tiempo de manipulación)
• Tasa de retorno por categoría
• Resumen de defectos con ID de pedido
• Nivel de vendedor proyectado para la próxima evaluación.

---

Precios y promociones

Reglas de precios automatizadas:

Configure precios dinámicos de eBay basados en los datos de costos de Odoo:

eBay Price = Product Cost × (1 + Target Margin %) + eBay Fee Buffer

Ejemplo: si el costo es de $10, el margen objetivo es del 40 % y las tarifas de eBay suelen ser del 12,5 %:

eBay Price = $10 × 1.40 / (1 - 0.125) = $16.00

Promociones de rebajas:

El conector admite la integración del Administrador de promociones de eBay:

• Crear ventas en Odoo → el conector crea las promociones de eBay correspondientes
• Ventas flash, descuentos en pedidos y promociones de envío.
• Promociones programadas: fechas de inicio y finalización configuradas en Odoo

---

Preguntas frecuentes

¿El conector admite listados de subastas de eBay?

El conector importa pedidos de listados de subastas como si fueran listados de precio fijo. Sin embargo, la creación y gestión de listados de subastas (estableciendo el precio inicial, el precio de reserva y la duración) a través del conector es limitada: las subastas se gestionan mejor directamente en eBay Seller Hub. La principal capacidad de gestión de listados del conector es para listados de precio fijo/GTC.

¿Cómo gestiona el conector los pagos gestionados de eBay (procesamiento de pagos de eBay)?

Desde 2021, eBay procesa todos los pagos mediante pagos gestionados por eBay. El conector importa los totales de los pedidos, incluido el precio de pago de eBay (precio del artículo + envío). eBay envía los ingresos netos (después de las tarifas) a su cuenta bancaria. El conector admite la importación de informes de pagos de eBay para su conciliación, creando automáticamente asientos de diario que contabilizan las tarifas de eBay deducidas de los pagos.

¿Puedo sincronizar productos de Odoo con varias tiendas de eBay (diferentes cuentas de vendedor)?

Sí. Cree múltiples configuraciones de tiendas eBay, cada una con sus propias credenciales OAuth. Los productos se pueden enumerar en varias tiendas simultáneamente con anulaciones de precios específicas de cada tienda. El inventario se rastrea globalmente en Odoo y se asigna a los listados de cada tienda según las reglas configuradas.

¿Qué sucede con el historial de mi anuncio de eBay (reseñas, recuento de ventas) cuando actualizo un anuncio?

Las actualizaciones de listados estándar (precio, cantidad, descripción, imágenes) preservan el historial de listados y el recuento de ventas. Acciones que restablecen el historial: finalizar y volver a publicar, cambiar la categoría de eBay para algunas categorías. El conector utiliza el punto final de "oferta de actualización" de la API de inventario de eBay para cambios de rutina, lo que preserva el historial.

¿Cómo gestiona el conector los requisitos aduaneros y de ventas internacionales de eBay?

Para ventas transfronterizas a través de eBay International Shipping o GSP (Global Shipping Program), el conector marca la orden de venta con el país del comprador. Usted configura posiciones fiscales apropiadas y tratamiento fiscal en Odoo para ventas internacionales. Los pedidos de GSP se envían al centro logístico nacional de eBay; La documentación aduanera la gestiona el programa GSP de eBay, no sus operaciones.

---

Próximos pasos

La gestión de las operaciones de eBay a través de Odoo elimina la entrada manual de datos, evita errores de inventario y le brinda una única fuente de información para todos los canales de ventas. El conector ECOSIRE eBay está diseñado para Odoo 19 Enterprise e incluye soporte completo para las últimas API REST de eBay.

Obtenga el conector ECOSIRE de eBay para Odoo 19 →

Cada compra incluye la licencia del módulo, documentación de configuración y acceso a nuestro equipo de soporte de implementación para que su sincronización eBay-Odoo funcione sin problemas desde el primer día.