7 min de lectura
Equip Fakturia

Facturae 3.2: camps obligatoris de l'XML amb exemple real

Estructura del fitxer XML Facturae 3.2: capçalera, parts, factura i signatura, amb taula de camps obligatoris i un exemple de 1.000 €.

Un fitxer Facturae 3.2 és un document XML amb quatre blocs. FileHeader recull la versió, la modalitat i el tipus d'emissor. Parties identifica fiscalment l'emissor i el receptor. Invoices conté cada factura amb la seva capçalera, dates, impostos, totals i línies. Tanca el fitxer la signatura electrònica XAdES. Si hi falta algun dels camps obligatoris, el validador rebutja el fitxer.

Els quatre blocs de l'XML de Facturae i el seu ordre

L'element arrel es diu Facturae i conté, sempre en aquest ordre, FileHeader, Parties, Invoices i la signatura (ds:Signature). L'esquema XSD és estricte amb l'ordre: un bloc desplaçat invalida el document encara que totes les dades siguin correctes.

  1. FileHeader: descriu el fitxer en conjunt, no cada factura. Indica la versió de l'esquema, si conté una factura o un lot i qui l'emet.
  2. Parties: identifica el venedor (SellerParty) i el comprador (BuyerParty) amb el seu NIF, el nom o raó social i l'adreça.
  3. Invoices: agrupa una o diverses factures (Invoice). Cadascuna porta les seves pròpies dades de capçalera, impostos, totals i línies de detall.
  4. Signatura XAdES: signatura electrònica avançada sobre tot el document. Acredita qui l'emet i que no s'ha alterat.

Les etiquetes són en anglès tot i que el format sigui espanyol. Els imports fan servir el punt com a separador decimal i no porten separador de milers.

Dades requerides a FileHeader i Parties d'un XML de Facturae

La capçalera del fitxer i les parts són el primer que comprova qualsevol validador. La taula resumeix els elements imprescindibles i l'error més habitual en cadascun.

ElementQuè contéError típic
SchemaVersionVersió de l'esquema utilitzadaNo coincideix amb l'espai de noms de l'XML
ModalityI (individual) o L (lot)Marcar I amb diverses factures a dins
InvoiceIssuerTypeEM emissor, RE receptor o TE tercerUsar TE sense emplenar el bloc ThirdParty
BatchIdentificador del lot, nombre de factures i totalsTotals del lot diferents de la suma de factures
TaxIdentificationTipus de persona (F o J), residència i NIFNIF amb espais o guions
LegalEntity o IndividualRaó social, o nom i cognomsUsar LegalEntity per a un autònom
AddressInSpainAdreça, codi postal, municipi, província i paísCodi postal incomplet o província buida

El BatchIdentifier es forma concatenant el NIF de l'emissor amb el número i la sèrie de la primera factura. Si el destinatari és una Administració pública, el comprador porta a més el bloc AdministrativeCentres amb els codis DIR3 de l'oficina comptable, l'òrgan gestor i la unitat tramitadora.

Subblocs de cada factura dins d'Invoices, pas a pas

Cada Invoice es construeix amb els subblocs següents. Tots són imprescindibles excepte TaxesWithheld, que depèn de l'operació, i PaymentDetails.

  1. InvoiceHeader: inclou el número (InvoiceNumber), la sèrie si n'hi ha, el tipus de document (FC completa, FA simplificada, AF autofactura) i la classe (OO original, OR rectificativa). Una rectificativa exigeix el bloc Corrective amb la factura corregida i el motiu.
  2. InvoiceIssueData: data d'expedició, moneda de la factura, moneda de l'impost i idioma.
  3. TaxesOutputs: impostos repercutits, amb tipus d'impost, percentatge, base i quota. A Espanya l'IVA pot ser general del 21 %, reduït del 10 % o superreduït del 4 %.
  4. TaxesWithheld: retencions, com l'IRPF que practica l'empresa que paga un professional.
  5. InvoiceTotals: import brut, base abans d'impostos, total d'impostos, total de retencions, total de la factura i import a pagar.
  6. Items: línies de detall amb descripció, quantitat, preu unitari sense impostos, import brut i impostos de cada línia.
  7. PaymentDetails: venciment, import, mitjà de pagament i compte (IBAN). No sempre és obligatori, però facilita conciliar el cobrament.

El tipus FA (simplificada) només val dins dels límits de l'article 4 del Reial decret 1619/2012: fins a 400 € IVA inclòs, o fins a 3.000 € en determinats sectors minoristes.

