Módulo para PrestaShop
Versión 1.2.0 · PrestaShop 1.7.6 a 8.2 · PHP ≥ 7.4
Factura cada pedido pagado de tu tienda y lo comunica a la AEAT o a tu Diputación. Se instala y se configura desde el back office, sin FTP. Solo necesitas tu clave: el resto (certificado, modo Veri*Factu, series) se gestiona en tu cuenta de apifactu.
1. Descarga el módulo
- Entra en tu panel: https://app.apifactu.es → Integraciones.
- Descarga
apifactu-prestashop-1.2.0.zip.
2. Instálalo en PrestaShop
- En tu back office: Módulos → Gestor de módulos → Subir un módulo → elige el ZIP descargado.
- Cuando termine, pulsa Configurar en el módulo «apifactu — facturación fiscal».
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 la configuración del módulo, pega la clave en «Clave de apifactu», guarda y pulsa Probar conexión.
- Si tu tienda no pide el DNI/NIF en la dirección de facturación, el módulo te lo avisa y ofrece activarlo con un botón («Pedir el NIF en España»). Sin él, los pedidos por encima del límite de factura simplificada no se pueden emitir.
Probar sin efectos fiscales. Crea en tu panel una clave de pruebas
(empieza por
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
- Usa el DNI/NIF que ya recoge PrestaShop: con NIF, factura completa; sin NIF y por debajo del límite, simplificada.
- Los abonos generan su factura rectificativa.
- Si la API no responde, el pedido se reintenta solo cuando entras al back office. Si además quieres una tarea programada, el módulo te da una URL de cron.
- Nunca factura los pedidos anteriores a instalarlo.
Ajustes disponibles
| Ajuste | Para qué sirve |
|---|---|
| Cuándo facturar | Cuando el pedido consta como pagado (recomendado) o cuando se envía. |
| Serie de facturación | Serie 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 en el pedido. |
| Región fiscal de la tienda | IVA (21/10/4), IGIC (7/3) o IPSI (4/1). Una tienda de Canarias con esto en Península se quedaría sin facturar. |
| Ventas al 0 % | Causa de exención por defecto para las líneas sin impuesto. |
| Avisos de Hacienda (webhook) | Da de alta en tu panel → Webhooks la dirección que muestra el módulo y pega el secreto: el pedido reflejará si Hacienda aceptó o rechazó la factura. |
| Registro de actividad | Guarda el detalle en los registros de PrestaShop. Los errores se registran siempre. |
Preguntas frecuentes
¿Dónde veo la factura de un pedido?
En la ficha del pedido, el módulo muestra el número, el estado ante Hacienda y el enlace al QR. El detalle completo está en tu panel → Actividad.
He desinstalado el módulo, ¿qué pasa con las facturas?
Dejan de emitirse facturas de los nuevos pedidos. Las ya emitidas se conservan en tu cuenta de apifactu.