Desarrollador Next.js en Madrid

Cómo emitir facturas con VeriFactu desde una aplicación Next.js: registro, huella SHA-256, cadena, QR y pruebas. Desarrollador independiente, trabajo remoto y por escrito.

Desarrollador Next.js

Mi lugar en la comunidad WordPress

  • Tengo cuenta en wordpress.org desde 2006.
  • He contribuido al núcleo de WordPress en las versiones 7.0 y 7.1.
  • Mantengo 30 plugins en wordpress.org.
  • Organizo WordCamps y hablo en ellos como ponente.
  • He asistido a todas las WordCamp Europe de 2017 a 2026.

Mi perfil en WordPress.org

Si tu empresa de Madrid emite facturas desde una aplicación Next.js propia, ya sea un portal de clientes, un panel de suscripciones o una tienda a medida, el reglamento de facturación probablemente la trata como un sistema informático de facturación. Esta página explica qué tiene que hacer el código y qué se decide antes de escribirlo. Soy Mariusz Szatkowski, un solo desarrollador, y trabajo por escrito. No doy asesoramiento fiscal: la modalidad y la lectura de la norma son cosa de tu asesoría.

#Cuándo tu aplicación cuenta como sistema de facturación

El Real Decreto 1007/2023 define en su artículo 1.2 el sistema informático de facturación como el conjunto de hardware y software con el que se expiden facturas: admite la entrada de datos, los conserva y los procesa. Un formulario de Next.js que guarda un pedido en PostgreSQL y devuelve un PDF numerado encaja en esa definición sin forzar nada.

La frontera práctica la marca quién asigna el número y quién emite el documento. Si tu aplicación solo envía el pedido a un programa de facturación de terceros y recibe la factura hecha, el sistema regulado es el del tercero y tu código es una integración. Si numera y emite tu propio código, el sistema regulado eres tú.

#Qué dice el mercado de Madrid y qué no

El INE publicó que a 1 de enero de 2025 había 3.310.824 empresas económicamente activas en España, y que la Comunidad de Madrid concentraba el 15,9 % de ellas, por detrás de Cataluña y Andalucía (nota de prensa del DIRCE). La misma nota dice que el 54,4 % no tenía asalariados y que el 81,6 % tenía dos o menos.

Con empresas tan pequeñas, un sistema propio solo compensa cuando la facturación está pegada al producto: suscripciones con prorrateo, facturación por uso, marketplaces, portales B2B con condiciones por cliente. Si tu caso es una factura al mes a cinco clientes, te lo diré y te ahorrarás el proyecto.

#Plazos y quién queda dentro

Según la nota informativa de la AEAT, tras el Real Decreto-ley 15/2025 las entidades que presentan el Impuesto sobre Sociedades deben tener el sistema adaptado antes del 1 de enero de 2027, y el resto de obligados antes del 1 de julio de 2027. La página principal de la AEAT, con fecha de actualización del 3 de noviembre de 2026, enlaza una comunicación de Hacienda del 5 de octubre de 2026 que anuncia una previsión de ampliación del plazo. Con una fecha que puede moverse, planifico el proyecto para el calendario vigente y dejo la puesta en producción desacoplada de la fecha límite.

El artículo 3 del reglamento incluye a los contribuyentes del Impuesto sobre Sociedades, a los del IRPF con actividades económicas, a los del IRNR con establecimiento permanente y a las entidades en atribución de rentas con actividad económica. El apartado 3 excluye a quien lleva los libros registro en los términos del artículo 62.6 del Reglamento del IVA. Si tu empresa lleva así sus libros, la pregunta de si te afecta se contesta en tu asesoría, no en el código.

#Dos modalidades y una decisión que no se cambia sobre la marcha

La AEAT describe dos formas válidas de cumplir: la modalidad VeriFactu, que remite cada registro a la sede electrónica, y la modalidad de conservación en el sistema emisor, la llamada NO VERI*FACTU, que añade la firma electrónica de los registros y un registro de eventos (cuestiones generales). El artículo 16.3 del reglamento exime a los sistemas verificables de firmar los registros: basta con calcular la huella.

