Estructura del XML de Verifactu: el registro de facturación
El registro de facturación de Verifactu es un XML que sigue los esquemas SuministroLR.xsd y SuministroInformacion.xsd de la AEAT: un RegFactuSistemaFacturacion con una Cabecera (el obligado a emitir) y uno o varios RegistroFactura, cada uno con un RegistroAlta o un RegistroAnulacion encadenado al anterior por su huella. Con la API Verifactu no lo compones tú: envías JSON y Verifacti genera el XML, que puedes descargar.
El contenido y el formato del registro los fijan el RD 1007/2023 y la Orden HAC/1177/2024, en vigor; los esquemas están en el portal de desarrolladores de la AEAT.
Antes de empezar
- Si quieres descargar un XML real, una cuenta gratuita: incluye entorno de test y NIF de prueba.
- Los esquemas XSD de la AEAT, en su portal de desarrolladores.
Qué exige la norma
Cada factura genera un registro de facturación con el contenido y el formato que fija la Orden HAC/1177/2024. En la modalidad VERI*FACTU, ese registro se remite a la AEAT. No confundir el registro de facturación con la factura: el registro es el XML que acompaña a cada factura, y una misma factura puede tener varios (alta, subsanación, anulación). El resumen de la norma, en la normativa de Verifactu.
Estructura general del envío
El envío tiene una raíz, RegFactuSistemaFacturacion, con una Cabecera que identifica al obligado a emitir y uno o varios RegistroFactura. Los elementos usan dos espacios de nombres: sum (SuministroLR.xsd) y sum1 (SuministroInformacion.xsd). Todo ello viaja dentro de un sobre SOAP.
RegFactuSistemaFacturacion
├── Cabecera
│ ├── ObligadoEmision NombreRazon y NIF
│ ├── Representante (opcional)
│ ├── RemisionVoluntaria (opcional) FechaFinVeriFactu, Incidencia
│ └── RemisionRequerimiento (opcional)
└── RegistroFactura (uno o varios, hasta 1.000)
└── RegistroAlta o RegistroAnulacionRegistro de alta
Ejemplo: una factura F1
El XML que Verifacti genera para la factura del tutorial de PHP (primer registro del NIF). Valida contra los XSD de la AEAT. Los datos de SistemaInformatico y la fecha y hora de generación son de ejemplo.
<sum:RegFactuSistemaFacturacion xmlns:sum="https://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/tike/cont/ws/SuministroLR.xsd" xmlns:sum1="https://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/tike/cont/ws/SuministroInformacion.xsd">
<sum:Cabecera>
<sum1:ObligadoEmision>
<sum1:NombreRazon>EMPRESA DE PRUEBA SL</sum1:NombreRazon>
<sum1:NIF>B12345674</sum1:NIF>
</sum1:ObligadoEmision>
</sum:Cabecera>
<sum:RegistroFactura>
<sum1:RegistroAlta>
<sum1:IDVersion>1.0</sum1:IDVersion>
<sum1:IDFactura>
<sum1:IDEmisorFactura>B12345674</sum1:IDEmisorFactura>
<sum1:NumSerieFactura>A1</sum1:NumSerieFactura>
<sum1:FechaExpedicionFactura>18-11-2026</sum1:FechaExpedicionFactura>
</sum1:IDFactura>
<sum1:RefExterna>11111111-2222-3333-4444-555555555555</sum1:RefExterna>
<sum1:NombreRazonEmisor>EMPRESA DE PRUEBA SL</sum1:NombreRazonEmisor>
<sum1:Subsanacion>N</sum1:Subsanacion>
<sum1:RechazoPrevio>N</sum1:RechazoPrevio>
<sum1:TipoFactura>F1</sum1:TipoFactura>
<sum1:DescripcionOperacion>Servicios de consultoría</sum1:DescripcionOperacion>
<sum1:Destinatarios>
<sum1:IDDestinatario>
<sum1:NombreRazon>Empresa Cliente SL</sum1:NombreRazon>
<sum1:NIF>A15022510</sum1:NIF>
</sum1:IDDestinatario>
</sum1:Destinatarios>
<sum1:Desglose>
<sum1:DetalleDesglose>
<sum1:ClaveRegimen>01</sum1:ClaveRegimen>
<sum1:CalificacionOperacion>S1</sum1:CalificacionOperacion>
<sum1:TipoImpositivo>21</sum1:TipoImpositivo>
<sum1:BaseImponibleOimporteNoSujeto>200.00</sum1:BaseImponibleOimporteNoSujeto>
<sum1:CuotaRepercutida>42.00</sum1:CuotaRepercutida>
</sum1:DetalleDesglose>
</sum1:Desglose>
<sum1:CuotaTotal>42.00</sum1:CuotaTotal>
<sum1:ImporteTotal>242.00</sum1:ImporteTotal>
<sum1:Encadenamiento>
<sum1:PrimerRegistro>S</sum1:PrimerRegistro>
</sum1:Encadenamiento>
<sum1:SistemaInformatico>
<sum1:NombreRazon>PRODUCTOR DEL SOFTWARE SL</sum1:NombreRazon>
<sum1:NIF>89890001K</sum1:NIF>
<sum1:NombreSistemaInformatico>MiFacturador</sum1:NombreSistemaInformatico>
<sum1:IdSistemaInformatico>MF</sum1:IdSistemaInformatico>
<sum1:Version>2.1.0</sum1:Version>
<sum1:NumeroInstalacion>0001</sum1:NumeroInstalacion>
<sum1:TipoUsoPosibleSoloVerifactu>S</sum1:TipoUsoPosibleSoloVerifactu>
<sum1:TipoUsoPosibleMultiOT>S</sum1:TipoUsoPosibleMultiOT>
<sum1:IndicadorMultiplesOT>S</sum1:IndicadorMultiplesOT>
</sum1:SistemaInformatico>
<sum1:FechaHoraHusoGenRegistro>2026-11-18T09:30:00+00:00</sum1:FechaHoraHusoGenRegistro>
<sum1:TipoHuella>01</sum1:TipoHuella>
<sum1:Huella>5F291F83D926980C021E9BD733B3588E6593D803A822C57E039E6F894DD0DCE1</sum1:Huella>
</sum1:RegistroAlta>
</sum:RegistroFactura>
</sum:RegFactuSistemaFacturacion>| Elemento | Qué contiene |
|---|---|
IDVersion | Versión del formato (1.0) |
IDFactura | IDEmisorFactura, NumSerieFactura y FechaExpedicionFactura |
RefExterna | Referencia propia (opcional) |
NombreRazonEmisor | Nombre o razón social del emisor |
Subsanacion · RechazoPrevio | Si el registro corrige uno anterior (opcionales) |
TipoFactura | F1, F2, F3, R1–R5 |
TipoRectificativa · FacturasRectificadas · FacturasSustituidas · ImporteRectificacion | Solo en rectificativas y sustitutivas |
FechaOperacion | Si la operación es de una fecha distinta de la de expedición (opcional) |
DescripcionOperacion | Descripción de la operación |
FacturaSimplificadaArt7273 · FacturaSinIdentifDestinatarioArt61d | Factura simplificada cualificada (art. 7.2 y 7.3) y factura sin identificación del destinatario (art. 6.1.d) del Reglamento de facturación (opcionales) |
Macrodato | Facturas de importe muy elevado (opcional) |
EmitidaPorTerceroODestinatario · Tercero | Facturas emitidas por un tercero o por el destinatario (opcionales) |
Destinatarios | IDDestinatario: NombreRazon y NIF o IDOtro (no en F2 ni R5) |
Cupon | Opcional |
Desglose | DetalleDesglose: impuesto, clave de régimen, calificación u operación exenta, tipo, base, cuota y recargo de equivalencia |
CuotaTotal · ImporteTotal | Suma de cuotas e importe total de la factura |
Encadenamiento | PrimerRegistro o RegistroAnterior |
SistemaInformatico | Identidad del sistema informático de facturación |
FechaHoraHusoGenRegistro | Fecha, hora y huso de generación del registro |
NumRegistroAcuerdoFacturacion · IdAcuerdoSistemaInformatico | Solo con acuerdos de facturación con la AEAT (opcionales) |
TipoHuella · Huella | 01 (SHA-256) y la huella del registro |
Registro de anulación
<sum:RegFactuSistemaFacturacion xmlns:sum="https://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/tike/cont/ws/SuministroLR.xsd" xmlns:sum1="https://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/tike/cont/ws/SuministroInformacion.xsd">
<sum:Cabecera>
<sum1:ObligadoEmision>
<sum1:NombreRazon>EMPRESA DE PRUEBA SL</sum1:NombreRazon>
<sum1:NIF>B12345674</sum1:NIF>
</sum1:ObligadoEmision>
</sum:Cabecera>
<sum:RegistroFactura>
<sum1:RegistroAnulacion>
<sum1:IDVersion>1.0</sum1:IDVersion>
<sum1:IDFactura>
<sum1:IDEmisorFacturaAnulada>B12345674</sum1:IDEmisorFacturaAnulada>
<sum1:NumSerieFacturaAnulada>A1</sum1:NumSerieFacturaAnulada>
<sum1:FechaExpedicionFacturaAnulada>18-11-2026</sum1:FechaExpedicionFacturaAnulada>
</sum1:IDFactura>
<sum1:RefExterna>66666666-7777-8888-9999-000000000000</sum1:RefExterna>
<sum1:Encadenamiento>
<sum1:RegistroAnterior>
<sum1:IDEmisorFactura>B12345674</sum1:IDEmisorFactura>
<sum1:NumSerieFactura>A1</sum1:NumSerieFactura>
<sum1:FechaExpedicionFactura>18-11-2026</sum1:FechaExpedicionFactura>
<sum1:Huella>5F291F83D926980C021E9BD733B3588E6593D803A822C57E039E6F894DD0DCE1</sum1:Huella>
</sum1:RegistroAnterior>
</sum1:Encadenamiento>
<sum1:SistemaInformatico>
<sum1:NombreRazon>PRODUCTOR DEL SOFTWARE SL</sum1:NombreRazon>
<sum1:NIF>89890001K</sum1:NIF>
<sum1:NombreSistemaInformatico>MiFacturador</sum1:NombreSistemaInformatico>
<sum1:IdSistemaInformatico>MF</sum1:IdSistemaInformatico>
<sum1:Version>2.1.0</sum1:Version>
<sum1:NumeroInstalacion>0001</sum1:NumeroInstalacion>
<sum1:TipoUsoPosibleSoloVerifactu>S</sum1:TipoUsoPosibleSoloVerifactu>
<sum1:TipoUsoPosibleMultiOT>S</sum1:TipoUsoPosibleMultiOT>
<sum1:IndicadorMultiplesOT>S</sum1:IndicadorMultiplesOT>
</sum1:SistemaInformatico>
<sum1:FechaHoraHusoGenRegistro>2026-11-18T09:31:00+00:00</sum1:FechaHoraHusoGenRegistro>
<sum1:TipoHuella>01</sum1:TipoHuella>
<sum1:Huella>CC9B545E52FBF2AB47B88C7280F2C79070A2A67342F8B6737DFC349FA79EC055</sum1:Huella>
</sum1:RegistroAnulacion>
</sum:RegistroFactura>
</sum:RegFactuSistemaFacturacion>| Elemento | Qué contiene |
|---|---|
IDVersion | Versión del formato (1.0) |
IDFactura | IDEmisorFacturaAnulada, NumSerieFacturaAnulada y FechaExpedicionFacturaAnulada |
RefExterna | Referencia propia (opcional) |
SinRegistroPrevio · RechazoPrevio | Si se anula una factura sin registro previo o tras un rechazo (opcionales) |
GeneradoPor · Generador | Quién genera la anulación, si no es el emisor (opcionales) |
Encadenamiento | PrimerRegistro o RegistroAnterior |
SistemaInformatico · FechaHoraHusoGenRegistro · TipoHuella · Huella | Igual que en el alta |
El bloque Encadenamiento
En el primer registro de un obligado, Encadenamiento lleva PrimerRegistro con valor S. A partir del segundo, lleva RegistroAnterior con el IDEmisorFactura, el NumSerieFactura, la FechaExpedicionFactura y la Huella del registro anterior, sea un alta o una anulación (como en el ejemplo de anulación de arriba). Cómo se calcula esa huella, en huella y encadenamiento.
Qué genera la API desde tu JSON
Con la API Verifactu envías JSON y Verifacti compone el XML. Esta es la correspondencia:
| Campo JSON de la API | Elemento del XML |
|---|---|
| NIF de la API key | IDEmisorFactura (y ObligadoEmision/NIF en la cabecera) |
serie + numero | NumSerieFactura (concatenados, máximo 60 caracteres) |
fecha_expedicion | FechaExpedicionFactura |
fecha_operacion | FechaOperacion |
tipo_factura | TipoFactura |
tipo_rectificativa, facturas_rectificadas, facturas_sustituidas, importe_rectificativa | TipoRectificativa, FacturasRectificadas, FacturasSustituidas, ImporteRectificacion |
descripcion | DescripcionOperacion |
nif o id_otro, y nombre | Destinatarios/IDDestinatario |
lineas[] | Desglose/DetalleDesglose (una por línea) |
| Suma de las cuotas de las líneas | CuotaTotal |
importe_total | ImporteTotal |
uuid del registro | RefExterna |
| Lo calcula Verifacti | Encadenamiento, FechaHoraHusoGenRegistro, TipoHuella, Huella |
sistema_informatico (opcional, identidad del integrador) | SistemaInformatico |
Caracteres especiales
Los valores se escriben en el XML escapados (& como &, < como <), pero la huella y la URL del QR se calculan sobre el valor sin escapar, que es lo que registra la AEAT. Por eso la API rechaza una serie o un numero que ya contengan entidades escapadas (vf-verifactu-serie_numero_entidad): envía el texto tal cual.
Cómo ver el XML que se ha enviado
Descarga el XML de una factura con POST /verifactu/downloadXML (por serie y numero; devuelve la petición y la respuesta tal como se enviaron a la AEAT, con su sobre SOAP) o exporta los de un periodo con POST /verifactu/export (por ejercicio y periodo; devuelve hasta 500 URLs válidas 15 minutos y un token para pedir las siguientes). Como la AEAT recibe los registros por lotes, el XML puede incluir registros de otras facturas. Con el NIF de prueba de la cuenta gratuita puedes usar downloadXML; export solo funciona con tus propios NIFs. En el entorno de test, los XML se guardan un máximo de 90 días.
curl -X POST https://api.verifacti.com/verifactu/downloadXML \
-H "Authorization: Bearer $VERIFACTI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"serie": "A", "numero": "1"}'curl -X POST https://api.verifacti.com/verifactu/export \
-H "Authorization: Bearer $VERIFACTI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ejercicio": "2026", "periodo": "11"}'Validar un XML
Si generas el XML tú mismo, valídalo contra los esquemas XSD de la AEAT (por ejemplo, con xmllint --schema SuministroLR.xsd) o con el validador de XML de Verifactu. El XSD comprueba la estructura; las reglas de negocio están en el documento de validaciones y errores de la AEAT (v1.2.2). Para ver el JSON de cada caso, mira los ejemplos de Verifactu.
Errores de estructura frecuentes
| Código | Causa | Solución |
|---|---|---|
vf-verifactu-importe_total_cuadre | importe_total no cuadra (margen de 10 €) con la suma de base_imponible, cuota_repercutida y cuota_recargo_equivalencia de las líneas | Recalcula el total |
vf-verifactu-serie_numero_entidad | serie o numero con entidades XML ya escapadas | Envía el texto sin escapar |
vf-verifactu-fecha_expedicion_hoy | fecha_expedicion no es la fecha actual (entorno de test) | Envía la fecha de hoy en formato DD-MM-AAAA |
vf-verifactu-nif_formato | El NIF del destinatario no tiene un formato válido | Revisa el NIF; para extranjeros, usa id_otro |
El resto de códigos, en errores de Verifactu.
Siguiente paso
Con la API Verifactu no compones el XML: envías JSON y Verifacti genera el registro, lo encadena y lo envía a la AEAT. Empieza con la guía rápida o la documentación.
Otros tutoriales de Verifactu
Preguntas sobre el XML de Verifactu
Más preguntas sobre la API Verifactu¿Dónde están los XSD de Verifactu?
SuministroLR.xsd y SuministroInformacion.xsd para el envío, y RespuestaSuministro.xsd para la respuesta.¿Un registro de facturación es la factura?
¿Tengo que firmar el XML?
¿Puedo ver el XML que ha generado la API?
POST /verifactu/downloadXML (una factura) o POST /verifactu/export (un periodo).¿Dónde veo el JSON de una factura rectificativa?
Envía JSON y deja el XML a la API
Prueba con la cuenta gratuita y descarga el XML que genera.