Plugin para WooCommerce
Versión 1.2.0 · WordPress ≥ 6.2 · WooCommerce 7.0 a 11.1 · PHP ≥ 7.4
Emite la factura de cada pedido de tu tienda y la comunica a la Agencia Tributaria (Verifactu, registro sin remisión inmediata) o a tu Diputación Foral (TicketBai). La configuración del plugin es una sola cosa: tu clave. El régimen fiscal, la serie, el certificado y el estado de cada envío viven en tu cuenta de apifactu, no en la tienda.
1. Descarga el plugin
- Entra en tu panel: https://app.apifactu.es → Integraciones.
- Descarga
apifactu-woocommerce-1.2.0.zip. El panel muestra elsha256del fichero por si quieres comprobarlo.
2. Instálalo en WordPress
- En tu WordPress: Plugins → Añadir nuevo → Subir plugin → elige el ZIP descargado.
- Pulsa Activar.
3. Pega tu clave
- Entra en tu panel: https://app.apifactu.es → API keys → «Crear clave».
- Copia la clave en el momento de crearla: por seguridad no se vuelve a mostrar entera.
- En WordPress: WooCommerce → Ajustes → apifactu. Pega la clave en «Clave de apifactu» y pulsa Probar conexión.
- Listo. El siguiente pedido que se complete se facturará solo.
eck_test_) y úsala igual que la real. El host es el mismo
(https://api.apifactu.es): el entorno lo decide la clave. Con eck_test_
las facturas se numeran y devuelven QR y huella, pero no se comunican a Hacienda. Cuando todo
funcione, cambia la clave por una eck_live_ y ya estás facturando de verdad.
Qué hace por cada pedido
- Con NIF del cliente, factura completa (F1). El plugin añade un campo de NIF al proceso de compra, también en el pago por bloques.
- Sin NIF y por debajo del límite que fijes, factura simplificada (F2).
- Sin NIF y por encima del límite, no emite y te avisa en el pedido para que pidas el NIF. Añádelo en la ficha del pedido y pulsa «Emitir ahora».
- Una devolución genera su factura rectificativa; un pedido cancelado con factura la anula ante Hacienda.
- Si la conexión falla, reintenta automáticamente: ningún pedido se queda sin factura en silencio.
Qué no hace
- No factura los pedidos anteriores a su instalación: al activarse se fija una fecha de corte.
- No emite dos veces el mismo pedido, ni aunque cambie de estado varias veces.
- No guarda tu certificado ni datos fiscales en la tienda.
Ajustes disponibles
| Ajuste | Para qué sirve |
|---|---|
| Cuándo facturar | Cuando el pedido se completa (recomendado) o cuando se paga. |
| Serie | Serie de facturación que usarán los pedidos de la tienda. |
| Límite de factura simplificada | Por debajo, un pedido sin NIF se factura como simplificada; por encima no se emite y se avisa. |
| Región fiscal | IVA (Península y Baleares), IGIC (Canarias) o IPSI (Ceuta y Melilla): determina los tipos admitidos. |
| Ventas al 0 % | Causa de exención por defecto para las líneas sin impuesto (Hacienda exige declararla). |
| Avisos de Hacienda (webhook) | Para que el pedido refleje si Hacienda aceptó o rechazó la factura: da de alta en tu panel → Webhooks la dirección que muestra el plugin y pega aquí el secreto. |
| Campo de NIF en el checkout | Añadirlo si la tienda no lo tiene ya y, si quieres, hacerlo obligatorio. |
| Registro de actividad | Detalle en WooCommerce → Estado → Registros. |
Preguntas frecuentes
He cambiado la clave en mi panel y la tienda da error
Las claves anteriores dejan de funcionar. Copia la nueva en WooCommerce → Ajustes → apifactu.
¿Dónde veo el estado de cada factura?
En el propio pedido de WooCommerce (recuadro «apifactu») y, con todo el detalle, en tu panel → Actividad.
¿Envía datos a algún otro sitio?
No. El plugin solo se conecta a https://api.apifactu.es con tu clave y no carga recursos externos en la tienda. Es software libre (GPLv2 o posterior); el servicio es de pago.