Las preguntas frecuentes para empresas de desarrollo, actualizadas el 4 de diciembre de 2025, añaden una restricción de diseño: el usuario no puede alternar entre un tipo de sistema y otro por sesión, por arranque o por factura. La modalidad se elige antes de instalar y queda fija. Para el código eso significa un único camino compilado y probado, sin un interruptor en un panel de administración.

#Qué se guarda con cada factura

El artículo 9 obliga a generar un registro de facturación de alta de forma simultánea o inmediatamente anterior a la expedición de cada factura. En Next.js eso descarta cualquier diseño en el que primero se emite el PDF y luego, en otro paso, se “registra”. Número de factura, registro y huella nacen en la misma transacción de base de datos; si falla una pieza, no existe ninguna.

El artículo 8.2 añade que lo registrado no se edita: una corrección o una anulación se hace con un registro adicional posterior. En el modelo de datos eso se traduce en tablas de solo inserción para los registros, sin UPDATE ni DELETE, y en que “anular factura” es una acción que crea otro registro de anulación.

#La huella: una cadena de texto y SHA-256

El documento técnico de la huella fija el algoritmo (SHA-256 es el único permitido en la fecha de la versión consultada), los ocho campos de un registro de alta y su orden, y el formato de salida: hexadecimal, en mayúsculas, 64 caracteres. Los valores se recortan de espacios y se unen como nombre=valor separados por &. Si no hay huella anterior, el campo va igual, con el nombre y el signo igual y sin valor.

import { createHash } from "node:crypto";

export function huellaAlta(r) {
  const campos = [
    ["IDEmisorFactura", r.nif],
    ["NumSerieFactura", r.numSerie],
    ["FechaExpedicionFactura", r.fecha],
    ["TipoFactura", r.tipo],
    ["CuotaTotal", r.cuota],
    ["ImporteTotal", r.importe],
    ["Huella", r.huellaAnterior ?? ""],
    ["FechaHoraHusoGenRegistro", r.generadoEn],
  ];
  const cadena = campos.map(([k, v]) => `${k}=${String(v).trim()}`).join("&");
  return createHash("sha256").update(cadena, "utf8").digest("hex").toUpperCase();
}

Ejecuté esta función con los datos de los dos primeros ejemplos del documento y devuelve las mismas huellas que la AEAT publica: 3C464DAF...F12F60 para el primer registro y F7B94CFD...2A2B97 para el segundo, que encadena el anterior. Ese par de casos va a la batería de pruebas del proyecto, porque un fallo de una coma en los importes no avisa: produce una huella válida de otra cadena.

#Dos usuarios a la vez: la cadena no admite carreras

Cada huella incorpora la del registro anterior, así que la cadena es una secuencia estricta. La documentación de Next.js dice que el cliente despacha las Server Functions y espera cada una antes de enviar la siguiente. Esa cola vive en el navegador de cada usuario: no ordena nada entre dos personas que facturan a la vez desde dos oficinas.

Lo resuelvo en la base de datos, no en Next.js. Una fila por cadena guarda la última huella y la transacción de emisión la bloquea antes de leerla, con el bloqueo de fila que documenta PostgreSQL:

BEGIN;
SELECT huella FROM cadena_facturacion WHERE facturacion_id = $1 FOR UPDATE;
-- calcular la huella nueva, insertar el registro, actualizar la cabeza de la cadena
COMMIT;

La segunda emisión espera a que la primera termine y parte de su huella. El coste es que la emisión de una misma cadena es serial. Para el volumen de una empresa mediana es irrelevante; si tu volumen lo hiciera relevante, es una conversación de arquitectura que se tiene por escrito antes de empezar.

#Una cadena por facturación, no una por aplicación

