Introducción — Por qué necesitas sincronizar eBay y WooCommerce
Vender en eBay y tener tu propia tienda WooCommerce es una estrategia común para diversificar canales de venta.
El problema aparece cuando intentas gestionar inventario manualmente entre ambas plataformas.
Los errores más comunes:
- Sobreventa: vendes en eBay algo que ya no tienes en WooCommerce (o viceversa)
- Precios desactualizados: cambias el precio en una plataforma y olvidas la otra
- Productos duplicados: importas el mismo producto dos veces
- Pedidos perdidos: no registras un pedido de eBay en WooCommerce
Con más de 50 productos, la sincronización manual se vuelve insostenible.
Aquí es donde las mejores prácticas marcan la diferencia.
Práctica 1 — Elige una arquitectura que no dependa de tu servidor
El problema real
La mayoría de plugins de sincronización eBay para WordPress ejecutan todo en PHP dentro del servidor.
Esto genera:
- Timeouts en hostings compartidos (límite típico: 30 segundos)
- Consumo elevado de memoria que afecta al rendimiento
- Cron jobs pesados que compiten con el tráfico de tus clientes
La mejor práctica
Usar arquitectura híbrida, donde el procesamiento pesado ocurre fuera del servidor.
Marketplace Sync Tool implementa esto con dos componentes:
Consejo práctico:
Si tu hosting es compartido o económico (< 10 EUR/mes), evita soluciones que ejecuten llamadas a eBay desde PHP. Los 30 segundos de límite de PHP harán fallar sincronizaciones grandes.
Práctica 2 — Implementa un sistema anti-duplicados de múltiples niveles
El problema
Importas un producto de eBay y lo vuelves a importar sin darte cuenta. Resultado: dos productos idénticos con stock incorrecto.
La mejor práctica
Usar matching multi-nivel antes de crear un nuevo producto.
Marketplace Sync Tool implementa 4 niveles de verificación:
Consejo práctico:
Asegúrate de que tu herramienta busque por múltiples criterios, no solo por SKU.
Dato adicional
Marketplace Sync Tool incluye herramienta de limpieza automática que:
- detecta SKUs con formato
e-XXXXoebay-XXXX - migra imágenes al producto canónico
- elimina duplicados automáticamente
Convención de SKUs recomendada:
- Si eBay tiene SKU propio → usarlo
- Si no → generar
e-{item_id} - SKUs legacy
ebay-XXXX→ convertir ae-XXXX
Práctica 3 — Usa reglas de exclusión para proteger tus datos personalizados
El problema
Personalizas título, descripción o imágenes en WooCommerce y la siguiente sincronización sobrescribe tus cambios.
La mejor práctica
Configura exclusiones por producto y campo.
Dato crítico: El stock siempre se sincroniza, independientemente de las exclusiones, para evitar sobreventas.
Sobre impuestos: nunca se modifican. WooCommerce gestiona impuestos manualmente.
Consejo práctico:
Configura exclusiones después de la primera importación y antes de la segunda sincronización.
Práctica 4 — Sincroniza en ambas direcciones (pero con propósitos diferentes)
eBay → WooCommerce
Importa:
- Título, descripción, precio, stock, imágenes, SKU, atributos, peso, variaciones, pedidos
Propósito: poblar tu tienda WooCommerce con productos existentes en eBay
WooCommerce → eBay
Actualiza solo:
- Stock y precios
- Se requiere que los productos tengan Offer ID de la eBay Inventory API
- Se procesan en lotes de 25 productos
Consejo práctico:
Activa sincronización WC → eBay solo para productos que se venden activamente en ambas plataformas.
Requisito importante: Productos sin Offer ID son ignorados automáticamente con mensaje de error claro.
Práctica 5 — Automatiza la sincronización con cron inteligente
El problema
Sincronizar manualmente cada venta es insostenible.
Un cron agresivo puede sobrecargar tu servidor o hacer llamadas innecesarias a eBay.
La mejor práctica
Configura un cron inteligente, adaptado a tu volumen de ventas.
Cron en la app de escritorio (recomendado)
Cron en el plugin WordPress (fallback)
Dato técnico:
La app envía un heartbeat cada 30 segundos. Si hay clientes activos, el cron del servidor no hace nada. Solo actúa como fallback si no hay clientes conectados.
Consejo según volumen:
- < 50 productos → manual
- 50–200 → cada hora
- 200–500 → cada 30 min
- 500+ → cada 10–15 min
Práctica 6 — Protege tus credenciales con cifrado real
El problema
Las credenciales de eBay (Client ID, Client Secret, tokens OAuth2) son extremadamente sensibles.
La mejor práctica
Nunca almacenar en texto plano. Marketplace Sync Tool utiliza 3 capas de seguridad:
- Cifrado con keychain del SO
- Electron safeStorage (DPAPI en Windows)
- No hay JSON con texto plano
- API Keys hex-only seguras
- Generadas con
bin2hex(random_bytes(32)) - Evita bloqueos de firewalls
- Generadas con
- HTTPS obligatorio + hash_equals
- Evita ataques de timing
- Solo permite HTTP en localhost/desarrollo
Consejo práctico:
- Instala Let’s Encrypt si no tienes HTTPS
- Regenera API Key periódicamente
- Nunca compartas API Key sin cifrar
Práctica 7 — Gestiona las imágenes de forma inteligente
El problema
Las imágenes de eBay están en su CDN. Si se eliminan, tus productos pierden imágenes.
La mejor práctica
Importar imágenes al media library de WordPress (sideload):
- Descarga desde CDN eBay (timeout 30s)
- Detecta formato (jpg, png, gif, webp)
- Sube a media library usando
media_handle_sideload() - Primera imagen → destacada, resto → galería
Consejo práctico:
Para la primera importación masiva, hazlo en lotes de 50–100 productos.
Si ya tienes mejores imágenes → usa la regla de exclusión images.
Práctica 8 — Importa pedidos para una vista unificada
El problema
Sin importar pedidos, tienes que revisar paneles separados en eBay y WooCommerce.
La mejor práctica
Importar automáticamente pedidos a WooCommerce:
- Datos de comprador y dirección
- Productos vinculados por SKU/ID
- Estado inicial: Pendiente
- Verificación para evitar duplicados (
_wces_ebay_order_id)
Consejo práctico:
Activa importación de pedidos en el plugin y decide cuándo procesarlos.
Práctica 9 — Usa la galería visual para monitorizar el estado
El problema
Sin una vista clara, no sabes qué productos están sincronizados, pendientes o con problemas.
La mejor práctica
Usar galería visual con badges.
Vista WooCommerce:
Vista eBay:
Consejo práctico:
Revisa la galería después de cada sincronización. Los productos en amarillo requieren resíncronización para completar la vinculación.
Práctica 10 — Configura correctamente tu marketplace y moneda
El problema
eBay opera en 20+ marketplaces con monedas diferentes. Una configuración incorrecta provoca precios erróneos.
La mejor práctica
Configurar correctamente Marketplace ID y moneda desde el inicio.
Dato técnico:
La moneda se guarda por producto en _wces_ebay_currency. La sincronización WC → eBay usa esta moneda para evitar errores.
Deja una respuesta