Integración con WooCommerce

Integración con WooCommerce

La integración con WooCommerce permite conectar tu tienda online con BikeCRM para sincronizar productos, clientes y pedidos de forma automática. Gestiona todo desde un solo lugar y mantén tu inventario actualizado en ambas plataformas.

🔗 ¿Qué se sincroniza?

Productos

Bidireccional

• De WooCommerce a BikeCRM (pull)
• De BikeCRM a WooCommerce (push)
• Incluye variaciones de productos

Stock

Automático

• Las ventas en BikeCRM actualizan stock en WooCommerce
• Las ventas online no generan doble descuento
• Prevención de bucles infinitos

Clientes

WooCommerce → BikeCRM

• Importación de clientes existentes
• Creación automática con pedidos
• Vinculación por email o teléfono

Pedidos

WooCommerce → BikeCRM

• Pedidos online aparecen en BikeCRM
• Con desglose de IVA
• Facturación automática opcional

⚙️ Configuración inicial

Para activar la integración necesitas configurar los siguientes datos en la ficha de tu negocio:

1. Activar la integración

   Marca la opción WooCommerce activado en la configuración de tu negocio.

2. URL de la tienda

   Introduce la URL de tu tienda WooCommerce (por ejemplo, https://mitienda.com/).

3. Credenciales de API

   • Usuario: tu nombre de usuario de WordPress
   • Application password: genera una contraseña de aplicación desde WordPress > Usuarios > Perfil > Contraseñas de aplicación

4. Configurar webhooks en WooCommerce

   En tu panel de WooCommerce, ve a Ajustes > Avanzado > Webhooks y crea los siguientes:

   Webhook	Tema	URL de entrega
   Productos	Producto actualizado	https://api.bikecrm.com/webhooks/product/TU-SLUG
   Productos eliminados	Producto eliminado	https://api.bikecrm.com/webhooks/product/TU-SLUG
   Pedidos	Pedido actualizado	https://api.bikecrm.com/webhooks/order/TU-SLUG

   Utiliza el secreto del webhook que aparece en la configuración de tu negocio en BikeCRM.

5. Configurar IVA

   Indica si los precios en WooCommerce incluyen IVA o no. Esto es importante para que los precios se conviertan correctamente entre ambas plataformas.

Precaución

La contraseña de aplicación (Application Password) es diferente de tu contraseña de WordPress. Se genera desde el perfil de usuario en WordPress y da acceso a la API sin exponer tu contraseña real.

📦 Sincronización de productos

De WooCommerce a BikeCRM

Cuando un producto se actualiza en WooCommerce, BikeCRM lo recibe automáticamente mediante webhooks:

• Productos simples: se crean o actualizan directamente
• Productos variables: cada variación se convierte en un producto individual en BikeCRM, agrupados bajo un producto padre
• Datos sincronizados: nombre, precio, stock, SKU, descripción, imagen

Productos simples

Un producto simple de WooCommerce se corresponde con un producto en BikeCRM. Se sincronizan nombre, precios (venta y recomendado), stock, SKU, descripción e imagen.

Productos variables

Un producto variable (por ejemplo, una camiseta con tallas S, M, L) se descompone en BikeCRM:

• Se crea un producto padre con el nombre del producto
• Cada variación se convierte en un producto individual (ej: “Camiseta - Talla M”)
• Cada variación tiene su propio stock, precio y SKU

De BikeCRM a WooCommerce

Cuando modificas un producto en BikeCRM, los cambios se envían automáticamente a WooCommerce:

• Precio de venta y precio recomendado (PVP)
• Stock (se actualiza con cada venta, compra o ajuste)
• Nombre y SKU
• Estado: publicar o poner en borrador desde BikeCRM

Consejo

Activa la opción Publicar en WooCommerce en la ficha de un producto para que se sincronice. Si desactivas esta opción, el producto pasará a borrador en WooCommerce.

Sincronización masiva

Desde el panel de administración puedes lanzar una sincronización masiva de todos los productos de WooCommerce hacia BikeCRM. Esto es útil para la configuración inicial o para resolver discrepancias.

🛒 Sincronización de pedidos

Los pedidos realizados en tu tienda WooCommerce aparecen automáticamente en BikeCRM como ventas.

¿Qué pedidos se sincronizan?

Completado En proceso En espera y cualquier estado personalizado

No se sincronizan:

Pendiente de pago Fallido Cancelado Papelera Borrador

¿Qué datos incluye un pedido?

Datos del pedido online

• Cliente: se busca o crea automáticamente por email, teléfono o ID de WooCommerce
• Productos: cada línea del pedido se vincula al producto correspondiente en BikeCRM
• IVA: se extrae de los datos fiscales del pedido
• Estado de WooCommerce: se conserva para referencia (ej: “completado”, “en proceso”)
• Método de pago: se registra el método utilizado en la tienda online
• Pago: si el pedido está pagado, se crea automáticamente el registro de pago

Stock y pedidos online

Nota

Cuando llega un pedido de WooCommerce, el stock se reduce solo en BikeCRM. Esta reducción no se reenvía a WooCommerce (ya se descontó allí con la venta). Esto evita bucles infinitos de sincronización.

👥 Sincronización de clientes

Los clientes se importan de WooCommerce a BikeCRM. La vinculación se realiza por orden de prioridad:

1. Por ID de WooCommerce — si el cliente ya fue importado anteriormente
2. Por email — si coincide con un cliente existente
3. Por teléfono — si coincide con un cliente existente
4. Crear nuevo — si no se encuentra coincidencia

Los datos importados incluyen nombre, email, teléfono y dirección de facturación.

Consejo

Si un cliente compra online y luego visita la tienda física, BikeCRM lo reconoce automáticamente y unifica su historial de compras.

🧾 Facturación automática

BikeCRM puede generar facturas automáticamente para cada pedido de WooCommerce.

Configuración

Opción	Descripción
Facturas gestionadas por BikeCRM	Activa la generación automática de facturas para pedidos online
Envío automático por email	Envía la factura al cliente por email automáticamente

Cuando ambas opciones están activas, el flujo es completamente automático:

1. El cliente compra en WooCommerce
2. BikeCRM recibe el pedido
3. Se genera la factura
4. Se envía por email al cliente

💰 Gestión de precios e IVA

Precios con o sin IVA

WooCommerce puede mostrar precios con IVA incluido o sin él. BikeCRM internamente trabaja con precios sin IVA y necesita saber cómo están configurados tus precios:

Precios con IVA

Si tu WooCommerce muestra precios con IVA incluido (lo más habitual en tiendas B2C en España):

• Activa la opción Los precios incluyen IVA
• BikeCRM restará el IVA para calcular el precio base
• Al enviar precios a WooCommerce, se añadirá el IVA

Precios sin IVA

Si tu WooCommerce muestra precios sin IVA (habitual en tiendas B2B):

• Deja la opción desactivada (por defecto)
• Los precios se sincronizan directamente sin conversión

Configuración de tipos de IVA

Para pedidos importados, puedes mapear los tipos impositivos de WooCommerce a los de BikeCRM en la configuración avanzada (woocommerce_config):

{
  "tax_rates": {
    "1": 0.21,
    "2": 0.10,
    "3": 0.04
  },
  "default_vat": 0.21
}

Donde las claves ("1", "2", "3") son los IDs de los tipos impositivos en WooCommerce.

🔄 Sincronización en tiempo real vs masiva

Tiempo real (webhooks)

Sincronización automática

Los webhooks configurados en WooCommerce envían notificaciones a BikeCRM cada vez que:

• Un producto se actualiza o elimina
• Se crea o modifica un pedido

Esta sincronización es instantánea y no requiere intervención manual.

Masiva (manual)

Sincronización bajo demanda

Desde el panel de administración de BikeCRM puedes lanzar sincronizaciones masivas:

• Sincronizar productos: importa todos los productos de WooCommerce
• Sincronizar clientes: importa todos los clientes
• Sincronizar pedidos: importa todos los pedidos

Útil para la configuración inicial o para resolver discrepancias.

❓ Solución de problemas

Los productos no se sincronizan

1. Verifica que los webhooks estén activos

   En WooCommerce, ve a Ajustes > Avanzado > Webhooks. Comprueba que los webhooks están en estado Activo (no desactivado ni pausado).

2. Comprueba las credenciales

   Asegúrate de que el usuario y la contraseña de aplicación son correctos y tienen permisos de lectura/escritura.

3. Revisa el estado del producto

   Solo se sincronizan productos con estado Publicado en WooCommerce. Los borradores y productos privados no se importan.

4. Solicita una sincronización masiva

   Si los webhooks han fallado, contacta con soporte para lanzar una sincronización masiva que reimporte todos los productos.

Webhooks desactivados automáticamente

WooCommerce desactiva automáticamente un webhook tras 5 fallos consecutivos de entrega, sin mostrar ninguna notificación. Si notas que los productos han dejado de sincronizarse, verifica el estado de los webhooks en WooCommerce.

Un producto aparece en WooCommerce pero no en BikeCRM

• El producto puede estar en estado borrador o privado en WooCommerce
• Si es un producto variable con muchas variaciones, lanza una sincronización masiva

El stock no coincide

• Verifica en la pestaña Movimientos de stock del producto qué cambios se han registrado
• Comprueba que la venta online se registró correctamente como pedido en BikeCRM
• Si hay discrepancia, puedes realizar un ajuste manual de stock (quedará registrado en los movimientos)

Un producto eliminado en WooCommerce sigue apareciendo

• Si tienes configurado el webhook de producto eliminado, BikeCRM lo marca automáticamente como eliminado
• Si no tienes este webhook, el producto se marcará como eliminado la próxima vez que BikeCRM intente sincronizarlo

🔗 Páginas relacionadas

• Movimientos de stock — trazabilidad de cambios de inventario
• Ventas y TPV — gestión de pedidos y ventas
• Sistema de facturación — generación de facturas
• Pedidos a proveedores — compras y recepción de mercancía