Verifactu en PrestaShop: cómo conectar tu tienda con la API Verifactu
Verifacti no tiene módulo oficial para PrestaShop: tu tienda se conecta con la API Verifactu con un módulo propio que, cuando PrestaShop genera la factura de un pedido, la envía en JSON y guarda el QR que devuelve la API. Sin generar el XML, sin calcular la huella y sin certificado digital: Verifacti envía el registro de facturación a la AEAT como colaborador social. En Álava, Bizkaia y Gipuzkoa, el mismo patrón sirve con la API TicketBAI.
Qué APIs necesitas para PrestaShop
Tu conector usa dos piezas: la API de envío que corresponde al NIF (API Verifactu en territorio común; API TicketBAI en Álava, Bizkaia y Gipuzkoa) y la API de gestión de NIFs, que integras una vez para dar de alta el NIF, gestionar el modelo de representación y recibir los webhooks. Cada NIF usa una u otra API según dónde tribute.
Cómo conectar PrestaShop con la API
Flujo: factura de pedido en PrestaShop (hook actionOrderStatusPostUpdate, cuando el estado genera factura) → tu módulo → API Verifactu o API TicketBAI → AEAT o hacienda foral.
- Da de alta el NIF con la API de gestión de NIFs y firma el modelo de representación. Cada NIF tiene su API key.
- Crea un módulo en
modules/verifactique registre el hookactionOrderStatusPostUpdatey una tabla para los registros. - Cuando el pedido ya tiene número de factura, llama a
POST /verifactu/createcon ese número. - Guarda
uuid,qryhuellay pinta el QR en la plantilla de la factura en PDF.
¿Fabricas software y quieres ofrecer Verifactu a tus clientes? Lo tienes en software de facturación.
Ejemplo: de la factura del pedido al registro
El módulo usa el número de factura de PrestaShop (con su prefijo), no la referencia del pedido, para que la numeración sea la de tus facturas.
<?php
// modules/verifacti/verifacti.php · PrestaShop 1.7 y 8.
// Envía cada factura que genera PrestaShop a la API Verifactu.
// Configura la API key en Configuration::updateValue('VERIFACTI_API_KEY', 'vf_test_...').
if (!defined('_PS_VERSION_')) {
exit;
}
class Verifacti extends Module
{
public function __construct()
{
$this->name = 'verifacti';
$this->version = '1.0.0';
$this->author = 'Tu empresa';
parent::__construct();
$this->displayName = 'Verifactu con Verifacti';
}
public function install()
{
return parent::install()
&& $this->registerHook('actionOrderStatusPostUpdate')
&& Db::getInstance()->execute('CREATE TABLE IF NOT EXISTS `' . _DB_PREFIX_ . 'verifacti` (
`id_order` INT UNSIGNED PRIMARY KEY, `uuid` VARCHAR(36), `huella` VARCHAR(64), `qr` MEDIUMTEXT)');
}
public function hookActionOrderStatusPostUpdate($params)
{
$order = new Order((int) $params['id_order']);
if (!$order->invoice_number || $this->registrada($order->id)) {
return;
}
$r = $this->llamar(json_encode($this->factura($order)), 'prestashop-' . $order->id);
if ($r['status'] === 200) {
Db::getInstance()->insert('verifacti', [
'id_order' => (int) $order->id,
'uuid' => pSQL($r['body']['uuid']),
'huella' => pSQL($r['body']['huella']),
'qr' => pSQL($r['body']['qr']),
]);
} else {
PrestaShopLogger::addLog('Verifactu ' . json_encode($r['body']), 3, null, 'Order', (int) $order->id);
}
}
private function factura(Order $order)
{
// Base y cuota por tipo de IVA, con los descuentos (cupones) ya repartidos
$porTipo = [];
foreach ($order->getProductTaxesDetails() as $d) {
$tipo = (string) (float) (new Tax((int) $d['id_tax']))->rate;
$porTipo[$tipo]['base'] = ($porTipo[$tipo]['base'] ?? 0) + $d['total_tax_base'];
$porTipo[$tipo]['cuota'] = ($porTipo[$tipo]['cuota'] ?? 0) + $d['total_amount'];
}
if ($order->total_shipping_tax_excl > 0) {
$tipo = (string) (float) $order->carrier_tax_rate;
$porTipo[$tipo]['base'] = ($porTipo[$tipo]['base'] ?? 0) + $order->total_shipping_tax_excl;
$porTipo[$tipo]['cuota'] = ($porTipo[$tipo]['cuota'] ?? 0) + $order->total_shipping_tax_incl - $order->total_shipping_tax_excl;
}
// Si usas envoltorio de regalo, súmalo igual con total_wrapping_tax_excl / _incl
$direccion = new Address((int) $order->id_address_invoice);
$nif = $direccion->vat_number ?: $direccion->dni;
$factura = [
'serie' => Configuration::get('PS_INVOICE_PREFIX', (int) $order->id_lang) ?: 'FA',
'numero' => sprintf('%06d', $order->invoice_number),
'fecha_expedicion' => date('d-m-Y', strtotime($order->invoice_date)),
'tipo_factura' => $nif ? 'F1' : 'F2',
'descripcion' => 'Pedido ' . $order->reference,
'lineas' => [],
'importe_total' => number_format($order->total_paid_tax_incl, 2, '.', ''),
];
if ($nif) {
$factura['nif'] = $nif;
$factura['nombre'] = $direccion->company ?: $direccion->firstname . ' ' . $direccion->lastname;
}
foreach ($porTipo as $tipo => $l) {
$factura['lineas'][] = [
'base_imponible' => number_format($l['base'], 2, '.', ''),
'tipo_impositivo' => $tipo,
'cuota_repercutida' => number_format($l['cuota'], 2, '.', ''),
];
}
return $factura;
}
private function llamar($cuerpo, $clave)
{
$ch = curl_init('https://api.verifacti.com/verifactu/create');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . Configuration::get('VERIFACTI_API_KEY'),
'Content-Type: application/json',
'Idempotency-Key: ' . $clave . '-' . substr(hash('sha256', $cuerpo), 0, 12),
],
CURLOPT_POSTFIELDS => $cuerpo,
]);
$body = curl_exec($ch);
return ['status' => curl_getinfo($ch, CURLINFO_HTTP_CODE), 'body' => json_decode((string) $body, true)];
}
private function registrada($idOrder)
{
return (bool) Db::getInstance()->getValue('SELECT 1 FROM `' . _DB_PREFIX_ . 'verifacti` WHERE id_order = ' . (int) $idOrder);
}
}El código agrupa las líneas por tipo de IVA y usa F1 si el cliente tiene NIF y F2 si no. Envía la cabecera Idempotency-Key con el identificador de pedido y un resumen del cuerpo: un reintento igual no duplica la factura y, si corriges los datos tras un error, la clave cambia. La respuesta trae el uuid, el estado (Pendiente: el envío a la AEAT queda en cola), la URL de verificación, el QR en Base64 y la huella: guárdalos con la factura.
Más código en el tutorial de Verifactu en PHP. Para TicketBAI, la llamada es a POST /ticketbai/create con la API key del NIF foral: los campos, en la documentación de la API TicketBAI.
Casos particulares en PrestaShop
| Caso | Qué hacer | Dónde ampliar |
|---|---|---|
| Numeración | Cada factura necesita una serie con numeración correlativa. Si los números de factura pueden tener huecos, asigna a la factura un número propio | Requisitos de Verifactu |
| Cliente sin NIF | Factura simplificada (F2), sin nif ni nombre. La API rechaza una F2 de más de 3.000 € (vf-verifactu-f2_limite_3000) | Factura simplificada |
| Devolución o abono | Factura rectificativa: R5 si la original era simplificada; R1–R4 si era completa | Rectificativas |
| Cliente que pide factura completa después | Factura de canje (F3) que sustituye a la simplificada | Factura de canje |
| Canarias, Ceuta y Melilla | IGIC o IPSI en las líneas (campo impuesto), no IVA | IGIC · IPSI |
| Productos sin IVA | Revisa si son exentos (operacion_exenta) o no sujetos (calificacion_operacion): no se envían como tipo 0 | Factura exenta |
| Anulación | Solo para facturas que no debieron emitirse: POST /verifactu/cancel | Anulación |
| Venta a otro país de la UE | Depende de si el cliente es empresa y del umbral de ventas a distancia | Ejemplos intracomunitarios |
| Varias sociedades o tiendas | Un NIF por sociedad, cada uno con su API key | API de gestión de NIFs |
Fechas
La primera fila solo aplica si construyes el conector para venderlo a otros: entonces vendes software de facturación. Para quien factura, las fechas de Verifactu están publicadas en el BOE y el aplazamiento a octubre de 2028 está anunciado sin norma publicada. En Álava, Bizkaia y Gipuzkoa, TicketBAI está en vigor.
| Quién | Fecha | Estado | Norma |
|---|---|---|---|
| Productores y comercializadores de software de facturación El RDL 15/2025 no modificó esta fecha. | Desde 29 jul 2025 | En vigor | RD 1007/2023 · Orden HAC/1177/2024 |
| Contribuyentes del Impuesto sobre Sociedades | 1 ene 2027 | Publicada en el BOE con fecha futura | RDL 15/2025 |
| Resto de obligados, autónomos incluidos | 1 jul 2027 | Publicada en el BOE con fecha futura | RDL 15/2025 |
| Aplazamiento de las obligaciones pendientes La nota no precisa el alcance para quien factura más de 8 M€. | oct 2028 | Anunciada sin norma publicada | Nota de Hacienda, 5 oct 2026 |
| TicketBAI en Álava: obligados forales Escalonado desde el 1 de abril de 2022; el resto de contribuyentes, desde el 1 de diciembre de 2022. | Desde 1 dic 2022 | En vigor | NF 13/2021 y DF 48/2021 · FAQ 1.9 · calendario |
| Batuz en Bizkaia (TicketBAI y LROE): todos los obligados Sociedades que no son pymes, desde el 1 de enero de 2024; el resto, en ventanas el 1 de julio de 2024, el 1 de enero de 2025, el 1 de julio de 2025 y el 1 de enero de 2026. | Desde 1 ene 2026 | En vigor | NF 8/2023 · Batuz |
| TicketBAI en Gipuzkoa: obligados forales Escalonado por actividad desde el 1 de julio de 2022. | Desde 1 jun 2023 | En vigor | NF 3/2020 · DF 32/2020 |
Esta información no es asesoramiento: cada contribuyente determina lo que le aplica con su asesor.
Más detalle en plazos de Verifactu y TicketBAI.
Precio
Tarifa pública de la API Verifactu y la API TicketBAI: pagas por cada NIF activo en producción, sin IVA. Para volumen hay precio a medida por NIF.
Desde
14,99 €
al mes el primer NIF activo en producción, sin IVA
Ver todos los precios- El precio por NIF baja con cada tramo de NIFs.
- Entorno de test y NIF de prueba gratuitos.
- Plan anual con un 10 % de descuento, sin costes de instalación.
- Hasta 3.000 registros de facturación al mes por NIF.
- Plan Startup para empresas de menos de 12 meses, con menos de 100.000 € de facturación y menos de 200.000 € de financiación.
- Mismo precio con la API Verifactu y la API TicketBAI: cada NIF usa una u otra según dónde tribute.
- Firma online del modelo de representación: 2,90 € + IVA por firma.
Recursos para desarrolladores
Para tu IA: llms.txt y la especificación OpenAPI.
Preguntas sobre Verifactu y PrestaShop
Más preguntas sobre Verifactu¿Hay un módulo o app de Verifacti para PrestaShop?
¿Basta con PrestaShop para cumplir Verifactu?
¿Sirve también para TicketBAI?
/ticketbai/create), los campos de la factura y la API key.¿Necesito certificado digital?
¿Cuánto cuesta?
Otras integraciones
Conecta PrestaShop en el entorno de test
Crea tu cuenta gratuita y prueba la API con un NIF de prueba antes de pasar a producción.