Verifactu in PrestaShop: how to connect your store with the Verifactu API
Verifacti has no official PrestaShop module: your store connects to the Verifactu API with your own module that, when PrestaShop generates an order invoice, sends it as JSON and stores the QR the API returns. No XML to generate, no hash to compute and no digital certificate: Verifacti sends the invoicing record to the AEAT as a colaborador social. In Álava, Bizkaia and Gipuzkoa, the same pattern works with the TicketBAI API.
Which APIs you need for PrestaShop
Your connector uses two pieces: the submission API that matches the NIF (Verifactu API in common territory; TicketBAI API in Álava, Bizkaia and Gipuzkoa) and the NIF management API, integrated once to register the NIF, manage the representation form and receive webhooks. Each NIF uses one API or the other depending on where it is taxed.
How to connect PrestaShop with the API
Flow: order invoice in PrestaShop (actionOrderStatusPostUpdate hook, when the state generates an invoice) → your module → Verifactu API or TicketBAI API → AEAT or foral treasury.
- Register the NIF with the NIF management API and sign the representation form. Each NIF has its own API key.
- Create a module in
modules/verifactithat registers theactionOrderStatusPostUpdatehook and a table for the records. - When the order already has an invoice number, call
POST /verifactu/createwith that number. - Store
uuid,qrandhuellaand draw the QR in the PDF invoice template.
Do you build software and want to offer Verifactu to your customers? See invoicing software.
Example: from the order invoice to the record
The module uses PrestaShop's invoice number (with its prefix), not the order reference, so the numbering is that of your invoices.
<?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);
}
}The code groups the lines by VAT rate and uses F1 if the customer has a NIF and F2 otherwise. It sends the Idempotency-Key header with the order identifier plus a digest of the body: an identical retry never duplicates the invoice and, if you fix the data after an error, the key changes. The response carries the uuid, the state (Pendiente: the submission to the AEAT is queued), the verification URL, the QR in Base64 and the hash: store them with the invoice.
More code in the Verifactu tutorial in PHP. For TicketBAI, the call goes to POST /ticketbai/create with the foral NIF's API key: the fields, in the TicketBAI API documentation.
Special cases in PrestaShop
| Case | What to do | Read more |
|---|---|---|
| Numbering | Every invoice needs a series with sequential numbering. If invoice numbers can have gaps, give the invoice its own number | Verifactu requirements |
| Customer without a NIF | Simplified invoice (F2), without nif or nombre. The API rejects an F2 above €3,000 (vf-verifactu-f2_limite_3000) | Simplified invoice |
| Return or refund | Corrective invoice: R5 if the original was simplified; R1–R4 if it was a full invoice | Corrective invoices |
| Customer asks for a full invoice later | Exchange invoice (F3) replacing the simplified one | Exchange invoice |
| Canary Islands, Ceuta and Melilla | IGIC or IPSI in the lines (impuesto field), not VAT | IGIC · IPSI |
| Products without VAT | Check whether they are exempt (operacion_exenta) or not subject (calificacion_operacion): they are not sent at rate 0 | Exempt invoice |
| Cancellation | Only for invoices that should never have been issued: POST /verifactu/cancel | Cancellation |
| Sale to another EU country | It depends on whether the customer is a business and on the distance-selling threshold | Intra-EU examples |
| Several companies or shops | One NIF per company, each with its own API key | NIF management API |
Dates
The first row only applies if you build the connector to sell it: then you sell invoicing software. For those who invoice, the Verifactu dates are published in the BOE and the postponement to October 2028 is announced with no rule published. In Álava, Bizkaia and Gipuzkoa, TicketBAI is in force.
| Who | Date | Status | Rule |
|---|---|---|---|
| Producers and resellers of invoicing software RDL 15/2025 did not change this date. | Since 29 Jul 2025 | In force | RD 1007/2023 · Orden HAC/1177/2024 |
| Corporate Income Tax payers | 1 Jan 2027 | Published in the BOE, future date | RDL 15/2025 |
| Everyone else, including the self-employed | 1 Jul 2027 | Published in the BOE, future date | RDL 15/2025 |
| Postponement of the pending obligations The note does not specify the scope for businesses invoicing over €8M. | Oct 2028 | Announced, no rule published | Nota de Hacienda, 5 oct 2026 |
| TicketBAI in Álava: foral taxpayers Phased from 1 April 2022; all other taxpayers since 1 December 2022. | Since 1 Dec 2022 | In force | NF 13/2021 y DF 48/2021 · FAQ 1.9 · calendario |
| Batuz in Bizkaia (TicketBAI and LROE): all taxpayers Companies that are not SMEs since 1 January 2024; everyone else in windows on 1 July 2024, 1 January 2025, 1 July 2025 and 1 January 2026. | Since 1 Jan 2026 | In force | NF 8/2023 · Batuz |
| TicketBAI in Gipuzkoa: foral taxpayers Phased by activity from 1 July 2022. | Since 1 Jun 2023 | In force | NF 3/2020 · DF 32/2020 |
This is not advice: each taxpayer determines what applies to them with their adviser.
More detail in Verifactu dates and TicketBAI.
Pricing
Public tariff of the Verifactu API and the TicketBAI API: you pay per NIF active in production, VAT excluded. Custom per-NIF pricing is available for volume.
From
€14.99
per month for the first NIF active in production, VAT excluded
See all pricing- The price per NIF goes down with every tier.
- Free test environment and test NIF.
- Annual plan with a 10% discount, no setup fees.
- Up to 3,000 invoicing records per month per NIF.
- Startup plan for companies under 12 months old, with under €100,000 in revenue and under €200,000 in funding.
- Same price with the Verifactu API and the TicketBAI API: each NIF uses one or the other depending on where it is taxed.
- Online signing of the representation form: €2.90 + VAT per signature.
Developer resources
For your AI: llms.txt and the OpenAPI specification.
Questions about Verifactu and PrestaShop
More questions about VerifactuIs there a module or app from Verifacti for PrestaShop?
Does PrestaShop comply with Verifactu on its own?
Does it work for TicketBAI too?
/ticketbai/create), the invoice fields and the API key change.Do I need a digital certificate?
How much does it cost?
Other integrations
Connect PrestaShop in the test environment
Create your free account and try the API with a test NIF before going to production.