| name | verifactu |
| description | Use when integrating Spanish VeriFactu (AEAT) invoicing compliance into a codebase, or when verifying that billing records/invoices meet the VeriFactu regulation (huella/hash chaining, QR, leyenda, registro de alta/anulación). Wraps the `verifactu` TypeScript library and its compliance linter. |
VeriFactu
Guía la integración y verificación de cumplimiento de VeriFactu usando la
librería open source verifactu.
Cuándo usarla
- El usuario quiere que su software emita facturas conformes a VeriFactu.
- El usuario quiere comprobar si sus registros/facturas cumplen.
Qué es VeriFactu (resumen operativo)
- Cada factura → un registro de alta generado a la vez que se expide.
- Los registros se encadenan por huella SHA-256 (la huella anterior entra en
el cálculo de la siguiente) → inalterabilidad.
- La factura lleva QR de cotejo AEAT + leyenda "VERI*FACTU".
- Dos modalidades: VERI*FACTU (envío inmediato a AEAT, sin firma por
registro) y no VERI*FACTU (local, con firma XAdES).
- Obligación vigente: sociedades 1-ene-2027, resto 1-jul-2027 (RD-ley 15/2025).
Flujo de integración
npm i @inoguerols/verifactu.- Localiza dónde el código expide facturas (numeración de serie + importe).
- En ese punto: construir
RegistroAlta, calcular huella encadenada (usar la
huella del último registro de la serie), persistirla, y renderizar el QR +
leyenda en la factura/PDF.
- Operaciones exentas de IVA (p.ej. sanidad, art. 20 LIVA) → desglose como
operación exenta, no como cuota.
- Incluir la declaración responsable del sistema (ver
examples/).
Verificar cumplimiento
Ejecuta el linter sobre los registros/serie:
npx verifactu lint <archivo>
Devuelve un informe con: campos obligatorios presentes, formato de fecha/importe,
cadena de huellas intacta, QR correcto, leyenda y modalidad. Explica cada
fallo y cómo corregirlo.
No hagas
- No inventes el formato de la huella: usa
computeHuella de la librería, que
sigue el formato canónico AEAT contrastado con los vectores oficiales.
- No envíes a producción de la AEAT sin pasar antes por el entorno de pruebas.
