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 por línea
• Envíos y cargos extra incluidos
• Las devoluciones generan abonos automáticos
• Facturación automática opcional

⚙️ Configuración inicial

Antes de empezar

La integración funciona con cualquier WooCommerce moderno, pero conviene comprobar:

• WordPress 5.6 o superior — las Application Passwords vienen integradas desde esa versión.
• HTTPS recomendado en tu tienda — las credenciales y los webhooks viajan por la red, mejor cifrados.
• Tu tienda debe ser accesible desde internet — instalaciones en localhost, IPs privadas o entornos de staging cerrados no funcionan; BikeCRM tiene que poder llamar a tu-tienda/wp-json/wc/v3/....
• El usuario de WordPress que generará la application password necesita rol Shop Manager o Administrador. Roles inferiores (Cliente, Suscriptor) reciben 401 Unauthorized al llamar al API de WooCommerce.
• Plugins de seguridad agresivos (Wordfence en modo estricto, iThemes Security, etc.) pueden bloquear el header Authorization o las llamadas REST. Si has configurado todo y aún recibes errores 401 / 403, prueba a desactivarlos temporalmente para confirmar que es eso.

Tiempo estimado: 10–15 minutos para una tienda pequeña; algo más si tu catálogo tiene cientos de productos (la sincronización inicial es sólo más larga, no más complicada).

1. Activación de la integración (equipo comercial)

   WooCommerce es una funcionalidad PLUS y la activa el equipo comercial de BikeCRM al contratar el plan (o como excepción manual). Si tu negocio aún no la tiene activa, contacta con soporte. El resto de la configuración la haces tú desde la app.

2. Abre la página de configuración

   En el menú lateral, dentro de la sección Tienda, encontrarás la entrada WooCommerce. Si tu negocio no tiene aún WooCommerce activado, verás una insignia PLUS y un mensaje explicando cómo activarlo.

