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.
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ónafterejecuta código tras la respuesta, pero dentro de la duración máxima de la ruta (documentación deafter). 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
| Pregunta | Quié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.

Foto: Rick Ligthelm from Rotterdam, The Netherlands, CC BY 2.0, Wikimedia Commons.
Proyectos seleccionados
Ejemplos de mi trabajo.
Desarrollo E-commerce: car-mechanic-huntington.co.uk
El sitio car-mechanic-huntington.co.uk se creó para presentar servicios de un taller mecánico y facilitar el contacto con clientes locales.
Desarrollo E-commerce: centrumpoludnie.pl
centrumpoludnie.pl es un portal para un centro comercial del sur de Gdańsk, con mapa de tiendas, promociones, noticias, módulos funcionales y alto rendimiento.
Desarrollo E-commerce: dkf.za.pl
DKF.za.pl es un sitio web creado en 2010 para el Club de Discusión Cinematográfica "ZA", que opera como parte de la Federación Polaca de Clubs de Discusión Cinematográfica.
Soporte y desarrollo WordPress en Madrid
¿Buscas el servicio: Desarrollador Next.js en Madrid?
Describe tu proyecto por e-mail. Respondo en 48 horas.
Describe tu proyectoExplora otros servicios WordPress y base de conocimiento
Migración a Astro, Next.js y headless WordPress.
Sincronización WooCommerce con ERP y mayorista.
Automatización de procesos de negocio en torno a WordPress y sistemas empresariales.
Biblioteca de casos concretos de automatización.
Headless WordPress, Sanity, Strapi y Contentful con Astro o Next.js.
Astro, MDX, edge delivery y Core Web Vitals medidos con tráfico real.
Ingeniería WordPress y arquitectura personalizada.
Arquitectura headless, ERP e IA escalable para enterprise.
Categorías relacionadas
Artículos de apoyo

De seis a dieciséis semanas para proyectos típicos, en cuatro fases: descubrimiento, alcance, construcción y cutover, ajuste. Las variables son el tamaño del catálogo, el número de integraciones, la preservación de URLs y la disposición del equipo editorial, no la elección del framework.

Análisis exhaustivo del coste total de propiedad (TCO) a 4 años, métricas reales de Core Web Vitals, arquitectura Astro 7 GraphQL APQ y matriz de decisión de 10 puntos para directores de tecnología que eligen entre WordPress desacoplado y tradicional.

La decisión entre Shopify Plus y WooCommerce headless en 2026 ya no es un compromiso binario "plataforma vs personalizado". Ambos pueden funcionar en headless, ambos integran IA, ambos sirven en el edge. Los ejes reales son el control, el coste total a lo largo de cinco años y la estrategia de salida. Este artículo recorre la matriz con datos confirmados de cada plataforma.