Verifactu para tu aplicación Node.js
Tanto si tu facturación está en un backend Express o NestJS como en un conjunto de funciones y colas, Verifactu se resuelve con una capa propia: registrar, encadenar, generar el QR y enviar.
No hace falta reescribir tu aplicación. Se añade la capa donde se emite la factura y se deja el resto como está.
Cómo lo integro
- Diagnóstico. Identifico todos los puntos donde se crea una factura o un abono, y reviso cómo se numeran y almacenan.
- Capa de registro. Creo el registro de cada factura con su huella enlazada a la anterior, garantizando el orden aunque haya peticiones simultáneas.
- QR y documento. Añado el QR y los datos obligatorios al PDF o documento que generas hoy.
- Envío con cola. Envío los registros a la AEAT desde una cola con reintentos, respetando los tiempos que indica la propia respuesta, y dejo un panel de estado.
Qué suele complicarse
- Con peticiones concurrentes, la cadena de huellas necesita un orden estricto: sin cuidado se pueden crear dos registros con el mismo anterior.
- Los trabajos en segundo plano deben ser idempotentes para no enviar dos veces el mismo registro.
- Los abonos y rectificativas también son registros, no solo las facturas normales.
Plazos
Según el calendario vigente, Verifactu es obligatorio desde el 1 de enero de 2027 para las sociedades y desde el 1 de julio de 2027 para autónomos y resto de obligados. Confirma siempre tu caso en la AEAT.
Preguntas frecuentes
¿Sirve con NestJS, Express o serverless?
Sí. La capa se adapta a tu estructura; lo importante es ordenar bien la cadena de registros.
¿Qué base de datos necesito?
La que ya uses. Lo importante es poder guardar el registro y la factura de forma consistente.
¿Tengo que cambiar de proveedor de cola?
No necesariamente. Se usa la que tengas o una sencilla si no hay ninguna.
Otros sistemas
Del blog
Cómo adaptar un ERP propio a Verifactu
Guía práctica para adaptar un ERP o programa de facturación propio a Verifactu: qué revisar primero, qué añadir y cómo hacerlo sin rehacer el sistema.
Cola de envíos a la AEAT con reintentos
Por qué enviar los registros de Verifactu desde una cola con reintentos y cómo diseñarla: estados, errores, tiempos de espera y qué hacer si la AEAT falla.