Integración de WooCommerce con Quaderno y VeriFactu
Antes de conectar
La instalación es sencilla; la configuración fiscal no
El resultado depende de datos, checkout, impuestos, estados, reembolsos y conexiones externas. Una mala decisión puede crear facturas duplicadas o aplicar un criterio fiscal incorrecto.
- Qué ubicación determina el impuesto
- Qué códigos fiscales se asignan a cada producto
- Cuándo se genera la factura en Quaderno
- Cómo se identifican clientes B2B y ventas transfronterizas
- Qué integraciones deben desconectarse para evitar duplicados
- Qué limitaciones existen en checkout, almacenes y suscripciones
WooCommerce vende; Quaderno factura y remite
Arquitectura fragmentada
WooCommerce genera un PDF, Stripe o PayPal también envía la venta y Quaderno recibe el pedido por otra vía. El resultado puede ser duplicidad, numeración paralela y abonos incoherentes.
Arquitectura controlada
WooCommerce es el canal de venta. La integración nativa envía los datos a Quaderno y Quaderno genera la factura o nota de crédito, calcula impuestos y gestiona VERI*FACTU.
Qué configura Webyseo y qué depende de Quaderno
Responsabilidad de Webyseo
Auditoría de WooCommerce, plugin oficial, claves API, checkout, configuración fiscal, pruebas, reembolsos, prevención de duplicados, documentación y puesta en marcha.
Responsabilidad de Quaderno
Producto SIF, declaración responsable, cálculo tributario configurado, expedición de facturas y abonos, QR, registro y remisión a la AEAT en modalidad VERI*FACTU.
Responsabilidad del cliente
Jurisdicciones en las que está registrado, criterios fiscales, entidad legal, datos B2B, tratamiento de productos, operaciones especiales y validación con su asesor.
Qué puede sincronizar y automatizar Quaderno
Precios con o sin impuestos
Configuración coherente entre el catálogo, WooCommerce y Quaderno para evitar discrepancias en el checkout y la factura.
Ubicación fiscal
Definición de la base de cálculo: dirección de envío, dirección de pedido o ubicación principal del negocio.
Códigos de impuesto
Asignación de códigos específicos cuando se venden bienes físicos, productos digitales, cursos u otras categorías.
Clientes B2B
Captura de datos fiscales y validación del tratamiento de inversión del sujeto pasivo en ventas transfronterizas.
Facturas automáticas
Generación del documento cuando la venta queda pagada o el pedido alcanza el estado previsto.
Notas de crédito
Creación automática del abono cuando el reembolso se procesa correctamente desde WooCommerce.
Varias tiendas
Conexión de varias tiendas WooCommerce a una misma cuenta cuando pertenecen a la misma entidad legal.
Fiscalidad multicanal
Centralización de información procedente de distintos canales, alertas de obligaciones e informes fiscales.
Lo que debe comprobarse antes de presupuestar
Checkout Blocks
La documentación actual indica que el nuevo Checkout basado en bloques no es compatible; debe validarse el checkout clásico.
Varias ubicaciones de envío
La API de WooCommerce no informa del origen de la mercancía, por lo que el plugin no resuelve pedidos enviados desde múltiples almacenes.
Suscripciones variables
La integración soporta suscripciones simples, pero no funciona correctamente con suscripciones variables.
Procesadores duplicados
Conectar WooCommerce y, además, Stripe o PayPal directamente a Quaderno puede generar dos facturas para una misma venta.
Varias entidades legales
Varias tiendas pueden compartir una cuenta únicamente cuando están gestionadas por la misma entidad legal.
Datos incompletos
Quaderno solo puede utilizar los datos que recibe. Un checkout sin NIF, país, dirección o clasificación correcta no se corrige por arte de magia.
Ocho decisiones que definen el resultado fiscal
Decisiones de configuración
¿Qué vende la tienda?
Bienes físicos, servicios, descargas, cursos o una mezcla condicionan ubicación y código fiscal.
¿Precios con IVA incluido?
Hay que alinear catálogo, configuración de impuestos y redondeos con Quaderno.
¿Dónde nace la obligación fiscal?
Dirección de envío, pedido o establecimiento según el tipo de operación.
¿B2B nacional o internacional?
NIF, VIES, inversión del sujeto pasivo y dirección deben capturarse en el checkout.
¿Qué evento crea la factura?
Venta pagada, pedido completado u otro flujo deben contrastarse con las pasarelas reales.
¿Cómo se procesan devoluciones?
Cambiar el estado no basta: el reembolso debe ejecutarse para generar la nota de crédito.
¿Qué conexiones ya existen?
Stripe, PayPal, otros canales y plugins PDF pueden duplicar documentos.
¿Existen suscripciones o varios almacenes?
Son escenarios que pueden quedar fuera del alcance estándar del plugin.
Una implantación probada y documentada
Auditoría del flujo
Inventario de checkout, plugins, pasarelas, productos, jurisdicciones, B2B, suscripciones y otros canales conectados.
Configuración en staging
Plugin oficial, clave privada, URL API, impuestos, códigos de producto, checkout y datos fiscales.
Matriz de pruebas
Pedidos, pagos fallidos, B2B, impuestos, reembolsos, duplicados y casos especiales antes de producción.
Activación documentada
Paso controlado, evidencias, instrucciones operativas y definición del soporte posterior.
Matriz mínima de pruebas antes de producción
| Escenario | Qué debe validarse | Decisión |
|---|---|---|
| Pedido pagado | Factura única con datos e impuestos coincidentes | Apto |
| Pedido completado | No duplicar si la factura ya se generó al confirmar el pago | Revisar |
| Pago fallido o cancelado | No generar factura definitiva | Apto |
| Cliente B2B UE | NIF, VIES e inversión del sujeto pasivo según el criterio fiscal | Revisar |
| Productos con tipos distintos | Cada producto recibe el código fiscal correcto | Apto |
| Reembolso parcial | Nota de crédito por importe e impuestos exactos | Apto |
| Cambio de estado sin reembolso | No esperar una nota de crédito automática | Revisar |
| Stripe o PayPal conectado aparte | Eliminar la fuente duplicada de la misma venta | Bloquear |
| Checkout Blocks | No activar sin resolver la incompatibilidad documentada | Bloquear |
| Suscripción simple | Validar renovación, impuestos, factura y reembolso | Revisar |
| Suscripción variable | No asumir compatibilidad del plugin estándar | Bloquear |
| Varias tiendas | Misma entidad legal y configuración fiscal coherente | Revisar |
Qué significa que Quaderno sea VERI*FACTU
Quaderno identifica su sistema como exclusivamente VERI*FACTU
La declaración pública revisada identifica el producto Quaderno, código QD, versión 1.0, producido por Recrea Systems, SLU. Indica que el sistema solo funciona en modalidad VERI*FACTU.
- Quaderno es el productor del SIF.
- La declaración corresponde a una versión concreta.
- Quaderno gestiona la remisión de registros.
- No existe firma electrónica expresa de registros por funcionar exclusivamente como VERI*FACTU.
- Webyseo debe verificar que la versión utilizada dispone de declaración vigente.
Preparar el flujo antes de la fecha límite
Los plazos no justifican activar una integración sin pruebas. El objetivo es disponer de margen para corregir checkout, códigos fiscales, duplicados y reembolsos.
Cuándo elegir Quaderno y cuándo detenerse a revisar
Quaderno suele encajar bien cuando
- El negocio vende en varios países o canales.
- Necesita cálculo de impuestos por ubicación.
- Vende bienes físicos, digitales o servicios con códigos distintos.
- Tiene ventas B2B transfronterizas.
- Quiere centralizar facturas, abonos, informes y alertas fiscales.
- Las tiendas conectadas pertenecen a la misma entidad legal.
Hace falta revisar otra arquitectura cuando
- La tienda depende de Checkout Blocks.
- Los pedidos salen desde varios almacenes u orígenes.
- Existen suscripciones variables.
- Hay varias entidades legales compartiendo la misma cuenta.
- El marketplace o checkout tiene lógica fiscal propia.
- Ya existen varias herramientas generando facturas.
Qué recibe el cliente además de un plugin instalado
Informe de arquitectura
Mapa de fuentes de venta, factura, impuestos, pagos y riesgos de duplicidad.
Configuración documentada
Claves, impuestos, base de cálculo, códigos de producto y estados utilizados.
Checkout fiscal
Campos y reglas necesarios para B2B, país, dirección y productos.
Entorno de pruebas
Staging aislado para validar sin afectar pedidos reales.
Matriz de pruebas
Resultados de pedidos, impuestos, abonos, errores y compatibilidades.
Evidencias de validación
Capturas y registros suficientes para documentar el trabajo realizado.
Puesta en marcha
Secuencia de activación y comprobaciones iniciales en producción.
Manual de incidencias
Qué revisar ante una factura ausente, duplicada o fiscalmente incoherente.
Valoración técnica¿Quieres conectar tu WooCommerce con Quaderno sin duplicar facturas?
Cuéntame qué vendes, en qué países operas, qué checkout utilizas y qué integraciones ya están conectadas. Con esa información puedo determinar si la integración estándar encaja o necesita adaptación.
Preguntas antes de integrar Quaderno y WooCommerce
Siguiente paso
Cuéntame cómo vende y factura tu negocio
Para valorar Quaderno necesito entender la arquitectura actual. Cuanto más contexto aportes, más precisa será la respuesta.
- URL de WooCommerce y tipo de checkout
- Productos físicos, digitales, servicios o cursos
- Países y jurisdicciones fiscales
- Ventas B2B y validación de NIF/VIES
- Pasarelas conectadas también a Quaderno
- Suscripciones, almacenes y otras tiendas
- Volumen mensual y principal incidencia
