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

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.

Estructura del envío
RegFactuSistemaFacturacion
├── Cabecera
│   ├── ObligadoEmision              NombreRazon y NIF
│   ├── Representante                (opcional)
│   ├── RemisionVoluntaria           (opcional) FechaFinVeriFactu, Incidencia
│   └── RemisionRequerimiento        (opcional)
└── RegistroFactura                  (uno o varios, hasta 1.000)
    └── RegistroAlta  o  RegistroAnulacion

Registro 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.

RegistroAlta · F1
<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>
Elementos del registro de alta de Verifactu, en el orden del XSD
ElementoQué contiene
IDVersionVersión del formato (1.0)
IDFacturaIDEmisorFactura, NumSerieFactura y FechaExpedicionFactura
RefExternaReferencia propia (opcional)
NombreRazonEmisorNombre o razón social del emisor
Subsanacion · RechazoPrevioSi el registro corrige uno anterior (opcionales)
TipoFacturaF1, F2, F3, R1–R5
TipoRectificativa · FacturasRectificadas · FacturasSustituidas · ImporteRectificacionSolo en rectificativas y sustitutivas
FechaOperacionSi la operación es de una fecha distinta de la de expedición (opcional)
DescripcionOperacionDescripción de la operación
FacturaSimplificadaArt7273 · FacturaSinIdentifDestinatarioArt61dFactura 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)
MacrodatoFacturas de importe muy elevado (opcional)
EmitidaPorTerceroODestinatario · TerceroFacturas emitidas por un tercero o por el destinatario (opcionales)
DestinatariosIDDestinatario: NombreRazon y NIF o IDOtro (no en F2 ni R5)
CuponOpcional
DesgloseDetalleDesglose: impuesto, clave de régimen, calificación u operación exenta, tipo, base, cuota y recargo de equivalencia
CuotaTotal · ImporteTotalSuma de cuotas e importe total de la factura
EncadenamientoPrimerRegistro o RegistroAnterior
SistemaInformaticoIdentidad del sistema informático de facturación
FechaHoraHusoGenRegistroFecha, hora y huso de generación del registro
NumRegistroAcuerdoFacturacion · IdAcuerdoSistemaInformaticoSolo con acuerdos de facturación con la AEAT (opcionales)
TipoHuella · Huella01 (SHA-256) y la huella del registro

Registro de anulación

RegistroAnulacion de la factura anterior
<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>
Elementos del registro de anulación de Verifactu, en el orden del XSD
ElementoQué contiene
IDVersionVersión del formato (1.0)
IDFacturaIDEmisorFacturaAnulada, NumSerieFacturaAnulada y FechaExpedicionFacturaAnulada
RefExternaReferencia propia (opcional)
SinRegistroPrevio · RechazoPrevioSi se anula una factura sin registro previo o tras un rechazo (opcionales)
GeneradoPor · GeneradorQuién genera la anulación, si no es el emisor (opcionales)
EncadenamientoPrimerRegistro o RegistroAnterior
SistemaInformatico · FechaHoraHusoGenRegistro · TipoHuella · HuellaIgual 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:

Correspondencia entre el JSON de la API Verifactu y el registro de facturación
Campo JSON de la APIElemento del XML
NIF de la API keyIDEmisorFactura (y ObligadoEmision/NIF en la cabecera)
serie + numeroNumSerieFactura (concatenados, máximo 60 caracteres)
fecha_expedicionFechaExpedicionFactura
fecha_operacionFechaOperacion
tipo_facturaTipoFactura
tipo_rectificativa, facturas_rectificadas, facturas_sustituidas, importe_rectificativaTipoRectificativa, FacturasRectificadas, FacturasSustituidas, ImporteRectificacion
descripcionDescripcionOperacion
nif o id_otro, y nombreDestinatarios/IDDestinatario
lineas[]Desglose/DetalleDesglose (una por línea)
Suma de las cuotas de las líneasCuotaTotal
importe_totalImporteTotal
uuid del registroRefExterna
Lo calcula VerifactiEncadenamiento, FechaHoraHusoGenRegistro, TipoHuella, Huella
sistema_informatico (opcional, identidad del integrador)SistemaInformatico

Caracteres especiales

Los valores se escriben en el XML escapados (& como &amp;, < como &lt;), 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.

Descargar el XML de una factura · cURL
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"}'
Exportar los XML de un periodo · cURL
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

Errores de la API Verifactu ligados al contenido del XML
CódigoCausaSolución
vf-verifactu-importe_total_cuadreimporte_total no cuadra (margen de 10 €) con la suma de base_imponible, cuota_repercutida y cuota_recargo_equivalencia de las líneasRecalcula el total
vf-verifactu-serie_numero_entidadserie o numero con entidades XML ya escapadasEnvía el texto sin escapar
vf-verifactu-fecha_expedicion_hoyfecha_expedicion no es la fecha actual (entorno de test)Envía la fecha de hoy en formato DD-MM-AAAA
vf-verifactu-nif_formatoEl NIF del destinatario no tiene un formato válidoRevisa 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.

Entorno de test y NIF de prueba incluidos

Preguntas sobre el XML de Verifactu

Más preguntas sobre la API Verifactu

¿Dónde están los XSD de Verifactu?

En el portal de desarrolladores de la AEAT: SuministroLR.xsd y SuministroInformacion.xsd para el envío, y RespuestaSuministro.xsd para la respuesta.

¿Un registro de facturación es la factura?

No. Es el XML que acompaña a cada factura. Una factura puede tener varios registros: alta, subsanación y anulación.

¿Tengo que firmar el XML?

En la modalidad VERI*FACTU no se firma cada registro: el envío a la AEAT se hace con una llamada autenticada con certificado electrónico. Con la API Verifactu no necesitas certificado: Verifacti envía como colaborador social de la AEAT.

¿Puedo ver el XML que ha generado la API?

Sí, con POST /verifactu/downloadXML (una factura) o POST /verifactu/export (un periodo).

¿Dónde veo el JSON de una factura rectificativa?

En el ejemplo de factura rectificativa; la tabla de arriba dice a qué elementos del XML va cada campo.

Envía JSON y deja el XML a la API

Prueba con la cuenta gratuita y descarga el XML que genera.

Entorno de test y NIF de prueba incluidosLee la documentación