FacturaE XML: estructura, campos obligatorios y cómo interpretarlo
El FacturaE XML es el formato estándar oficial en España para la expedición de facturas electrónicas estructuradas en el ámbito público y privado. Utiliza el lenguaje XML (Extensible Markup Language) e integra firma electrónica XAdES para garantizar la autenticidad del origen y la integridad del contenido de cada documento comercial.
En esta guía analizamos la jerarquía del esquema FacturaE 3.2.2, los nodos obligatorios que exige la Agencia Estatal de Administración Tributaria (AEAT) y los pasos clave para diagnosticar y corregir errores de validación sin complicaciones.
En resumen
Definición oficial: FacturaE XML es el formato estructurado legalmente reconocido en España para el intercambio digital de facturas entre empresas y administraciones.
Estructura jerárquica: El documento se divide en cuatro nodos principales:
<FileHeader>,<Parties>,<Invoices>y<ds:Signature>.Versión vigente: La versión 3.2.2 es la exigida en los puntos generales de entrada como FACe y las plataformas públicas de facturación.
Validez legal: La firma electrónica avanzada XAdES incrustada en el nodo
<ds:Signature>otorga valor probatorio pleno ante la AEAT.Validación automatizada: Los errores de validación suelen deberse a descuadres numéricos, formatos de NIF incorrectos o certificados caducados.
¿Qué es el formato FacturaE XML y para qué sirve?
El formato FacturaE XML es un estándar técnico abierto y legible por ordenador que define la estructura digital de las facturas electrónicas en España. Este esquema permite codificar de forma unificada los datos del emisor, del receptor, los conceptos facturados, los impuestos aplicados y la firma digital. Gracias a este modelo estandarizado, distintos programas de gestión pueden emitir y procesar facturas automáticamente sin depender de documentos en PDF o formatos propietarios.
El desarrollo de FacturaE está coordinado por el Ministerio de Asuntos Económicos y Transformación Digital junto con el Ministerio de Hacienda. Aunque surgió inicialmente para regular las relaciones B2G (empresa a Administración Pública), la implantación progresiva de la factura electrónica entre empresas ha consolidado al XML FacturaE como el contenedor principal de datos contables y fiscales.
A diferencia de un archivo PDF convencional, un documento XML contiene etiquetas de marcado legibles que identifican cada dato sin ambigüedad. De este modo, las plataformas de facturación electrónica verifican instantáneamente la validez del NIF, el cálculo del IVA y la integridad de la firma antes de registrar la operación.
Estructura y bloques principales del esquema FacturaE 3.2.2
La estructura del esquema FacturaE 3.2.2 se organiza mediante una jerarquía estricta encuadrada bajo la etiqueta raíz <fe:Facturae>. Esta arquitectura garantiza que la información administrativa, fiscal y criptográfica guarde un orden predecible para los sistemas informáticos de validación.
A continuación, se describen los cuatro bloques fundamentales que componen todo archivo FacturaE XML válido:
| Bloque XML | Contenido principal | Función técnica |
<FileHeader> | Versión del esquema, modalidad de lote y emisor del archivo | Define los metadatos generales del archivo y el tipo de envío. |
<Parties> | Identificación de vendedor (SellerParty) y comprador (BuyerParty) | Recoge NIF, razón social, domicilio fiscal y datos de contacto. |
<Invoices> | Serie, número, fechas, líneas de detalle, impuestos y totales | Agrupa el contenido comercial, desglose de IVA y sumatorios. |
<ds:Signature> | Firma electrónica XAdES, certificado digital y sello de tiempo | Garantiza el no repudio, la autenticidad y la inmutabilidad. |
1. Cabecera del fichero (FileHeader)
En el nodo <FileHeader> se especifican los metadatos globales del archivo XML. Aquí se declara la versión del esquema (que debe indicar 3.2.2), el emisor del fichero informático y si la entrega corresponde a una única factura o a un lote agrupado. Un fallo en este nodo provoca el rechazo inmediato del archivo antes de revisar los datos fiscales.
2. Partes intervinientes (Parties)
El apartado <Parties> identifica fehacientemente a las dos entidades de la transacción comercial. Dentro de <SellerParty> se consignan los datos fiscales de quien emite la factura, mientras que <BuyerParty> alberga los del destinatario. Es imprescindible incluir el NIF con su código de país correspondiente (ES), la razón social completa y el domicilio fiscal de ambas partes.
3. Detalle de facturas (Invoices)
El nodo <Invoices> constituye el núcleo operativo del documento. Contiene una o varias subsecciones <Invoice>, donde se desglosan la serie y número de factura (<InvoiceNumber>), la fecha de expedición (<IssueDate>), las líneas de concepto con sus importes unitarios, las retenciones y la cuota de IVA en <TaxesOutputs>. Los importes finales se resumen en el elemento <InvoiceTotals>.
4. Firma electrónica (ds:Signature)
Ubicado al final del archivo, el bloque <ds:Signature> almacena la firma digital incrustada en formato XAdES. Este nodo contiene el certificado del emisor, las huellas digitales cifradas del contenido del XML y, opcionalmente, la fecha del sellado de tiempo. Si se altera un solo carácter del XML tras ser firmado, esta sección detectará la modificación e invalidará el archivo.
Campos obligatorios en un archivo FacturaE XML
Los campos obligatorios en un FacturaE XML son aquellos elementos informativos mínimos declarados indispensables por la Orden HAP/1650/2015 para que el documento tenga validez fiscal y administrativa. La ausencia o el formato erróneo de cualquiera de estos datos causa el rechazo automático en la validación del esquema XSD.
Para garantizar una lectura correcta, debes comprobar que el archivo incluya los siguientes campos fundamentales:
Identificadores fiscales: NIF/CIF del emisor en
<SellerParty>y del receptor en<BuyerParty>, acompañados del tipo de persona (física o jurídica).Numeración y serie: Número único de factura (
<InvoiceNumber>) y código de serie (<InvoiceSeriesCode>) dentro de la cabecera del documento.Fecha de expedición: Formato ISO de fecha (
YYYY-MM-DD) registrado en el nodo<IssueDate>.Desglose impositivo: Base imponible (
<TaxableBase>), tipo impositivo aplicado (<TaxRate>) y cuota tributaria (<TotalAmount>) dentro de<TaxesOutputs>.Totales de la factura: Importe total ejecutable (
<TotalExecutableAmount>) e importe total de la factura (<InvoiceTotal>) en el bloque de totales.Órganos gestores (facturación B2G): Códigos DIR3 de Oficina Contable, Órgano Gestor y Unidad Tramitadora para entregas dirigidas a administraciones públicas mediante FACeB2B y puntos de entrada oficiales.
La firma electrónica XAdES en el formato FacturaE
La firma electrónica en FacturaE es el mecanismo criptográfico obligatorio que garantiza la autenticidad de origen y la integridad del contenido del documento XML, de conformidad con el Reglamento (UE) Nº 910/2014 (eIDAS).
El estándar FacturaE requiere el uso de firmas XAdES (XML Advanced Electronic Signatures). Existen distintos niveles de firma según las necesidades de conservación y el entorno de tramitación:
XAdES-BES: Nivel básico de firma avanzada que incluye el certificado digital y el resumen criptográfico del archivo.
XAdES-EPES: Añade una política de firma explícita, siendo el formato más extendido para cumplir la normativa tributaria española.
XAdES-T: Incorpora un sello de tiempo (timestamp) de una autoridad de sellado cualificada que prueba el momento exacto de emisión.
XAdES-XL: Añade información sobre la validación del estado del certificado (listas de revocación CRL o protocolo OCSP) para asegurar la conservación a largo plazo.
Si deseas profundizar en la validez jurídica de cada modalidad de certificado, puedes consultar nuestra guía sobre la firma electrónica en facturas.
¿Cómo validar un archivo FacturaE XML y resolver errores habituales?
Validar un archivo FacturaE XML consiste en verificar que el documento cumple estrictamente el esquema oficial XSD 3.2.2, que la firma criptográfica es matemática y jurídicamente correcta, y que los cálculos numéricos cuadran sin desviaciones por redondeo.
Para diagnosticar y subsanar cualquier fallo de validación, sigue estos pasos estructurados:
Verificar la sintaxis frente al esquema XSD: Carga el archivo en un validador oficial para confirmar que los nodos XML están ordenados y no faltan etiquetas obligatorias.
Comprobar la validez del certificado digital: Asegúrate de que el certificado utilizado para firmar el nodo
<ds:Signature>no haya caducado ni haya sido revocado por la autoridad emisora.Revisar la coherencia de los importes: Comprueba que la suma de la base imponible y la cuota de IVA coincida exactamente con el total de la factura, utilizando un máximo de dos decimales para los importes finales.
Validar la codificación de caracteres: Guarda el archivo siempre en formato UTF-8 sin BOM para evitar errores de lectura de caracteres especiales o tildes.
Confirmar los códigos administrativos DIR3: En facturación hacia el sector público, comprueba que los códigos de tres letras y dígitos de los órganos gestores estén vigentes en el directorio común DIR3.
¿Cómo te ayuda el programa de facturación electrónica de elEquipoIA con el formato FacturaE XML?
El programa de facturación electrónica de elEquipoIA automatiza por completo la generación, firma y validación de archivos en esquema FacturaE 3.2.2. Nuestra plataforma elimina la necesidad de editar etiquetas XML manualmente o gestionar firmas complejas desde aplicaciones externas.
Desde la interfaz de elEquipoIA, puedes emitir facturas electrónicas que se convierten al instante al formato estructurado FacturaE XML firmado con certificado XAdES. El programa valida automáticamente la coherencia de las bases imponibles, verifica la corrección del NIF y conecta directamente con FACe, FACeB2B y los portales autonómicos para realizar el envío telemático.
Además, el sistema integra el módulo de trazabilidad fiscal y los requisitos de inmutabilidad exigidos por la normativa tributaria, garantizando que cada factura expedida quede perfectamente archivada y custodiada. Para conocer en detalle todas las opciones de integración y envío telemático, puedes consultar las características de nuestro plugin de FacturaE y FACe.
Preguntas frecuentes sobre FacturaE XML
¿Es obligatoria la versión FacturaE 3.2.2 para enviar facturas a la Administración Pública?
Sí, la versión FacturaE 3.2.2 es la exigida con carácter general por la Orden HAP/1650/2015 en el punto general de entrada FACe y en la práctica totalidad de las plataformas autonómicas y locales de España. Las versiones anteriores como la 3.2.0 o 3.2.1 no son aceptadas por los validadores actuales.
¿Puedo abrir y leer un archivo FacturaE XML con un bloc de notas convencional?
Sí, al tratarse de un archivo de texto plano estructurado, puedes abrir un archivo XML con cualquier editor de texto o navegador web. Sin embargo, para interpretarlo cómodamente se recomienda utilizar visores FacturaE o programas de facturación electrónica que traduzcan las etiquetas en una plantilla visual legible.
¿Qué ocurre si modifico una cifra en un archivo FacturaE XML ya firmado?
Cualquier alteración en el texto o los importes del archivo rompe la correspondencia del resumen criptográfico guardado en la firma XAdES. Como consecuencia, la firma electrónica quedará inmediatamente invalidada y los validadores oficiales rechazarán el documento por alteración de datos.
¿Qué diferencia existe entre el formato FacturaE XML y un sistema Verifactu?
FacturaE XML es un formato estandarizado para la estructuración y firma del documento comercial que se envía al cliente o a la Administración. Por su parte, Verifactu y la factura electrónica hacen referencia al envío automático de los registros de facturación a la AEAT con encadenamiento de datos y código QR para el control de la integridad fiscal.
¿Se pueden incluir anexos en PDF dentro de un archivo FacturaE XML?
Sí, el esquema FacturaE permite adjuntar documentos complementarios (como partes de trabajo o certificaciones) incrustando el archivo PDF codificado en formato Base64 dentro del propio nodo XML.
Normativa y fuentes
Orden HAP/1650/2015: Por la que se modifican las Órdenes PRE/2971/2007 y HAP/1074/2014, reguladoras del esquema FacturaE. Disponible en la sede del Boletín Oficial del Estado (BOE).
Ley 25/2013: De impulso de la factura electrónica y creación del registro contable de facturas en el Sector Público. Consultable en el portal oficial del Ministerio de Hacienda.
Esquema FacturaE y documentación técnica: Especificaciones completas del formato y validadores oficiales alojados en Facturae.es.
¿Necesitas ayuda para implantar FacturaE XML en tu empresa?
En elEquipoIA somos especialistas en facturación electrónica y acompañamos a pymes, autónomos y asesorías en la adaptación técnica a la normativa vigente. Te asesoramos durante todo el proceso de implantación y configuramos la generación automática de archivos FacturaE 3.2.2 completamente integrados con tu gestión diaria.
Si quieres simplificar la emisión de facturas electrónicas, evitar errores de validación y automatizar tus envíos a la Administración y a tus clientes privados, ponte en contacto con nosotros para solicitar una demostración personalizada del programa de facturación electrónica de elEquipoIA.
