Esta guía te lleva desde cero hasta emitir tu primera factura real en VERI*FACTU. Lo ideal es que sigas los pasos en orden.
Instalación y puesta en marcha — Veri*Fac*WOO
Antes de empezar
Asegúrate de que tu tienda cumple los requisitos mínimos:
| Requisito | Versión mínima |
|---|---|
| WordPress | 6.5 o superior |
| WooCommerce | 8.0 o superior |
| PHP | 8.1 o superior |
| HTTPS | Activo en el servidor |
Extensiones PHP necesarias: openssl, mbstring, gd (o imagick).
Si no sabes si las tienes, el plugin incluye un diagnóstico automático en Herramientas → Estado que lo indica todo.
BLOQUE A — Sin licencia (modo Básico)
El modo Básico es completamente funcional sin contratar nada: genera facturas y rectificativas en PDF, con numeración controlada por series, sin conexión con la AEAT y sin límite de uso.
Paso 1 — Crear cuenta en el portal
Ve al portal (verifacwoo.com/portal/), crea tu cuenta y apúntate al newsletter.
Con esto desbloqueas la descarga gratuita del plugin.
Paso 2 — Descargar e instalar el plugin
- Accede al portal → Plugin (verifacwoo.com/portal/plugin/) y descarga el archivo
vfwoo.zip. - En WordPress: Plugins → Añadir nuevo → Subir plugin.
- Selecciona el ZIP y haz clic en Instalar ahora.
- Activa el plugin.
Una vez activado, verás Veri*Fac*WOO en el menú de WooCommerce. Al acceder por primera vez aparecerá una pantalla de bienvenida con un resumen del sistema que confirma si la instalación es apta para funcionar: versión de PHP, WordPress y WooCommerce, extensiones necesarias, directorios PDF y memoria disponible. Si todo aparece como correcto puedes continuar con la configuración.
Actualizaciones sin licencia: cuando haya una nueva versión, descarga el ZIP actualizado desde tu cuenta del portal e instálalo igual que en este paso. Las actualizaciones automáticas desde WordPress requieren licencia activa.
Paso 3 — Ajustes generales
Ve a WooCommerce → Veri*Fac*WOO → Ajustes.
Configura el comportamiento del plugin:
Facturación:
- Modo de expedición — cuándo se emite la factura automáticamente:
- Manual → solo cuando tú lo indiques desde el pedido
- Al completar el pago → en cuanto se procesa el pago
- Al cambiar a Completado → cuando el pedido pasa a estado “Completado”
- Factura simplificada — activa si quieres emitir F2 (sin NIF del cliente) para pedidos bajo 400 €
- Sector Autorizado — si tu actividad está en un sector con régimen especial
Checkout:
- Activa y configura el campo NIF/CIF en el formulario de compra
- Opciones de validación del NIF y de validación VIES para empresas intracomunitarias
- Mostrar u ocultar el campo de nombre de empresa
PDF:
- Activar o desactivar la generación de PDF
- Adjuntar PDF en el email de confirmación al cliente
- Guardar PDF automáticamente al emitir
Avanzado:
- Dirección de email para avisos internos del plugin
- Activar modo debug
- Borrar datos al desinstalar
Paso 4 — Diseño PDF
Ve a WooCommerce → Veri*Fac*WOO → Diseño PDF.
Introduce los datos de tu empresa que aparecerán en las facturas:
- Logo — selecciona una imagen de la biblioteca de medios de WordPress
- NIF/CIF de la empresa — identificador fiscal del emisor
- Nombre, dirección, datos adicionales (web, etc.), email, teléfono
- Pie de página — texto libre al final del PDF (aviso legal, condiciones, etc.)
También puedes personalizar los colores del PDF (color principal, secundario, texto, fondo de cabecera de tabla).
Paso 5 — Numeración
Ve a WooCommerce → Veri*Fac*WOO → Numeración.
Define las series y el número de inicio para facturas normales y rectificativas.
- Prefijo de serie — patrón con variables
{AAAA}(año 4 dígitos),{AA}(año 2 dígitos),{MM}(mes). Ejemplo:FAC-{AAAA}-generaFAC-2026-1,FAC-2026-2… - Número de inicio — el siguiente número que se asignará
- Restablecer el número anualmente — si lo activas, el contador vuelve a 1 cada año al emitir la primera factura
- Relleno (padding) — dígitos mínimos del número. Con relleno 4 y número 12 el resultado es
0012
Estos ajustes aplican por igual a facturas normales y rectificativas.
Paso 6 — Impuestos
Ve a WooCommerce → Veri*Fac*WOO → Impuestos.
Por cada tasa de IVA que tengas configurada en WooCommerce, asigna:
- Calificación — tipo de operación fiscal (sujeta, exenta, no sujeta…)
- Clave de régimen — régimen especial si aplica
- Categoría — VAT, IPSI, IGIC u otras categorías VeriFactu
- Motivo de exención — si la tasa está exenta, el motivo legal
Si tienes dudas sobre cómo clasificar tus tasas, consulta con tu gestor o asesor fiscal.
Paso 7 — Prueba en modo Básico
- Crea un pedido de prueba en WooCommerce.
- Ve al pedido → busca el panel lateral PDF Factura.
- Haz clic en Generar PDF y revisa que la factura tiene el aspecto correcto: datos de empresa, logo, productos, totales, serie y número.
- Si algo no cuadra (nombre de empresa, logo, numeración), vuelve a los tabs correspondientes y ajusta.
Si tienes shortcodes configurados en tu página de Thank You o en el área de cliente, comprueba también que se muestran bien.
BLOQUE B — Con licencia (Sandbox y Producción)
La licencia desbloquea la conexión con la AEAT (Sandbox y Producción) y las actualizaciones automáticas desde WordPress.
Paso 8 — Crear el emisor y aplicar la licencia
Accede al portal (verifacwoo.com/portal/) y ve a Mis Emisores. Crea un nuevo emisor con los datos de tu empresa. Al crearlo queda en estado Semilla.
Para activarlo tienes dos opciones desde la tarjeta del emisor:
Si ya tienes una licencia disponible:
- Haz clic en Aplicar VFWoo Licencia.
- Confirma el diálogo.
- El emisor pasa a estado Confirmado y recibirás un email de activación.
Si no tienes licencia:
- Haz clic en Comprar Licencia y completa la compra.
- Una vez adquirida, aplícala al emisor como en el caso anterior.
En cuanto el emisor está Confirmado, el portal genera tu Api key y Api secret.
Conectar la licencia en el plugin
Ve a WooCommerce → Veri*Fac*WOO → Licencia.
Introduce:
- Api key — la clave que te dio el portal
- Api secret — la contraseña asociada a esa clave
Haz clic en Verificar Api. Si los datos son correctos, el plugin se conecta con el portal y la licencia queda activa: el indicador del header pasará a color azul. En este punto el plugin sigue en modo Básico hasta que selecciones Sandbox o Producción.
Actualizaciones automáticas: con la licencia conectada, las actualizaciones del plugin aparecerán directamente en Plugins → Actualizaciones de WordPress.
Paso 9 — Activar Sandbox en el plugin
Completar los datos del emisor y activar Sandbox
Estos datos son necesarios para poder activar el modo Sandbox. Accede al emisor en el portal y rellena dos formularios:
- Datos del representante legal — nombre, apellidos, NIF, municipio y dirección del representante legal de la empresa.
- Datos del comercio — razón social, email de contacto, municipio, código postal y dirección del negocio.
Guarda cada sección por separado. Con los datos rellenados, activa el modo Sandbox desde la pestaña Credenciales del emisor en el portal.
Vuelve al plugin → Licencia → haz clic en Actualizar. El plugin detectará que Sandbox está disponible y podrás seleccionarlo.
En Sandbox puedes emitir facturas de prueba que van al entorno oficial de la AEAT sin que sean reales. Crea un pedido de prueba y revisa:
- ¿El estado pasa a “Confirmada AEAT”?
- ¿El QR funciona al escanearlo?
- ¿El cliente recibe el email con el PDF?
- ¿Los avisos internos llegan a tu email?
Si todo está correcto, estás listo para Producción.
Paso 10 — Otorgamiento y activación de Producción
El otorgamiento es el proceso de autorización legal necesario para activar Producción. Sin él no se pueden enviar facturas reales a Hacienda. Se hace por emisor, desde la pestaña Documentos del emisor en el portal.
- Selecciona el tipo de persona: Física o Jurídica (la jurídica requiere rellenar los datos del representante legal antes de continuar).
- Haz clic en Descargar otorgamiento — el portal genera un PDF con tus datos.
- Firma el PDF con tu certificado electrónico (FNMT, Izenpe u otro reconocido por la AEAT).
- Sube el PDF firmado desde Documentos → Enviar Documentación.
- El sistema valida la firma automáticamente. Si el NIF del certificado coincide con el del emisor, el estado pasa a Validado.
- Cuando lo desees, activa el modo Producción. El emisor pasará al estado Producción.
Con el emisor en estado Producción, vuelve al plugin → Licencia → Actualizar licencia y selecciona el modo Producción.
Importante: al activar Producción empieza a contar el período de licencia (365 días). Actívalo solo cuando estés listo para empezar a emitir facturas reales.
Paso 11 — Primera factura real
Con Producción activo, el siguiente pedido seguirá el flujo configurado automáticamente.
Para verificar que todo funciona:
- Crea un pedido real (puedes hacer un pedido de 1 € para probar).
- Comprueba que la factura se emite y el estado pasa a “Confirmada AEAT”.
- Escanea el QR — debe llevar a la verificación en la sede electrónica de la AEAT.
- Comprueba que el cliente recibe el email con el PDF.
- Opcionalmente, crea una devolución del pedido y comprueba cómo funciona la factura rectificativa.
A partir de aquí, el plugin funciona solo.
Solución de problemas habituales
El estado se queda en “Pendiente” o “Enviada”
El plugin usa una cola de tareas (Action Scheduler) para verificar las facturas de forma asíncrona. Si la AEAT tarda en responder, el estado puede quedarse en “Enviada” unos minutos. Si persiste:
- Ve a Herramientas → Estado y comprueba que Action Scheduler está activo.
- Comprueba que tu servidor tiene conexión HTTPS saliente.
El PDF no tiene el logo
- El logo debe estar subido como imagen en la biblioteca de medios de WordPress.
- En Diseño PDF, comprueba que el logo está seleccionado y guardado.
No llegan los emails internos
- Comprueba que has introducido una dirección válida en Ajustes → Avanzado → Emails internos.
- Verifica que WordPress puede enviar emails (usa el plugin WP Mail SMTP si tienes problemas de entrega).
¿Necesitas ayuda?
Desde Veri*Fac*WOO → Crear Ticket en el sidebar puedes abrir un ticket de soporte directamente. El ticket incluye automáticamente la configuración del plugin y el log de actividad.
