WooCommerce ↔ Holded
El plugin mantiene sincronizados productos, precios, stock y pedidos entre WooCommerce y Holded ERP. La sincronización hacia Holded ocurre en tiempo real al guardar un producto; la sincronización hacia WooCommerce se ejecuta de forma programada mediante Action Scheduler. Al confirmar el pago de un pedido, el plugin crea automáticamente el documento correspondiente en Holded.
Un mecanismo anti-duplicados busca el producto en Holded por SKU antes de crearlo: si ya existe, lo vincula y actualiza en lugar de duplicarlo. Lo mismo ocurre con los contactos: se busca por NIF/CIF y por email antes de crear uno nuevo.
Direcciones de sincronización
- WC → Holded
- En tiempo real al guardar o actualizar un producto o su stock
- Holded → WC
- Programada vía Action Scheduler, intervalo configurable (por defecto: 15 min)
- Pedidos
- Al confirmar el pago, crea una factura o pedido de venta en Holded con todas las líneas del pedido
Limitaciones conocidas
- Los productos variables de WooCommerce se envían a Holded como productos simples independientes, uno por variación. La API de Holded no gestiona variantes correctamente.
- La API de Holded no expone las tarifas de precio secundarias. Solo se sincroniza la Tarifa principal.
- La imagen del producto se sube a Holded automáticamente la primera vez que se crea. Las actualizaciones posteriores de la imagen no se sincronizan.
Somos usuarios activos de Holded e iremos incorporando nuevas capacidades a medida que la API las haga disponibles.
Precios e impuestos
Convierte automáticamente entre precio con y sin IVA según la configuración de WooCommerce y Holded. La alícuota se sincroniza con el campo taxes[] de la API v2, enlazando el tipo de IVA correcto por porcentaje. Soporte para precios de oferta con fechas de inicio y fin.
Gestión de stock y almacén
Sincroniza el stock real entre ambas plataformas. Selección de almacén Holded configurable desde el panel de administración. Tras cada sincronización Holded → WooCommerce que actualice al menos un producto, la caché de LiteSpeed se purga automáticamente.
Descripción independiente para Holded
Cada producto puede tener una descripción específica para Holded, distinta de la descripción de WooCommerce. Configurable por dirección de sincronización.
Anti-duplicados por SKU
Antes de crear un producto en Holded, el plugin lo busca por SKU. Si ya existe, lo vincula y actualiza en lugar de generar un duplicado.
Log de eventos
Registro de los últimos 50 eventos de sincronización con marca de tiempo, tipo de operación y referencia del producto. Descargable y borrable desde el panel.
Sincronización manual
Botones para forzar un pull desde Holded o un push de todos los productos desde WooCommerce, sin esperar al siguiente ciclo programado.
Tarifa de descuento
Holded no dispone de un campo de precio en oferta equivalente al de WooCommerce. El plugin detecta si un producto tiene precio de oferta activo y sincroniza ese precio hacia Holded, garantizando que cualquier factura generada refleje el importe correcto.
Pedidos → Documentos Holded
Al confirmar el pago, el plugin busca o crea el contacto en Holded (por NIF/CIF primero, luego por email) y genera una factura o un pedido de venta con todas las líneas del pedido, gastos de envío e impuestos. El ID del documento y del contacto quedan almacenados en los metadatos del pedido de WooCommerce.
Requisitos
- WordPress 6.0 o superior
- WooCommerce (requerido)
- PHP 7.4 o superior
- Cuenta activa en Holded con API v2 (disponible desde junio 2026)
- Clave API con permisos
all:all.full
Probado con
- WordPress 7.1.3
- WooCommerce 11.2.1
Instalación
Proyecto en desarrollo activo, disponible en GitHub.
Descargue la última versión desde el repositorio, suba el ZIP desde WordPress → Plugins → Añadir nuevo → Subir plugin y actívelo.
Acceda a WooCommerce → Holded Sync e introduzca la API key de Holded (Configuración → Más → Desarrolladores). El plugin requiere la API v2 de Holded (disponible desde junio de 2026) y una clave con permisos all:all.full.
Este plugin es un proyecto propio de Poletto 1976, desarrollado para cubrir una necesidad real de nuestro flujo de trabajo. Somos usuarios de Holded, pero este desarrollo no tiene ninguna relación con ellos: no está financiado, solicitado ni avalado por Holded.