3. URL y credenciales de la tienda

   Rellena los campos del formulario:

   • URL de la tienda — la URL completa de tu WooCommerce (por ejemplo, https://mitienda.com/).
   • Usuario WordPress — tu nombre de usuario de WordPress.
   • Application password — sigue las instrucciones de generación más abajo; no es tu contraseña de WordPress.
   • Webhook secret — puedes dejarlo vacío: si no pones nada, BikeCRM genera uno y se lo pone él mismo a los webhooks de tu tienda. Solo necesitas escribir aquí un valor si prefieres elegirlo tú (junto al campo tienes un botón ✨ que genera uno fuerte en tu navegador). El valor solo viaja a BikeCRM cuando pulses Guardar.

   Más abajo en la misma página encontrarás las opciones de IVA y facturación (paso 5) y un editor JSON para configuración avanzada. Rellena primero los campos de conexión y pulsa Guardar. Puedes acceder directamente a la página en https://bikecrm.app/integrations/woocommerce.

   Cómo generar la application password en WordPress

   1. En tu panel de WordPress, ve a Usuarios > Tu perfil.
   2. Baja hasta el final de la página — la sección Contraseñas de aplicación está casi al pie.
   3. Escribe BikeCRM en el campo Nombre de la nueva contraseña de aplicación y pulsa Añadir nueva contraseña de aplicación.
   4. WordPress muestra la contraseña generada una sola vez en un cuadro destacado. Cópiala antes de salir de la página — si te equivocas, tendrás que generar otra.
   5. Pega la contraseña en el campo Application password de BikeCRM. Los espacios que aparecen entre los grupos de letras son sólo formato visual: cópiala tal cual aparece, BikeCRM y WordPress los ignoran.

   ¿Cuál es el slug de mi negocio?

   Tu slug es el identificador corto que BikeCRM asigna a tu tienda. Aparece en la URL cuando estás dentro de la app, por ejemplo app.bikecrm.com/mibici/dashboard → tu slug es mibici. No necesitas escribirlo a mano en ningún sitio: BikeCRM compone las URLs de webhook con tu slug y las configura en tu tienda por ti.

   Prueba la conexión antes de seguir

   Una vez guardadas las credenciales, junto al campo Application password verás un botón con un icono 🛜 — pulsa “Probar conexión”. Además de comprobar las credenciales, es el momento en que BikeCRM configura los webhooks de tu tienda (paso 4). Te dirá:

   • ✅ Conectado + nombre y versión de tu WooCommerce → todo bien, sigue adelante.
   • ❌ Usuario o application password incorrectos → revisa el paso anterior; lo más probable es que hayas pegado la contraseña con un carácter de más, o estés usando tu contraseña de WordPress en lugar de la application password.
   • ❌ No se pudo contactar con la tienda → la URL es incorrecta, o tu tienda no es accesible desde internet (revisa los Prerequisitos al inicio de esta página).
   • ❌ La URL responde pero no parece tener WooCommerce instalado → estás apuntando a una WordPress sin WooCommerce, o el API REST está desactivado.

   Si todo va bien, los webhooks del siguiente paso entregarán cuando se disparen.

4. Los webhooks se configuran solos

   Los webhooks son los avisos que WooCommerce envía a BikeCRM cuando algo cambia en la tienda (una venta, un cambio de precio). Ya no tienes que crearlos a mano: cuando pulsas Probar conexión y el test sale verde, BikeCRM crea en tu tienda los cuatro que necesita — Producto actualizado, Producto eliminado, Pedido creado y Pedido actualizado — activos, con la URL correcta y firmados con un secreto que genera él mismo.

   Debajo del resultado del test verás el resumen: Avisos en tiempo real configurados (n/n). El total depende de lo que tengas activado en Qué se sincroniza: con todo activado son 4/4, y si por ejemplo desactivas los pedidos, el total baja porque BikeCRM ya no pide a la tienda los avisos de pedidos. Lo importante es que los dos números coincidan.

   ¿Ya los tenías creados a mano?

   No se duplican. BikeCRM reconoce los webhooks que ya apuntan a tu negocio aunque los crearas con una dirección ligeramente distinta (api.bikecrm.app en vez de connect.bikecrm.app, con o sin barra final), y en vez de crear otro reaprovecha el que ya existe: lo deja apuntando a la dirección correcta, lo reactiva si WooCommerce lo había desactivado y le pone el secreto que corresponde. Los webhooks de otras integraciones no se tocan nunca.

   Por qué esto importa

   WooCommerce desactiva un webhook automáticamente tras 5 entregas fallidas seguidas, y no vuelve a activarlo nunca. Era la causa más habitual de “la sincronización dejó de funcionar y nadie se enteró”. Ahora BikeCRM lo revisa cada día y lo reactiva solo.

   Si quieres verlos, están en tu panel de WooCommerce, en Ajustes > Avanzado > Webhooks. Cada uno tiene su propio Log de entrega, útil si algo falla: ahí ves el código que devolvió BikeCRM (401 = el secreto no coincide, 404 = la URL no corresponde a tu negocio, 5xx = BikeCRM está caído).

5. Configura IVA y facturación

   En la misma página, activa según corresponda:

   • Los precios en WooCommerce incluyen IVA — habitual en tiendas B2C en España.
   • Generar facturas desde BikeCRM para los pedidos online — si quieres que cada pedido WooCommerce genere automáticamente una factura formal en BikeCRM (con su numeración, VeriFactu, etc).
   • Enviar facturas por email automáticamente al cliente — si además quieres que la factura llegue al comprador automáticamente.

6. Sincronización inicial

   Al final de la página tienes tres botones: Sincronizar productos, Sincronizar clientes, Sincronizar pedidos. Lánzalos una vez para hacer la importación inicial. A partir de ahí los webhooks mantendrán todo al día.

   Lánzalos en este orden (los pedidos referencian productos y clientes; importarlos primero crea registros con datos provisionales que después tienen que reconciliarse):

   1. Sincronizar productos — segundos para tiendas pequeñas, minutos para catálogos grandes con muchas variaciones. El botón se queda desactivado mientras se procesa; cuando vuelve a estar activo, ha terminado.
   2. Sincronizar clientes — suele ser rápido salvo que tengas miles de clientes registrados.
   3. Sincronizar pedidos — importa los pedidos históricos no cancelados/borrador. Si ves errores, revisa el apartado de solución de problemas más abajo, no es necesario contactar con soporte.

Precaución

La 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.

✅ Verifica que la sincronización funciona

Antes de dar la integración por terminada, haz estas comprobaciones — son lo que cazaría el 90 % de los problemas de configuración:

1. Conteo de productos coincide

   Después de la sincronización inicial, abre la lista de productos en BikeCRM y compara el conteo con el de WooCommerce. Si tu tienda tiene productos variables, recuerda que cada variación cuenta como un producto en BikeCRM (una camiseta con 4 tallas → 4 productos), así que el número en BikeCRM puede ser mayor.

2. El precio cambia en tiempo real

   En WooCommerce, cambia el precio de un producto cualquiera y guárdalo. En menos de 30 segundos debería actualizarse en BikeCRM. Si no se actualiza, vuelve a pulsar Probar conexión (reconfigura los webhooks) y revisa el log de entrega del webhook Producto actualizado en WooCommerce.

3. Crea un pedido de prueba en WooCommerce

   En tu tienda online (o desde el panel de WooCommerce > Pedidos > Añadir nuevo), crea un pedido con un producto barato. Márcalo como pagado. En menos de 30 segundos:

   • El pedido aparece en BikeCRM con el icono WOO en la lista de pedidos.
   • El cliente queda asociado correctamente (búscalo en clientes por su email).
   • El total del pedido coincide exactamente con el de WooCommerce (incluyendo envío y cargos extra).
   • El stock del producto bajó en ambos lados una sola vez (no doble descuento).

4. Si activaste facturación gestionada por BikeCRM

   El pedido pagado debería tener una factura asociada con la siguiente numeración de tu serie principal. Si tienes VeriFactu activado, comprueba que la factura está sellada y que aparece una nota interna en el pedido de WooCommerce avisando del sellado.

5. Devolución parcial (opcional pero recomendado)

   Desde el pedido en WooCommerce, emite una devolución parcial de una línea. En BikeCRM aparecerá un nuevo pedido de tipo abono (qty negativa), un pago negativo y, si había factura, una factura rectificativa serie 10. Si esto funciona, la integración está completamente operativa.

Si algo no cuadra

Pulsa de nuevo Probar conexión en la página de configuración. Si el test sale verde pero la sincronización no llega, mira el resumen de Avisos en tiempo real bajo el resultado del test y el log de entrega del webhook en WooCommerce. Si el test falla, son las credenciales o la URL.

🎛️ Qué se sincroniza y en qué dirección

En la página de configuración, la sección Qué se sincroniza decide qué comparten BikeCRM y tu tienda. Por defecto todo está activado en ambos sentidos, que es lo que quiere la mayoría de tiendas.

Ajuste	Opciones	Para qué sirve
Catálogo de productos	En ambos sentidos · Solo WooCommerce → BikeCRM · Solo BikeCRM → WooCommerce · No sincronizar	Nombre, precio, descripción e imágenes
Mantener el stock al día en WooCommerce	Sí / No	Las unidades disponibles
Importar los pedidos de WooCommerce	Sí / No	Las ventas de la tienda online
Importar los clientes de WooCommerce	Sí / No	La importación masiva de clientes

Algunas combinaciones útiles:

• La tienda manda en las fichas, BikeCRM en el stock. Pon el catálogo en Solo WooCommerce → BikeCRM y deja activado Mantener el stock al día. Tu equipo de tienda online sigue escribiendo los textos y eligiendo las fotos, y BikeCRM nunca se los toca; pero las unidades que vendes en el mostrador, las que gastas en reparaciones y las que recibes de proveedor siguen bajando y subiendo en la web.
• BikeCRM manda en todo. Déjalo En ambos sentidos: es lo normal si das de alta los productos en BikeCRM.
• Solo quiero que entren los pedidos. Pon el catálogo en No sincronizar y desactiva el stock. Las ventas de la web seguirán entrando en BikeCRM para facturarlas.

Precaución

Los pedidos y los clientes van en un solo sentido, de WooCommerce a BikeCRM. BikeCRM no crea pedidos ni clientes en tu tienda online.

Desactivar Importar los pedidos no borra los que ya entraron: deja de importar los nuevos. Y aunque desactives Importar los clientes, cada pedido que entre seguirá teniendo su cliente — si no, la venta se quedaría sin a quién facturar.

Cuidado al desactivar el stock

Mientras esté activado, BikeCRM es la fuente de la verdad para el stock: si alguien cambia las unidades a mano en la tienda online, el siguiente envío de BikeCRM las sobrescribe. Desactívalo solo si el stock de la web lo gestiona otro sistema — si no, acabarás vendiendo online unidades que ya no tienes.

No desactives los pedidos si dejas el stock activado

BikeCRM se entera de las ventas de tu tienda online a través de los pedidos: al importar cada pedido descuenta esas unidades de su propio stock. Si desactivas Importar los pedidos pero dejas activado Mantener el stock al día, las ventas de la web dejan de descontarse en BikeCRM — y como BikeCRM manda en el stock, el siguiente envío sobrescribirá el stock de la tienda con cifras que no descuentan esas ventas: la web volverá a mostrar unidades que ya se han vendido. Si no quieres importar los pedidos, desactiva también el stock. La página de configuración te avisa si eliges esta combinación.

📦 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, SKU, descripción, imagen — y el stock solo en la primera importación (ver “El stock: quién manda” más abajo)

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: publicado o en borrador, controlado desde el selector WooCommerce de la ficha del producto

En la ficha de cada producto encontrarás el selector WooCommerce con tres opciones:

• A la venta en la tienda online — el producto está publicado y a la venta en tu WooCommerce
• En la tienda online como borrador (no a la venta) — el producto existe en la tienda pero como borrador: los clientes no lo ven, pero el stock y el precio se siguen sincronizando. Ideal para dejar de vender online sin dejar de venderlo en la tienda física. Si más adelante lo vuelves a poner a la venta, se reutiliza el mismo producto de WooCommerce (sin duplicados)
• No sincronizado con la tienda online — el producto no existe en WooCommerce ni se sincroniza

Consejo

Las modificaciones normales (precio, stock, nombre) nunca cambian el estado de publicación en tu tienda: solo cambia cuando tú cambias el selector. Así, si publicas o despublicas un producto directamente en WooCommerce, BikeCRM no te lo va a “deshacer”.

Nota

Al descatalogar un producto en BikeCRM (individualmente o en bloque), también se pone automáticamente como borrador en la tienda online: un producto descatalogado no debe seguir comprándose en la web.

En la lista de productos (Tienda → Productos) tienes además un filtro WooCommerce para ver solo los productos a la venta online, los que están en borrador o los no sincronizados.

El stock: quién manda

BikeCRM es el dueño del stock. El stock físico de tu tienda/taller es la fuente de verdad, y el flujo es siempre en una dirección:

• BikeCRM → WooCommerce: cada venta en el TPV, compra a proveedor o ajuste de inventario actualiza el stock en tu tienda online automáticamente
• Las ventas online descuentan stock en BikeCRM a través del pedido (el pedido de WooCommerce se importa como venta y descuenta el stock, que a su vez se reenvía a la tienda)
• La primera vez que un producto se importa desde WooCommerce, BikeCRM adopta el stock que tenga la tienda (todavía no hay verdad local)

Lo que no ocurre (a propósito):

• Los avisos de producto de WooCommerce nunca sobrescriben el stock de un producto ya sincronizado. Antes, un aviso “atrasado” (generado antes de una venta en el TPV) podía devolver al stock una unidad ya vendida — el stock “subía solo” 1 unidad
• Editar el stock a mano en el administrador de WooCommerce no se importa a BikeCRM (y quedará sobrescrito por el siguiente cambio de stock en BikeCRM). Haz los ajustes de stock siempre desde BikeCRM: quedan registrados en los movimientos de stock y se reflejan en la tienda

Consejo

Si el stock de la tienda online no coincide con el de BikeCRM, cualquier cambio de stock en BikeCRM (una venta, un ajuste) lo vuelve a alinear — siempre con el valor de BikeCRM.

Si vendes en dos tiendas online

Si tienes WooCommerce y Shopify conectados a la vez, una venta en una de las tiendas descuenta el stock en BikeCRM y lo envía a la otra, para que no vendas dos veces la misma unidad. BikeCRM nunca devuelve el stock a la tienda donde se hizo la venta (esa ya lo ha descontado por su cuenta).

🛒 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. Prioridad: ID de WooCommerce → email → teléfono. Si se encuentra por email o teléfono, BikeCRM guarda el ID de WooCommerce en tu ficha de cliente para que futuros pedidos se vinculen al instante.
• Productos: cada línea del pedido se vincula al producto correspondiente en BikeCRM.
• Envío: el coste de envío entra como una línea adicional etiquetada Envío (<nombre del método>) — por ejemplo, Envío (Flat Rate) — con su IVA correspondiente, de forma que el total de BikeCRM cuadra exactamente con el de WooCommerce.
• Cargos extra: cualquier fee definido en WooCommerce (servicio, recargo de pago, etc.) entra también como línea adicional con su nombre original.
• IVA por línea: se extrae el tipo de IVA real de cada línea desde los datos fiscales del pedido (no se asume el IVA por defecto del negocio).
• Recargo de equivalencia: si el cliente está marcado como sujeto a RE, se aplica automáticamente el recargo correcto (5,2 % / 1,4 % / 0,5 %) a cada línea.
• Estado de WooCommerce: se conserva tal cual (ej: completed, processing, o estados personalizados como fedex-delivered).
• 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 con la fecha original.

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.

Devoluciones (refunds)

Cuando se emite una devolución en WooCommerce, BikeCRM la importa automáticamente:

• Se crea un pago negativo sobre el pedido original con el importe devuelto, de forma que el estado de pago refleja lo que ya se ha reembolsado.
• El stock se restaura en BikeCRM (no se reenvía a WooCommerce, ya que WC gestiona su propio stock).
• Si el pedido tenía factura, BikeCRM emite también la correspondiente factura rectificativa (abono). Ver Facturas rectificativas para el detalle del flujo y la numeración.
• Se admiten devoluciones parciales y múltiples sobre un mismo pedido; cada una guarda el ID de la devolución de WooCommerce como clave de idempotencia para que los reenvíos del webhook no dupliquen.

Modificaciones del pedido tras la primera sincronización

Si modificas un pedido en WooCommerce después de que se haya sincronizado:

• Cambio de estado (ej: processing → completed): se actualiza el campo de estado en BikeCRM, sin más cambios.
• Edición de líneas en un pedido sin facturar: BikeCRM rehace las líneas en su sitio, manteniendo el mismo identificador de pedido.
• Edición de líneas en un pedido ya facturado: BikeCRM emite automáticamente una factura rectificativa y crea un pedido nuevo con el contenido actualizado y su propia factura (ver Facturas rectificativas para el detalle). El pedido original queda marcado con el estado interno superseded-by-<id> apuntando al nuevo, para trazabilidad.

Nota

Si tienes VeriFactu activado, en cuanto la primera factura del pedido queda sellada, BikeCRM deja automáticamente una nota interna en el pedido de WooCommerce avisando de que las ediciones posteriores generarán abonos en lugar de modificar la factura. Ver VeriFactu y sellado.

👥 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 de pedidos WooCommerce

Esta sección describe el comportamiento específico de la facturación en pedidos que llegan desde WooCommerce. Para las reglas generales (modos de generación, numeración de series, VeriFactu, inmutabilidad, envío por email, etc.), consulta la página completa de Sistema de facturación.

¿Quién emite la factura: BikeCRM o WooCommerce?

Una sola de las dos partes debería emitir la factura de cada pedido online. Elige el modo que encaje con tu negocio:

BikeCRM emite la factura (recomendado)

Activa la opción Generar facturas desde BikeCRM para los pedidos online en la página de configuración de WooCommerce. A partir de ese momento:

• Cada pedido pagado en WooCommerce genera una factura formal en BikeCRM, con la misma numeración que el resto de tus facturas (ver numeración).
• Si tienes VeriFactu activado, la factura se firma y se incluye en la cadena de hashes, igual que una factura de TPV o de hoja de servicio.
• La factura aparece junto al resto en Facturas y se puede imprimir, descargar o reenviar desde allí.
• Para evitar conflictos, desactiva cualquier plugin de WooCommerce que también emita facturas: BikeCRM te avisa automáticamente si detecta uno instalado (ver Evitar doble facturación).

Un plugin de WooCommerce emite la factura

Deja la opción Generar facturas desde BikeCRM para los pedidos online desactivada. BikeCRM importa el pedido pero no genera ninguna factura para él:

• El pedido aparece en Tickets de compra con su método de pago y estado de pago, pero sin número de factura.
• La facturación legal recae en tu plugin de WooCommerce.
• Tus facturas de tienda física (TPV, hojas de servicio) siguen funcionando con normalidad en BikeCRM — no se ven afectadas.

Este modo tiene sentido si llevas años con un flujo de facturación en WooCommerce y no quieres migrar, o si usas un plugin con integraciones específicas que BikeCRM aún no cubre.

Cuándo se emite la factura

Cuando BikeCRM gestiona la facturación, la factura se genera automáticamente al cumplirse estas tres condiciones:

1. El pedido llega desde WooCommerce (vía webhook o sincronización masiva).
2. El pedido está pagado (WooCommerce ha marcado date_paid). BikeCRM crea el registro de pago a la vez.
3. El modo de facturación de tu negocio está en automático o semiautomático (ver Modos de generación).

Si el pedido llega sin pagar (pending, on-hold), BikeCRM lo importa como ticket de compra pero no emite factura todavía. En cuanto WooCommerce marque el pedido como pagado y envíe el siguiente webhook, BikeCRM emitirá la factura.

Qué contiene la factura de un pedido WooCommerce

La factura se construye a partir de los datos del pedido sincronizado, sin que tengas que rellenar nada a mano:

Contenido de la factura

• Comprador: nombre, NIF, dirección, ciudad, código postal y país tomados de los datos de facturación de WooCommerce (billing del pedido).
• Vendedor: los datos legales de tu negocio configurados en BikeCRM.
• Líneas: una por producto, más líneas separadas para envíos y cargos extra (ver Datos del pedido).
• IVA: tipo real por línea, extraído de los datos fiscales del pedido.
• Recargo de equivalencia: aplicado automáticamente si el cliente está marcado como sujeto a RE (5,2 % / 1,4 % / 0,5 % según tipo de IVA).
• Fecha: la del pedido en WooCommerce (date_created_gmt).
• Número: siguiendo la numeración normal de tu negocio.

VeriFactu y sellado de la factura

Si tu negocio tiene VeriFactu activado, la factura de un pedido WooCommerce se sella igual que cualquier otra factura:

• Se extiende la cadena de hashes y se genera el QR correspondiente.
• La factura pasa a ser legalmente inmodificable (ver Inmutabilidad).
• BikeCRM deja una nota interna automática en el pedido de WooCommerce avisando de ese sellado:

Aviso automático en WooCommerce

La factura de BikeCRM <número> se ha sellado con VeriFactu y ya no se puede modificar. Cualquier edición de este pedido de WooCommerce generará una factura rectificativa en BikeCRM en la próxima sincronización, no una modificación de la factura original.

La nota se publica en el idioma configurado de tu negocio (ES / CA / FR / EN). Solo la ves tú como administrador de WooCommerce (no se envía al cliente) y sirve como recordatorio de que, a partir de ese momento, cualquier edición del pedido en WooCommerce disparará el flujo automático de abono + nuevo pedido descrito en Facturas rectificativas.

Facturas rectificativas (abonos)

Cuando haga falta rectificar una factura emitida para un pedido WooCommerce, BikeCRM lo hace automáticamente — el hecho que la dispare en WooCommerce genera la rectificativa correspondiente.

Hecho en WooCommerce	Reacción en BikeCRM
Devolución parcial de un pedido (refund)	Crea un abono con las líneas devueltas (qty negativa) vinculado a la factura original, serie 10, datos legales copiados. También registra el pago negativo y restaura el stock.
Devolución total	Mismo flujo pero cubriendo todas las líneas del pedido.
Varias devoluciones sobre el mismo pedido	Cada una genera su propio abono (se admiten múltiples rectificativas sobre una misma factura cuando el origen es WooCommerce). El ID de la devolución se guarda en el abono como clave de idempotencia — los reenvíos del webhook no la duplican.
Edición de líneas o totales del pedido ya facturado	Abono completo del pedido original + creación de un pedido nuevo con el contenido actualizado y su propia factura. El pedido antiguo queda marcado con estado interno indicando sustitución.
Cambio de estado a cancelled / refunded / failed	Si hay un refund en el webhook, se procesa como devolución (filas arriba). Si no, BikeCRM conserva el estado de WC en el pedido pero no emite abono automático — tendrás que emitirlo a mano desde la factura si procede.

Para el formato y numeración de las rectificativas (serie 10, prefijo CN), ver Facturas rectificativas en la página de facturación.

Envío automático por email al cliente

Si además activas Enviar facturas por email automáticamente al cliente, la factura recién emitida se envía al email del comprador tal como aparece en los datos de facturación de WooCommerce. Ver Envío automático para los detalles.

Evitar la doble facturación

Precaución

Cuando activas Generar facturas desde BikeCRM para los pedidos online, BikeCRM revisa los plugins activos de tu WooCommerce y te avisa si detecta alguno que también suele emitir facturas (WooCommerce PDF Invoices, Factura Electrónica, puentes VeriFactu, etc.). Si ves este aviso, desactiva esos plugins en WooCommerce o desmarca la opción en BikeCRM — de lo contrario cada pedido generará dos facturas con numeración diferente.

La comprobación se hace al abrir la página de configuración de WooCommerce y se cachea 5 minutos.

Qué NO pasa automáticamente

Hay escenarios conocidos que siguen requiriendo intervención manual. Conviene tenerlos presentes:

• Pedidos pendientes o fallidos: no generan factura ni movimiento (por diseño — no son ventas aún).
• Modificación del importe o cliente de una factura emitida: no es posible. Si necesitas corregirla, emite una rectificativa desde BikeCRM (o edita el pedido en WooCommerce y deja que el flujo automático la cree por ti).
• Migración de facturas históricas desde un plugin de WooCommerce a BikeCRM: la importación recrea los pedidos pero no rescata las facturas antiguas que emitió el plugin. Esas quedan fuera de la numeración de BikeCRM y fuera de la cadena de VeriFactu.

💰 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 (avanzado)

En la mayoría de los casos no hace falta configurar nada aquí. BikeCRM lee el tipo de IVA real de cada línea directamente desde los datos fiscales (tax_lines.rate_percent) que envía WooCommerce, así que un pedido con líneas al 21 %, 10 % y 4 % se importa correctamente sin configuración adicional.

El JSON woocommerce_config solo se usa como fallback cuando WooCommerce no incluye el porcentaje de IVA en los datos del pedido (configuraciones inusuales). Puedes editarlo en el campo del mismo nombre dentro de la página de configuración de WooCommerce:

{
  "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 y default_vat es el tipo a aplicar cuando ninguno de los otros mecanismos resuelva.

🔄 Sincronización en tiempo real vs masiva

Tiempo real (webhooks)

Sincronización automática

Una vez configurados los webhooks, WooCommerce notifica a BikeCRM en cuanto algo cambia. Lo que ocurre en cada notificación depende del tipo:

• Producto actualizado / eliminado — el producto se sincroniza inmediatamente en BikeCRM (precios, stock, nombre, estado de publicación).
• Pedido creado — primera sincronización: crea el pedido completo en BikeCRM con todas sus líneas, envío, cargos, IVA por línea, pago y (opcional) factura.
• Pedido actualizado — actualiza el estado del pedido, importa cualquier devolución nueva (ver sección de devoluciones más arriba) y, si las líneas o el total han cambiado en WooCommerce, rehace o sustituye el pedido en BikeCRM según corresponda.

Masiva (manual)

Sincronización bajo demanda

Desde la página WooCommerce del menú lateral, dispones de tres botones:

• Sincronizar productos: importa todos los productos de WooCommerce.
• Sincronizar clientes: importa todos los clientes.
• Sincronizar pedidos: importa todos los pedidos (excepto los pendientes / fallidos / cancelados / borradores).

Útil para la configuración inicial o para resolver discrepancias después de un fallo de webhooks.

❓ Solución de problemas

Nota

Al usar Probar conexión con una URL distinta a la guardada, introduce también el usuario y la contraseña de aplicación de esa tienda: por seguridad, BikeCRM nunca envía las credenciales guardadas a una dirección diferente.

Errores que devuelve “Probar conexión”

Cuando pulsas el botón 🛜 Probar conexión en la página de configuración de WooCommerce, BikeCRM hace una llamada de prueba al API de tu tienda. Estos son los mensajes que pueden aparecer:

Mensaje	Qué significa	Cómo solucionarlo
✅ Conectado a …	Todo bien, sigue con la configuración	—
❌ Faltan datos	No has rellenado URL, usuario o application password	Vuelve al paso 3 y completa los tres campos
❌ La URL debe empezar por http:// o https://	El campo URL no tiene un esquema válido	Usa la URL completa de tu tienda, por ejemplo https://mitienda.com/
❌ No se pudo contactar con la tienda	DNS / red / certificado SSL inválido / tienda en localhost o tras un firewall	Comprueba que la URL es correcta y que la tienda es accesible desde internet (revisa los Prerequisitos al inicio)
❌ La tienda tardó demasiado en responder	Tu WordPress respondió pero tardó más de 15 segundos	Tu hosting puede estar saturado o un plugin pesado bloquea las peticiones REST
❌ Usuario o application password incorrectos	WordPress devolvió 401 Unauthorized	Genera una nueva application password (paso 3); recuerda que no es tu contraseña de WordPress y que el usuario debe tener rol Shop Manager o superior
❌ La URL responde pero no parece tener WooCommerce instalado	La tienda existe pero no tiene WooCommerce activo o el API REST está deshabilitado	Comprueba que WooCommerce está instalado y activo, y que el API REST no está bloqueado por un plugin de seguridad
❌ Error inesperado al contactar con la tienda	Cualquier otra respuesta no-200	Revisa el detalle del error en el mensaje; suele ser un plugin de seguridad bloqueando

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. Lanza una sincronización masiva

   Si los webhooks han fallado, abre la página WooCommerce del menú lateral y pulsa Sincronizar productos para reimportar todo. No necesitas contactar con soporte.

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.

BikeCRM te avisa: en la página WooCommerce del menú lateral, en el apartado Estado de la integración (visible cuando la configuración está completa), tienes una tabla con la última vez que llegó cada tipo de webhook y la última sincronización masiva de cada categoría. Si lleva días sin actualizar el webhook de productos o pedidos, es la primera señal de que algo se desactivó.

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

• Recuerda que BikeCRM manda sobre el stock (ver “El stock: quién manda”): los cambios hechos a mano en el administrador de WooCommerce no se importan
• 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, realiza un ajuste manual de stock en BikeCRM (quedará registrado en los movimientos y se reenviará a la tienda)

He movido un producto a la papelera en WooCommerce

Al mover un producto a la papelera de WooCommerce, BikeCRM desactiva su sincronización automáticamente (mediante el webhook de producto eliminado): el producto pasa a “No sincronizado”, deja de enviarse stock y precio a la tienda, y en la lista de productos aparece con la marca de eliminado en WooCommerce. En BikeCRM lo puedes seguir vendiendo con normalidad.

• Si restauras el producto desde la papelera de WooCommerce, BikeCRM lo vuelve a vincular automáticamente (por SKU) y la sincronización se reanuda
• Si vacías la papelera (borrado definitivo), el producto queda desvinculado; para volver a venderlo online, cámbialo a “A la venta en la tienda online” y se creará de nuevo en la tienda

Precaución

Si intentas publicar un producto nuevo cuyo SKU coincide con uno que está en la papelera de WooCommerce, la tienda rechazará la creación. Vacía la papelera (o restaura ese producto) y vuelve a intentarlo.

Un producto eliminado en WooCommerce sigue apareciendo

• Si tienes configurado el webhook de producto eliminado, BikeCRM desactiva su sincronización automáticamente (ver el apartado anterior)
• 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