Cómo sincronizar WooCommerce con MercadoLibre correctamente (Guía completa)
Meliconnect permite mantener sincronizados productos entre WooCommerce y MercadoLibre mediante un sistema de sincronización inteligente basado en eventos, webhooks y procesamiento por cola.
Esta guía explica cómo configurar correctamente la sincronización según la forma de trabajo de cada tienda.
Cómo funciona realmente la sincronización
Aunque existan eventos en tiempo real (hooks y webhooks), Meliconnect trabaja mediante una cola interna de sincronización (sync_state).
Cuando ocurre un cambio:
- WooCommerce detecta un cambio de producto
- o MercadoLibre envía un webhook
el producto no necesariamente se sincroniza inmediatamente.
En cambio:
- El producto se agrega o actualiza en la tabla
sync_state - El cron de sincronización procesa esa cola
- Se ejecuta la sincronización real
Este sistema permite:
- Mayor estabilidad
- Reintentos automáticos
- Evitar pérdida de eventos
- Escalar grandes volúmenes de productos
- Resolver conflictos correctamente
Importancia del cron de sincronización
La opción:
Enable scheduled synchronizationdebería permanecer activada en prácticamente todos los casos.
El cron es el encargado de:
- Procesar la cola
sync_state - Ejecutar sincronizaciones pendientes
- Reintentar errores
- Recuperar webhooks perdidos
- Mantener consistencia entre plataformas
Los eventos en tiempo real y webhooks no sincronizan directamente.
Su función es solamente detectar cambios y agregarlos a la cola de sincronización.
El cron es quien finalmente:
- Procesa productos pendientes
- Compara estados
- Resuelve conflictos
- Actualiza WooCommerce o MercadoLibre
Configuración recomendada para la mayoría de tiendas
| Setting | Valor recomendado |
|---|---|
| Enable synchronization | Activado |
| Enable scheduled synchronization | Activado |
| Frequency runs batch | 1 a 5 minutos |
| Items per batch | 20 a 100 |
| Reconcile interval | 3 a 6 horas |
Escenario 1 — MercadoLibre controla todo
Ideal para vendedores que administran:
- Stock desde MercadoLibre
- Precios desde MercadoLibre
- Publicaciones directamente en MercadoLibre
Synchronization Settings
Enable synchronization
Activado
Enable scheduled synchronization
Activado
What to synchronize
- Stock: Activado
- Price: Activado
- Status: Activado
Synchronization direction
MercadoLibre → WooCommerceMercadoLibre Callbacks
Enable webhook processing
Activado
Process order events
Activado
Process item update events
Activado
Auto-create products from events
Opcional
Process stock location events
Activado
Process price events
Activado
Importante
En este modo no se recomienda modificar productos manualmente en WooCommerce, ya que MercadoLibre sobrescribirá los cambios.
Escenario 2 — WooCommerce controla todo
Ideal para:
- Tiendas con ERP conectado a WooCommerce
- Gestión centralizada en WordPress
- Catálogos administrados desde WooCommerce
Synchronization Settings
Enable synchronization
Activado
Enable scheduled synchronization
Activado
What to synchronize
- Stock: Activado
- Price: Activado
- Status: Activado
Synchronization direction
WooCommerce → MercadoLibreMercadoLibre Callbacks
Enable webhook processing
Activado
Process order events
Activado
Process item update events
Desactivado recomendado
Auto-create products from events
Desactivado
Process stock location events
Desactivado
Process price events
Desactivado
Importante
En este modo no se recomienda modificar productos directamente en MercadoLibre, ya que WooCommerce volverá a sobrescribir los cambios.
Escenario 3 — Sincronización bidireccional
Este modo permite trabajar simultáneamente desde WooCommerce y MercadoLibre.
Es ideal para operaciones híbridas o equipos que trabajan sobre ambas plataformas.
Importante
La sincronización bidireccional es el escenario más complejo y puede generar:
- Conflictos
- Sobrescrituras
- Loops de sincronización
- Cambios cruzados
Se recomienda únicamente para usuarios avanzados.
Synchronization Settings
Enable synchronization
Activado
Enable scheduled synchronization
Activado
Synchronization direction
Both directions (bidirectional)Conflict resolution
La opción más recomendada para este modo es:
Last updated wins (by date)MercadoLibre Callbacks
Enable webhook processing
Activado
Process order events
Activado
Process item update events
Activado
Process stock location events
Activado
Process price events
Activado
Recomendaciones
- Evitar editar simultáneamente el mismo producto en ambas plataformas
- Mantener siempre activo el cron
- Usar reconcile interval bajo (1 a 3 horas)
Configuración recomendada según tamaño de tienda
| Tamaño tienda | Batch size | Frecuencia |
|---|---|---|
| Pequeña | 20 | 10 minutos |
| Mediana | 50 | 5 minutos |
| Grande | 100 a 200 | 1 a 2 minutos |
WP-Cron y recomendaciones de hosting
Meliconnect utiliza WP-Cron para ejecutar los procesos automáticos de sincronización.
En sitios con mucho tráfico o catálogos grandes, se recomienda configurar un cron real del servidor para mejorar:
- Estabilidad
- Precisión
- Velocidad de procesamiento
- Consumo de recursos
Conclusión
La forma más estable de trabajar es definir una plataforma principal y utilizar sincronización unidireccional.
Para la mayoría de las tiendas, la configuración más recomendada suele ser:
WooCommerce → MercadoLibreya que simplifica la operación y reduce conflictos.
La sincronización bidireccional debe utilizarse únicamente cuando realmente se necesite trabajar activamente desde ambas plataformas.