Stock Sync Pro — Docs

Introducción

Stock Sync Pro es un plugin de WordPress que sincroniza automáticamente el stock y los precios de tu tienda WooCommerce con tus proveedores. Compatible con cualquier fuente de datos: CSV, Excel, API REST o scraping web mediante el servicio adicional Sync Engine.

Una vez instalado y configurado, el plugin ejecuta sincronizaciones automáticas mediante cron jobs de WordPress, sin intervención manual. Cada ciclo actualiza cantidades de stock, precios y disponibilidad de productos.

Requisitos

El plugin no requiere ninguna extensión PHP especial. Funciona en cualquier hosting estándar compatible con WordPress.

Instalación

1. Descarga el plugin

Tras completar la compra en LemonSqueezy recibirás un email con el enlace de descarga del archivo stock-sync-pro.zip. También puedes descargarlo desde tu panel de cliente en LemonSqueezy en cualquier momento.

2. Instala en WordPress

1. Ve a Panel de WordPress → Plugins → Añadir nuevo
2. Haz click en Subir plugin
3. Selecciona el archivo .zip descargado
4. Haz click en Instalar ahora → Activar

3. Activa con tu licencia

Tras activar el plugin, aparecerá un mensaje solicitando la clave de licencia. Introduce la clave que recibiste por email. La activación se hace contra la API de LemonSqueezy y requiere conexión a internet.

Configuración inicial

Tras activar el plugin, accede a WooCommerce → Stock Sync Pro en el menú lateral de WordPress.

• Frecuencia de sync: Selecciona con qué frecuencia se ejecuta la sincronización automática (cada 1h, 2h, 4h, o diaria).
• Modo de actualización: Elige si actualizar solo el stock, solo los precios, o ambos.
• Productos nuevos: Decide si crear automáticamente productos nuevos que aparezcan en la fuente pero no existan en WooCommerce, o solo actualizar los existentes.
• Campo de referencia: Define qué campo de la fuente de datos se usa para identificar el producto en WooCommerce (SKU recomendado).

Fuentes de datos

CSV / Excel

Sube un archivo CSV o Excel con las columnas de tu proveedor. El plugin mapea automáticamente las columnas a los campos de WooCommerce (SKU, stock, precio). Puedes configurar el delimitador, codificación y fila de cabecera.

Formato mínimo esperado:

sku,stock,precio
REF-001,24,19.99
REF-002,0,34.50
REF-003,8,12.00

API REST

Configura la URL del endpoint de tu proveedor y el método de autenticación (API Key en header, Bearer token, o Basic Auth). El plugin hace una petición GET y parsea la respuesta JSON.

Ejemplo de respuesta JSON esperada:

[
  { "referencia": "REF-001", "stock": 24, "pvp": 19.99 },
  { "referencia": "REF-002", "stock": 0,  "pvp": 34.50 }
]

Sync Engine (scraping gestionado)

Para proveedores sin API ni fichero descargable, el servicio adicional Sync Engine extrae los datos de su portal web y los envía automáticamente al plugin. Ver sección Sync Engine.

API REST del plugin

El plugin expone su propia API REST en tu WordPress para permitir integraciones externas y activar sincronizaciones bajo demanda.

Autenticación

Todas las peticiones requieren el header X-Wevica-Key con tu API key del plugin (visible en Panel → Stock Sync Pro → API).

Endpoints

Ejemplo de petición

curl -X POST https://tutienda.com/wp-json/wevica/v1/sync \
  -H "X-Wevica-Key: tu-api-key-aqui"

Sync Engine

El Sync Engine es un servicio adicional gestionado que ejecuta scrapers web en nuestros servidores VPS y envía los datos directamente a tu plugin. Ideal para proveedores que no tienen API ni fichero descargable.

• Nos encargamos de mantener el scraper actualizado cuando el proveedor cambia su web.
• Los datos se envían al plugin mediante la API REST con la frecuencia contratada.
• Sin configuración técnica por tu parte — solo necesitas el plugin instalado y activado.

Para activar el Sync Engine contacta con hola@wevica.com indicando el proveedor que necesitas integrar.

Alertas por Telegram

El plugin puede enviarte notificaciones por Telegram cuando una sincronización falla o cuando el stock de un producto cae por debajo de un umbral.

1. Abre Telegram y busca @BotFather
2. Crea un nuevo bot con el comando /newbot
3. Copia el token del bot
4. Obtén tu Chat ID enviando un mensaje al bot y consultando https://api.telegram.org/bot{TOKEN}/getUpdates
5. Introduce el token y el chat ID en WooCommerce → Stock Sync Pro → Alertas

FAQ técnico