Las preguntas frecuentes de la AEAT tratan cada facturación independiente, sea de otro obligado o de otro centro como una tienda, como un sistema virtual aparte con su propio número de instalación, que no puede repetirse nunca. Recomiendan como valores una marca de tiempo completa o un número secuencial que no se reutilice. Si el mismo software se reinstala en el mismo equipo, el número cambia.

Para una aplicación multiempresa esto condiciona el esquema desde el primer día: una cadena y un número de instalación por obligado y por centro. El artículo 7 permite usar un mismo sistema para varios obligados siempre que sus registros estén diferenciados y los requisitos se cumplan por separado. Las mismas preguntas explican que, en un sistema en la nube con varios usuarios, el campo IndicadorMultiplesOT se calcula por usuario y no a nivel global.

#Dónde pongo cada pieza en Next.js

  • Módulo de dominio con import "server-only". El cálculo de huella, el bloqueo y la construcción del registro viven en un módulo que la guía de seguridad de datos de Next.js describe así: si alguien lo importa desde un componente de cliente, el build falla.
  • Runtime Node declarado. Los route handlers aceptan export const runtime = "nodejs" en su configuración de segmento (documentación de Route Handlers). Lo fijo en las rutas que emiten y remiten, para que la ejecución no dependa del valor por defecto de la plataforma.
  • Certificado fuera del cliente. Las preguntas de la AEAT exigen un certificado electrónico cualificado válido para operar el sistema. El certificado de tu empresa se guarda en el almacén de secretos del servidor; Next.js solo expone al navegador las variables que empiezan por NEXT_PUBLIC_.
  • Autorización dentro de cada Server Action. La documentación recuerda que las acciones se invocan por POST y son accesibles también con peticiones directas, así que comprobar la sesión en el formulario no basta: se comprueba dentro de la acción.
  • Remisión con cola, no con after. La función after ejecuta código tras la respuesta, pero dentro de la duración máxima de la ruta (documentación de after). Sirve para disparar un primer intento de envío. La garantía la da una tabla de registros pendientes y un proceso que reintenta, porque las preguntas de la AEAT describen los registros no remitidos como encolados, con reintentos periódicos, y no como un fallo.

#El QR y la leyenda en el PDF

El documento del código QR (versión 0.5.0 del 10 de diciembre de 2025) y el artículo 21 de la Orden HAC/1177/2024 fijan lo que el generador de PDF debe respetar: un tamaño entre 30 x 30 y 40 x 40 milímetros, norma ISO/IEC 18004:2015, corrección de errores de nivel M, al menos 2 milímetros de margen en blanco por cada lado, el texto “QR tributario:” encima y, en el sistema verificable, la frase “Factura verificable en la sede electrónica de la AEAT” o VERI*FACTU debajo. En facturas de varias páginas el código aparece una vez, en la primera.

La URL lleva cuatro parámetros: NIF del emisor, número de serie, fecha en formato DD-MM-AAAA e importe total con punto decimal. Los valores se codifican como URL en UTF-8. El propio documento muestra que un & dentro del número de serie debe viajar como %26:

const base = "https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR?";
const qr = base + [["nif", nif], ["numserie", numSerie], ["fecha", fecha], ["importe", importe]]
  .map(([k, v]) => `${k}=${encodeURIComponent(v)}`)
  .join("&");

El PDF lo genero desde un route handler en servidor con los datos del registro ya guardado, de modo que el QR siempre describe lo que consta en la base de datos y no lo que mostraba el formulario.

#Pruebas sin facturas ficticias

Las preguntas frecuentes de la AEAT dicen que un sistema operativo que factura “en real” no puede producir facturas ficticias: las de prueba o formación, si llegan a ser facturas, se tratan como reales. Para probar existe el entorno de pruebas externas, con otro host (prewww2.aeat.es) distinto del de producción, y los servicios de producción están disponibles desde el 23 de abril de 2025.

En el proyecto eso se traduce en una regla de despliegue: staging y previsualizaciones apuntan siempre al host de pruebas, y el host de producción solo existe como variable en el entorno de producción. Ningún desarrollador, yo incluido, emite una factura de prueba contra la sede real.

