Pasarela de pago WooCommerce Sync

WooCommerce Sync: cómo funciona, paso a paso

WooCommerce Sync está pensado para redes de tiendas WooCommerce que comparten catálogo: una tienda física con su réplica online, una central que abastece a varias franquicias, simplemente dos webs de la misma marca que necesitan tener el mismo stock o dos tiendas de un mismo dueño que tienen un catálogo idéntico o que coinciden parte. El plugin monta una comunicación directa entre esas tiendas usando la API REST de WooCommerce, sin pasar por servicios de terceros ni exportar/importar CSVs a mano.

A diferencia de otras soluciones del mercado, que ofrecen la sincronización como un servicio externo de pago alojado en su propia plataforma, aquí no hay intermediarios: el servicio lo prestas tú mismo, desde tu propio servidor, hablando directamente con las tiendas cliente. Nada de tus datos sale hacia una nube ajena; todo el proceso ocurre entre tus instalaciones de WordPress.

A continuación te explicamos cómo se configura y cómo trabaja por dentro, para que sepas exactamente qué está pasando en cada paso.

1. Elige el rol de cada tienda: Servidor o Cliente

Al activar el plugin por primera vez, aparece un asistente de bienvenida que te pide elegir el papel de esa instalación:

• Servidor: esta tienda actúa como coordinadora. Es la que gestiona la lista de clientes, envía y recibe stock, y reparte las novedades entre el resto de tiendas conectadas.
• Cliente: esta tienda se conecta a un servidor para recibir actualizaciones de stock. Cuando el stock cambia en el cliente, este avisa al servidor para que lo distribuya al resto de la red.

Si eliges el modo Cliente, el asistente te pedirá además el usuario de WordPress que se usará para exponer el catálogo por la API REST, y te mostrará las claves API de WooCommerce disponibles (o te enlazará directamente a crear una nueva desde WooCommerce → Ajustes → Avanzado → REST API).

2. Da de alta las tiendas cliente (desde el Servidor)

Desde el Servidor, en WooCommerce Sync → Ajustes encontrarás una tabla editable donde añadir cada tienda cliente con tres datos: la URL del sitio, la Consumer Key y el Consumer Secret de su API REST. Estas claves se guardan enmascaradas en pantalla (solo se muestran los últimos caracteres) por seguridad.

Una vez añadida una tienda, puedes pulsar «Probar conexión» para verificar en el acto que las claves funcionan y que el plugin también está instalado en el otro extremo. Si algo falla, el plugin te dice exactamente qué revisar (claves incorrectas, permisos del usuario API, etc.), en lugar de un simple «error».

3. El panel de gestión por cada tienda cliente

Cada cliente dado de alta obtiene su propia página de gestión, organizada en pestañas:

• Productos (simples): listado con imagen, SKU, título, stock local y stock remoto lado a lado. Si ambos coinciden, verás un check verde; si no, aparecen dos botones para sincronizar en el sentido que prefieras (Local → Remoto o Remoto → Local).
• Productos (variables): lo mismo que el anterior pero agrupado por producto padre, mostrando cada variación con sus atributos (talla, color, etc.).
• Desconocidos localmente: productos que existen en la tienda remota pero no en la tuya, identificados por SKU, para que detectes catálogo que aún no has dado de alta.
• Desconocidos remotamente: justo al revés — productos que tienes tú pero no existen todavía en la tienda remota.
• Herramientas: el disparador de la sincronización masiva (ver punto 4).
• Programación: activar o desactivar la sincronización automática cada hora, y consultar el registro de la última ejecución.

4. Sincronización masiva con barra de progreso

Desde la pestaña Herramientas puedes lanzar una sincronización completa del catálogo en cualquiera de los dos sentidos. El proceso avanza por lotes (por defecto, de 10 productos), muestra una barra de progreso con el porcentaje completado y va imprimiendo en pantalla, producto a producto, el resultado de cada sincronización (ID local, ID remoto, SKU y si se ha actualizado correctamente o ha dado error).

En todo momento puedes pausar, reanudar o detener el proceso sin perder lo ya sincronizado.

5. Sincronización automática al vuelo (la magia de fondo)

Aquí está la parte más técnica, y la que hace que no tengas que acordarte de sincronizar nada: el plugin se engancha a los hooks de WooCommerce que se disparan cuando cambia el stock de un producto o una variación. En ese mismo instante, registra el cambio (SKU, cantidad, origen y una marca de versión) en una tabla interna a modo de bandeja de salida.

Una tarea en segundo plano, gestionada por Action Scheduler (el mismo sistema de colas que usa WooCommerce para sus propios procesos), revisa periódicamente esa bandeja de salida y envía cada cambio pendiente a las tiendas correspondientes. En el lado receptor, el cambio entra en una bandeja de entrada equivalente y se procesa de la misma forma, evitando así bucles de sincronización entre tiendas.

6. Sincronización programada (red de seguridad)

Además de la sincronización en tiempo real, puedes activar en la pestaña Programación una pasada automática cada hora que repasa todo el catálogo. Es útil como respaldo ante cualquier cambio que no se haya disparado correctamente (por ejemplo, tras una edición manual en la base de datos) y te deja un registro con el resultado de la última ejecución.

7. Panel de estado y diagnóstico

Para los momentos en los que quieras mirar «debajo del capó», WooCommerce Sync incluye una página de estado con:

• Histórico completo de la bandeja de salida y de entrada (pendientes e históricos), con SKU, stock, origen y estado.
• Registro de errores del worker, con fecha, tipo e ítem afectado.
• Estado de las tareas programadas en Action Scheduler: próxima ejecución, tareas pendientes, en curso y fallidas.
• Herramientas de resolución de problemas: forzar la reprogramación de tareas atascadas o lanzar manualmente el procesamiento de las bandejas.

En resumen

WooCommerce Sync no reinventa la rueda: aprovecha la API REST y el sistema de colas que WooCommerce ya trae de serie para mantener el stock coordinado entre varias tiendas, combinando tres velocidades de sincronización —al vuelo, manual y programada— según lo que necesite tu operativa en cada momento. Y lo hace sin depender de nadie más: el servicio de sincronización eres tú, con tu propio servidor como centro de la red.