Verifactu en Shopify: cómo conectar tu tienda con la API Verifactu
Verifacti no tiene app oficial para Shopify: tu tienda se conecta con la API Verifactu desde un servicio propio que recibe el webhook orders/paid, 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 Shopify
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 Shopify con la API
Flujo: pedido pagado en Shopify (webhook orders/paid) → tu servicio → 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 en Shopify un webhook
orders/paid(en una app personalizada o en Configuración › Notificaciones) que apunte a tu servicio. - Verifica la firma HMAC del webhook y responde 200 enseguida.
- Convierte el pedido en la factura y llama a
POST /verifactu/create. - Guarda
uuid,qryhuellacon el pedido (por ejemplo, en un metafield) y pon el QR en la factura que envías al cliente.
¿Fabricas software y quieres ofrecer Verifactu a tus clientes? Lo tienes en SaaS.
Ejemplo: del pedido pagado al registro
Un servicio en Node.js con Express. Verifica la firma de Shopify (X-Shopify-Hmac-Sha256), descuenta el IVA si los precios lo incluyen (taxes_included), deja fuera propinas y tarjetas regalo y envía el pedido como factura simplificada. El número de factura es propio y correlativo (serie WEB-): los números de pedido de Shopify pueden tener huecos.
// Webhook orders/paid de Shopify → API Verifactu (Node.js 18+, Express).
// Variables de entorno: SHOPIFY_WEBHOOK_SECRET, VERIFACTI_API_KEY.
const crypto = require('node:crypto');
const fs = require('node:fs');
const express = require('express');
const app = express();
const hoy = ()=>new Intl.DateTimeFormat('es-ES', {
timeZone: 'Europe/Madrid',
day: '2-digit',
month: '2-digit',
year: 'numeric'
}).format(new Date()).replaceAll('/', '-');
// Numeración propia: la factura necesita una serie correlativa y sin huecos, y los números de
// pedido de Shopify pueden tenerlos. Cada pedido recibe un número una sola vez (también en los
// reintentos). Este ejemplo lo guarda en un fichero; en producción, usa tu base de datos con un
// incremento atómico.
const CONTADOR = 'numeracion.json';
function numeroDeFactura(orderId) {
const c = fs.existsSync(CONTADOR) ? JSON.parse(fs.readFileSync(CONTADOR, 'utf8')) : {
ultimo: 0,
pedidos: {}
};
if (!c.pedidos[orderId]) {
c.ultimo += 1;
c.pedidos[orderId] = String(c.ultimo);
fs.writeFileSync(CONTADOR, JSON.stringify(c));
}
return c.pedidos[orderId];
}
function factura(order) {
const porTipo = {};
const sumar = (item, bruto)=>{
const cuota = item.tax_lines.reduce((s, t)=>s + Number(t.price), 0);
// Línea sin IVA: revisa si es exenta (operacion_exenta) o no sujeta (calificacion_operacion).
const tipo = item.tax_lines.length ? Math.round(item.tax_lines[0].rate * 10000) / 100 : 0;
const descuento = (item.discount_allocations || []).reduce((s, d)=>s + Number(d.amount), 0);
const base = bruto - descuento - (order.taxes_included ? cuota : 0);
porTipo[tipo] ??= {
base: 0,
cuota: 0
};
porTipo[tipo].base += base;
porTipo[tipo].cuota += cuota;
};
// Las tarjetas regalo y las propinas no van en la factura.
order.line_items.filter((l)=>!l.gift_card).forEach((l)=>sumar(l, Number(l.price) * l.quantity));
order.shipping_lines.forEach((s)=>sumar(s, Number(s.price)));
const regalo = order.line_items.filter((l)=>l.gift_card).reduce((s, l)=>s + Number(l.price) * l.quantity, 0);
const total = Number(order.total_price) - Number(order.total_tip_received || 0) - regalo;
return {
serie: 'WEB-',
numero: numeroDeFactura(order.id),
fecha_expedicion: hoy(),
tipo_factura: 'F2',
descripcion: `Pedido ${order.name}`,
lineas: Object.entries(porTipo).map(([tipo, l])=>({
base_imponible: l.base.toFixed(2),
tipo_impositivo: tipo,
cuota_repercutida: l.cuota.toFixed(2)
})),
importe_total: total.toFixed(2)
};
}
app.post('/webhooks/shopify/orders-paid', express.raw({
type: 'application/json'
}), async (req, res)=>{
const firma = crypto.createHmac('sha256', process.env.SHOPIFY_WEBHOOK_SECRET).update(req.body).digest('base64');
const recibida = req.get('X-Shopify-Hmac-Sha256') || '';
if (firma.length !== recibida.length || !crypto.timingSafeEqual(Buffer.from(firma), Buffer.from(recibida))) {
return res.sendStatus(401);
}
const order = JSON.parse(req.body);
// Shopify espera la respuesta en menos de 5 segundos y no reenviará el webhook:
// en producción, encola el pedido y reintenta la llamada si falla.
res.sendStatus(200);
const cuerpo = JSON.stringify(factura(order));
const r = await fetch('https://api.verifacti.com/verifactu/create', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.VERIFACTI_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': `shopify-${order.id}-${crypto.createHash('sha256').update(cuerpo).digest('hex').slice(0, 12)}`
},
body: cuerpo
});
const registro = await r.json();
if (r.status !== 200) return console.error('Verifacti', r.status, registro);
// Guarda registro.uuid, registro.qr y registro.huella con el pedido (por ejemplo, en un metafield)
console.log(order.name, registro.uuid, registro.estado);
});
app.listen(3000);El código agrupa las líneas por tipo de IVA y envía siempre una factura simplificada (F2); si el cliente pide factura completa, emite una de canje (F3). 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 los tutoriales de Verifactu. 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 Shopify
| 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 Shopify
Más preguntas sobre Verifactu¿Hay un módulo o app de Verifacti para Shopify?
¿Basta con Shopify 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 Shopify en el entorno de test
Crea tu cuenta gratuita y prueba la API con un NIF de prueba antes de pasar a producción.