#Lista de comprobación antes del primer commit

PreguntaQuién la responde
¿La empresa está en el ámbito del artículo 3 del reglamento?Tu asesoría
¿Modalidad VeriFactu o conservación en el sistema emisor?Tu asesoría, con mi parte técnica por escrito
¿Quién numera: tu código o un programa de terceros?Se decide en el alcance
¿Cuántas cadenas hay (obligados, centros) y qué número de instalación lleva cada una?Alcance y modelo de datos
¿Quién guarda el certificado cualificado y dónde?Tu empresa y el almacén de secretos del servidor
¿Quién firma la declaración responsable del sistema?Quien produce el sistema
¿Hay pruebas con los dos casos de la AEAT y con anulaciones?Batería de pruebas del proyecto
¿Qué fecha límite vigente se aplica a tu empresa?Tu asesoría, con la página de la AEAT

#Cómo trabajo contigo

Todo ocurre por escrito. Me envías la dirección del repositorio o de la aplicación, un ejemplo real de factura actual, la decisión de tu asesoría sobre la modalidad y los accesos de lectura que necesite. Yo contesto con las preguntas abiertas y un documento de alcance que dice qué se construye, qué queda fuera y qué aportas tú. Las maquetas de la factura, si cambian, las pones tú, y yo las implemento tal cual.

Trabajo en un entorno de pruebas al que también tienes acceso. Nada llega a producción sin tu aceptación escrita, y cualquier petición posterior al alcance acordado lleva su propia estimación. Después, si quieres, queda un mantenimiento mensual opcional que incluye vigilar los cambios de la AEAT en la especificación técnica.

#Preguntas frecuentes

¿Mi aplicación Next.js tiene que cumplir VeriFactu aunque la factura la genere un servicio externo? Depende de quién numera y emite. Si el servicio externo asigna el número y devuelve la factura, el sistema regulado es el suyo y tu aplicación es una integración. Si tu código numera y emite, el sistema es tuyo.

¿Sirve una función serverless para emitir? Sí, si la emisión escribe en una base de datos transaccional. La función no guarda estado y la cadena sí, así que el orden lo garantiza el bloqueo en la base de datos, no el tipo de hosting.

¿Qué pasa si la AEAT no responde cuando emito una factura? La factura se emite igualmente y el registro queda en una cola de pendientes con reintentos. La emisión no depende de que el envío funcione en ese instante.

¿Cómo pruebo sin generar facturas reales? Con el entorno de pruebas externas de la AEAT, un host distinto del de producción. Una factura de prueba emitida contra producción se trata como real.

¿Quién firma la declaración responsable? La entidad que produce el sistema. Si el sistema es tuyo, la firma tu empresa; yo implemento los requisitos técnicos, pero no firmo esa declaración.

¿Cuándo tengo que estar adaptado? Según la nota de la AEAT, antes del 1 de enero de 2027 si presentas el Impuesto sobre Sociedades y antes del 1 de julio de 2027 en el resto de casos. La AEAT enlaza una comunicación de Hacienda del 5 de octubre de 2026 que anuncia una previsión de ampliación, así que confirma la fecha vigente con tu asesoría.

#Cuéntame tu proyecto por escrito

Envíame por el formulario de contacto la dirección de tu aplicación o el repositorio, cómo emites hoy las facturas, tu fecha límite y el stack actual. Te respondo por escrito en días laborables, con las preguntas que falten y una primera estimación gratuita. Para el contexto de WooCommerce, tengo una guía de VeriFactu y WooCommerce.

Pasarela de Arganzuela sobre el Manzanares, Madrid Río

Foto: Rick Ligthelm from Rotterdam, The Netherlands, CC BY 2.0, Wikimedia Commons.

¿Buscas el servicio: Desarrollador Next.js en Madrid?

Describe tu proyecto por e-mail. Respondo en 48 horas.

Describe tu proyecto

Explora otros servicios WordPress y base de conocimiento