Conexión Dropi WooCommerce — Plugin

¿Qué hace Drunel Dropi Stock Sync?

Este plugin sincroniza únicamente el stock (cantidad e inventario)
de los productos y variaciones de WooCommerce que tú conectes manualmente a un
ID de Dropi. No importa catálogo, no crea productos nuevos, no modifica precios,
títulos, imágenes ni categorías. Su único trabajo es mantener el inventario de
WooCommerce igual al de Dropi, para evitar vender algo que ya se agotó.

Conexión manual, producto por producto

Tú decides qué productos conectar. Desde la ficha de edición de cada producto
(o de cada variación, si el producto es variable) encontrarás un campo para
pegar el ID de Dropi correspondiente y un checkbox para activar
o pausar la sincronización de ese producto en concreto.

• Producto simple: se conecta con su propio ID de Dropi.
• Producto variable: se conecta con el ID principal
  de Dropi (el del producto padre). Esa única consulta trae el stock de
  todas sus variaciones en una sola llamada — no hace falta
  conectar cada variación por separado a nivel de configuración, aunque
  internamente el plugin sí guarda y actualiza el stock variación por
  variación.

Desmarcar el checkbox pausa la sincronización de ese producto
(no borra el ID). Si quieres desconectarlo por completo, simplemente borra el
ID de Dropi y guarda el producto.

Sincronización automática y manual

Hay dos formas de mantener el stock actualizado:

• Automática: un ciclo periódico (configurable en
  «Configuración Dropi») revisa por lotes todos los productos conectados y
  activos, usando Action Scheduler para no sobrecargar el servidor.
• Manual: el botón «Sincronizar ahora» en la
  ficha del producto fuerza una sincronización inmediata de ese producto (y,
  si es variable, de todas sus variaciones conectadas) sin esperar al
  siguiente ciclo.

Seguridad ante errores de conexión

Si Dropi no responde, hay un timeout o cualquier error de red, el plugin
nunca interpreta eso como «stock cero». Conserva el último
valor de stock conocido y registra el incidente en el log, para que puedas
revisarlo sin que eso afecte tus ventas mientras tanto.

Aviso de reservas (backorders)

Si permites reservas («backorders») en un producto o variación que también
está conectado a Dropi, el plugin te muestra un aviso en la ficha del producto.
No cambia nada automáticamente: solo te avisa, porque permitir reservas en un
producto sincronizado puede generar ventas de algo que en Dropi ya no hay.

Dónde ver el estado de la sincronización

• Columna «Dropi» en el listado de productos de WooCommerce:
  muestra de un vistazo si el producto está conectado, activo, con error, o
  sin conectar.
• Resumen en la ficha del producto: para productos variables,
  un mini resumen indica cuántas variaciones están activas con stock y
  cuántas agotadas.
• Registro (log): en WooCommerce → Estado → Registros,
  selecciona la fuente dropi-stock-sync para ver el detalle de
  cada sincronización, incluidos los errores.

Configuración disponible

• Token / clave de Dropi: credencial de tu cuenta de Dropi.
• URL base de la API: según el país de tu cuenta Dropi.
• Intervalo de sincronización: cada cuánto se ejecuta el
  ciclo automático (en minutos).
• Tamaño del lote: cuántos productos se procesan por
  ejecución, para no saturar el servidor en catálogos grandes.

Requisitos previos

• WordPress con WooCommerce instalado y activo.
• PHP 7.4 o superior.
• Una cuenta activa de Dropi con acceso a su API (token/clave de integración).

Paso 1 — Instalar el plugin

Desde el administrador de WordPress, ve a Plugins → Añadir nuevo →
Subir plugin, selecciona el archivo .zip descargado y
haz clic en Instalar ahora. Alternativamente, puedes subir la
carpeta descomprimida por FTP a wp-content/plugins/.

Paso 2 — Activar el plugin

Una vez instalado, haz clic en Activar. Si WooCommerce no
está instalado o activo, verás un aviso indicándolo — actívalo primero y
vuelve a este paso.

Paso 3 — Configurar la conexión con Dropi

Ve a WooCommerce → Configuración Dropi y completa:

• Token de Dropi: pégalo desde tu panel de Dropi.
• URL base de la API: la correspondiente a tu país.
• Intervalo (minutos): puedes dejar el valor sugerido si no
  sabes cuál elegir; se recomienda ajustarlo según cuántos productos tengas
  conectados.
• Tamaño del lote: el plugin sugiere un valor según la
  cantidad de productos que ya tengas conectados.

Guarda los cambios.

Paso 4 — Conectar tu primer producto

Abre cualquier producto de WooCommerce que también exista en Dropi:

• Si es un producto simple: en la pestaña «General» de los
  datos del producto, pega el ID de Dropi y marca el checkbox de
  sincronización.
• Si es un producto variable: pega el ID principal
  de Dropi (el del producto padre) y marca el checkbox. El plugin
  sincronizará automáticamente el stock de todas sus variaciones.

Guarda el producto.

Paso 5 — Probar la sincronización

En la misma ficha del producto verás el botón «Sincronizar ahora».
Haz clic y confirma que aparece un aviso con los resultados (procesados,
actualizados, con error). Si todo salió bien, el stock ya quedó actualizado.

Paso 6 — Repetir con el resto del catálogo

Repite el paso 4 con cada producto que quieras mantener sincronizado. No hace
falta conectar todo tu catálogo de una vez: puedes ir sumando productos poco a
poco y el ciclo automático se encargará del resto sin que tengas que volver a
tocarlos.

¿Algo no funciona?

Revisa el registro en WooCommerce → Estado → Registros,
filtrando por la fuente dropi-stock-sync. Ahí queda anotado
cualquier error de conexión, ID inválido o problema de sincronización, sin
que eso afecte el stock ya guardado.