Exemple de factura de 1.000 € amb IVA i IRPF a l'XML

Un professional factura 1.000 € d'honoraris a una empresa, amb IVA del 21 % i retenció d'IRPF del 15 %. La taula mostra com es reparteixen els imports entre els camps del fitxer.

Concepte de la facturaCàlculImportCamp a l'XML
Base imposablehonoraris del servei1.000,00 €TotalGrossAmountBeforeTaxes
IVA (21 %)1.000,00 € × 21 %210,00 €TotalTaxOutputs
Retenció IRPF (15 %)1.000,00 € × 15 %−150,00 €TotalTaxesWithheld
Total factura (base + IVA)1.000,00 € + 210,00 €1.210,00 €Sense camp propi: base més quotes
Import a cobrartotal − retenció1.060,00 €InvoiceTotal i TotalExecutableAmount

Dos detalls eviten rebuigs. El primer: TotalTaxesWithheld s'escriu en positiu (150.00), perquè el mateix esquema el resta. El segon: InvoiceTotal és la base més l'IVA menys la retenció, no el total amb IVA.

Si el client és un particular, la factura no porta retenció. En aquest cas desapareix el bloc TaxesWithheld i TotalTaxesWithheld queda a 0.00. Per quadrar les xifres abans de generar el fitxer, pots fer servir la calculadora de factura amb IVA.

Signatura XAdES, validació i ús del format en la factura electrònica B2B

La signatura XAdES va dins del mateix XML i es genera amb un certificat electrònic de l'emissor o de qui signa en nom seu. Qualsevol canvi posterior, encara que sigui un espai, trenca la signatura. Per això convé validar el fitxer ja signat, no l'esborrany.

Entre empreses, la Llei 18/2022 (Ley Crea y Crece), el Reial decret 238/2026 i l'Orden HAC/1028/2026 fixen dos terminis:

  • 6 d'octubre de 2027, per a qui va superar 8 milions d'euros de volum d'operacions l'any anterior.
  • 6 d'octubre de 2028, per a la resta d'empresaris i professionals, autònoms inclosos.

Facturae és un dels formats admesos entre plataformes, com a model EN 16931, al costat d'UBL, CII i EDIFACT. La solució pública de l'AEAT treballa en UBL. Qui emeti per una plataforma privada li ha d'enviar alhora una còpia fidel en UBL. Tens la resta d'obligacions a la guia de factura electrònica.

Aquesta obligació no és VeriFactu. La factura electrònica regula el format i l'intercanvi entre empreses. VeriFactu regula el programa que genera els registres de facturació i els remet a l'AEAT.

Preguntes freqüents

Quina diferència hi ha entre Facturae i UBL?

Facturae i UBL són dos formats XML de factura electrònica admesos entre plataformes a Espanya. Facturae és el format espanyol, amb etiquetes pròpies i signatura XAdES. UBL és un estàndard internacional i és el format que fa servir la solució pública de l'AEAT, que exigeix una còpia fidel en UBL.

Una factura en format Facturae ha d'anar signada?

Una factura en format Facturae inclou la signatura electrònica XAdES com a últim bloc de l'XML. Aquesta signatura acredita la identitat de l'emissor i garanteix que el contingut no s'ha modificat. Qualsevol canvi posterior a la signatura invalida el fitxer, així que la validació s'ha de fer sobre l'XML ja signat.

Com s'indica la retenció d'IRPF en un XML de Facturae?

La retenció d'IRPF en un XML de Facturae es declara al bloc TaxesWithheld, amb el seu percentatge, base i quota. Els percentatges habituals són el 15 % o el 7 % per a nous autònoms. El total retingut figura en positiu a TotalTaxesWithheld i es resta per obtenir InvoiceTotal.

Serveix Facturae 3.2 per a la factura electrònica obligatòria entre empreses?

Facturae 3.2 serveix com a format d'intercanvi entre plataformes en la factura electrònica B2B, perquè s'admet com a model EN 16931. Qui emeti per una plataforma privada ha d'enviar també una còpia fidel en UBL a la solució pública de l'AEAT. Per a la majoria d'autònoms, el termini és el 6 d'octubre de 2028.

Si vols saber com t'afecten aquestes obligacions i en quina data, fes el diagnòstic gratuït de risc VeriFactu de Fakturia: en 2 minuts tindràs una visió clara de la teva situació.

Compartir X LinkedIn
Newsletter

No et vols perdre res?

Rep les últimes novetats fiscals directament al teu correu.

Sense spam. Només l'essencial.
← Tornar a novetatsMés sobre Facturació electrònica →