facturahub-verifactu-qr

Parte del ecosistema FacturaHub — facturación en España, Verifactu, IVA, Modelo 303 y automatización fiscal con IA.

Genera el QR de verificación Veri*Factu de la AEAT: la URL de cotejo + la imagen (PNG/SVG, nivel M). Para facturas en España. MIT.

Instalación

npm i facturahub-verifactu-qr

Uso

import { buildVerifactuURL, verifactuQRDataURL } from 'facturahub-verifactu-qr';

const data = { nif: 'B12345678', numSerie: 'FC-2026/0042', fecha: '18-05-2026', importe: 1210 };

buildVerifactuURL(data);
// https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR?nif=B12345678&numserie=FC-2026%2F0042&fecha=18-05-2026&importe=1210.00

const png = await verifactuQRDataURL(data);   // data:image/png;base64,...  → <img src=png>

API

| Función | Qué hace | |---|---| | buildVerifactuURL(data) | URL de cotejo (el contenido del QR) | | parseVerifactuURL(url) | Desglosa una URL de cotejo (o null) | | verifactuQRDataURL(data) | Promise<string> — QR como data URL PNG | | verifactuQRSVG(data) | Promise<string> — QR como SVG | | VALIDAR_QR_URL | Endpoints AEAT (producción / pruebas) | | QR_OPTIONS | Nivel de corrección M (ISO/IEC 18004) |

fecha en formato dd-mm-aaaa; importe se serializa con punto decimal. La barra del nº de factura se codifica sola.

Cómo funciona

Desde 2027, las facturas de un sistema Veri*Factu llevan un QR que apunta al servicio de cotejo de la AEAT con el NIF, el número de factura, la fecha y el importe. Base legal: Orden HAC/1177/2024 (cap. VIII), codificación ISO/IEC 18004 nivel M.

Documentación técnica, no asesoramiento fiscal. Verifica la especificación vigente en la sede de la AEAT.

Hecho por FacturaHub — facturación con IA para autónomos en España: el QR Veri*Factu, ya incluido y gratis. Guía: github.com/FacturaHub-com/facturahub-verifactu.

Ecosistema FacturaHub

• 🌐 FacturaHub — la app (gratis, Verifactu incluido)
• 🔌 facturahub-api — API REST + OpenAPI 3.1
• 🤖 facturahub-mcp — servidor MCP (Claude, Cursor, ChatGPT)
• 🧾 facturahub-verifactu — Verifactu por API
• 🧮 Librerías: nif-validator · iva · iban-es · factura-number · verifactu-qr · verifactu-hash · modelo-303
• ⚙️ Automatización: facturahub-n8n · n8n-nodes-facturahub · facturahub-woocommerce · facturahub-shopify

Temas: Verifactu · Facturación electrónica · IVA · Modelo 303 · AEAT · NIF/CIF · Autónomos · MCP · IA · España