Verifactu en WooCommerce: cómo conectar tu tienda con la API Verifactu
Verifacti no tiene plugin oficial para WooCommerce: tu tienda se conecta con la API Verifactu con un plugin propio que, al completarse un pedido, envía la factura 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 WooCommerce
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 WooCommerce con la API
Flujo: pedido completado en WooCommerce (hook woocommerce_order_status_completed) → tu plugin → 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 plugin propio (un archivo en
wp-content/plugins) y define la constanteVERIFACTI_API_KEYenwp-config.php. - Engancha
woocommerce_order_status_completedy llama aPOST /verifactu/createconwp_remote_post. - Guarda
uuid,qryhuellacomo metadatos del pedido y añade el QR a la factura en PDF.
WooCommerce no trae un campo de NIF: el código lee _billing_nif, que es el que suelen añadir los plugins de facturas españolas. Cámbialo por el tuyo. Si prefieres facturar al cobrar y no al completar el pedido, engancha woocommerce_payment_complete; el resto del código no cambia.
¿Fabricas software y quieres ofrecer Verifactu a tus clientes? Lo tienes en software de facturación.
Ejemplo: del pedido completado al registro
Un plugin de un solo archivo. Recorre las líneas, el envío y las tarifas del pedido, toma el tipo de IVA de cada tasa de WooCommerce y agrupa por tipo. Asigna a la factura un número propio y correlativo (serie WEB-), una sola vez por pedido. Si la API no responde, lo reintenta a los 5 minutos con Action Scheduler; si responde con un error, lo deja anotado en el pedido.
<?php
/**
* Plugin Name: Verifactu con Verifacti
* Envía cada pedido completado de WooCommerce a la API Verifactu y guarda el QR en el pedido.
* Requiere la constante VERIFACTI_API_KEY en wp-config.php.
*/
// Numeración propia: la factura necesita una serie correlativa y sin huecos, y los números de
// pedido de WooCommerce pueden tenerlos. Cada pedido recibe un número una sola vez.
function verifacti_numero(WC_Order $order): string
{
global $wpdb;
$numero = $order->get_meta('_verifactu_numero');
if ($numero) {
return $numero;
}
add_option('verifacti_ultimo_numero', 0);
$wpdb->query("UPDATE {$wpdb->options} SET option_value = LAST_INSERT_ID(option_value + 1) WHERE option_name = 'verifacti_ultimo_numero'");
$numero = (string) $wpdb->get_var('SELECT LAST_INSERT_ID()');
$order->update_meta_data('_verifactu_numero', $numero);
$order->save();
return $numero;
}
function verifacti_factura(WC_Order $order): array
{
$porTipo = [];
foreach ($order->get_items(['line_item', 'shipping', 'fee']) as $item) {
$tipo = '0'; // línea sin IVA: revisa si es exenta (operacion_exenta) o no sujeta (calificacion_operacion)
foreach ($item->get_taxes()['total'] as $rate_id => $importe) {
if ($importe !== '') {
$tipo = (string) (float) WC_Tax::get_rate_percent_value($rate_id);
}
}
$porTipo[$tipo]['base'] = ($porTipo[$tipo]['base'] ?? 0) + (float) $item->get_total();
$porTipo[$tipo]['cuota'] = ($porTipo[$tipo]['cuota'] ?? 0) + (float) $item->get_total_tax();
}
$nif = $order->get_meta('_billing_nif'); // el campo que añada tu plugin de NIF
$factura = [
'serie' => 'WEB-',
'numero' => verifacti_numero($order),
'fecha_expedicion' => wp_date('d-m-Y'),
'tipo_factura' => $nif ? 'F1' : 'F2',
'descripcion' => 'Pedido ' . $order->get_order_number(),
'lineas' => [],
'importe_total' => number_format((float) $order->get_total(), 2, '.', ''),
];
if ($nif) {
$factura['nif'] = $nif;
$factura['nombre'] = $order->get_billing_company() ?: $order->get_formatted_billing_full_name();
}
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;
}
function verifacti_enviar($order_id)
{
$order = wc_get_order($order_id);
if ($order->get_meta('_verifactu_uuid')) {
return;
}
$cuerpo = wp_json_encode(verifacti_factura($order));
$respuesta = wp_remote_post('https://api.verifacti.com/verifactu/create', [
'timeout' => 30,
'headers' => [
'Authorization' => 'Bearer ' . VERIFACTI_API_KEY,
'Content-Type' => 'application/json',
'Idempotency-Key' => 'woo-' . $order->get_id() . '-' . substr(hash('sha256', $cuerpo), 0, 12),
],
'body' => $cuerpo,
]);
$status = is_wp_error($respuesta) ? 0 : wp_remote_retrieve_response_code($respuesta);
if ($status === 0 || $status >= 500) {
$order->add_order_note('Verifactu: sin respuesta, se reintenta en 5 minutos.');
as_schedule_single_action(time() + 300, 'verifacti_reintentar', [$order_id]);
return;
}
$registro = json_decode(wp_remote_retrieve_body($respuesta), true);
if ($status !== 200) {
$order->add_order_note('Verifactu: ' . ($registro['codigo'] ?? '') . ' ' . ($registro['error'] ?? ''));
return;
}
$order->update_meta_data('_verifactu_uuid', $registro['uuid']);
$order->update_meta_data('_verifactu_qr', $registro['qr']);
$order->update_meta_data('_verifactu_huella', $registro['huella']);
$order->save();
}
add_action('woocommerce_order_status_completed', 'verifacti_enviar');
add_action('verifacti_reintentar', 'verifacti_enviar');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 WooCommerce
| Caso | Qué hacer | Dónde ampliar |
|---|---|---|
| Numeración | El código asigna a cada pedido un número propio y correlativo (serie WEB-), una sola vez: los números de pedido pueden tener huecos | 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 WooCommerce
Más preguntas sobre Verifactu¿Hay un plugin de Verifacti para WooCommerce?
¿Basta con WooCommerce 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 WooCommerce en el entorno de test
Crea tu cuenta gratuita y prueba la API con un NIF de prueba antes de pasar a producción.