Descarregar l'XML de FacturaE

Retorna en streaming el XML FacturaE 3.2.2 de la factura (compliment B2G), conforme a XSD amb el desglossament d'impostos complet.

Amb un certificat de signatura actiu el cos es signa XAdES-EPES i es serveix com a .xsig; sense ell es retorna sense signar com a .xml.
La capçalera X-Facturae-Signed distingeix tots dos.
Les factures en esborrany retornen 422.

Fixa la versió de l'API (YYYY-MM-DD, versionat per data estil Stripe) per a aquesta petició; omet-lo per usar la versió fixada de la clau, o l'última si no n'hi ha cap. Versió no suportada → 400 unsupported_api_version; mal formada → 400 parameter_invalid_format. La versió efectiva es reflecteix a la capçalera de resposta Factuarea-Version. Consulta la guia de Versioning.

Formatdate

X-Active-Profile?string

Opera en nom d'una empresa filla (API key mestra de gestoria): passa el seu id públic (UUID v7) i la petició s'executa contra les dades d'aquella filla sense canviar l'scope, el tier ni l'environment de la clau (omet-lo per usar la pròpia empresa de la clau). UUID no vàlid → 400 parameter_invalid_uuid; id desconegut o no propi → 404 profile_not_found. Consulta la guia d'Acting on behalf.

Formatuuid

Cos de la resposta

`application/xml`

`application/json`

Exemple de petició

const apiKey = process.env.FACTUAREA_API_KEY;if (!apiKey) throw new Error("Set FACTUAREA_API_KEY");const response = await fetch("https://api.factuarea.com/v1/invoices/01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01/facturae", {  method: "GET",  headers: { Authorization: `Bearer ${apiKey}`, ...{"Accept":"application/xml"} },});if (!response.ok) throw new Error(await response.text());await (await import("node:fs/promises")).writeFile("response.bin", new Uint8Array(await response.arrayBuffer()));

Exemple de resposta

HTTP/1.1 200
Content-Type: application/xml
Content-Disposition: attachment; filename="FAC-2026-00042.xml"
X-Facturae-Signed: false

<?xml version="1.0" encoding="UTF-8"?>
<fe:Facturae xmlns:fe="http://www.facturae.gob.es/formato/Versiones/Facturaev3_2_2.xml"><FileHeader><SchemaVersion>3.2.2</SchemaVersion><Modality>I</Modality><InvoiceIssuerType>EM</InvoiceIssuerType><Batch><BatchIdentifier>B12345674FAC-2026-00042FAC</BatchIdentifier><InvoicesCount>1</InvoicesCount><TotalInvoicesAmount><TotalAmount>1210.00</TotalAmount></TotalInvoicesAmount><TotalOutstandingAmount><TotalAmount>1210.00</TotalAmount></TotalOutstandingAmount><TotalExecutableAmount><TotalAmount>1210.00</TotalAmount></TotalExecutableAmount><InvoiceCurrencyCode>EUR</InvoiceCurrencyCode></Batch></FileHeader><Parties><SellerParty><TaxIdentification><PersonTypeCode>J</PersonTypeCode><ResidenceTypeCode>R</ResidenceTypeCode><TaxIdentificationNumber>B12345674</TaxIdentificationNumber></TaxIdentification><LegalEntity><CorporateName>Servicios Ejemplo SL</CorporateName><AddressInSpain><Address>Calle Mayor 1</Address><PostCode>28001</PostCode><Town>Madrid</Town><Province>Madrid</Province><CountryCode>ESP</CountryCode></AddressInSpain></LegalEntity></SellerParty><BuyerParty><TaxIdentification><PersonTypeCode>J</PersonTypeCode><ResidenceTypeCode>R</ResidenceTypeCode><TaxIdentificationNumber>S2826011E</TaxIdentificationNumber></TaxIdentification><AdministrativeCentres><AdministrativeCentre><CentreCode>L01280796</CentreCode><RoleTypeCode>01</RoleTypeCode><Name>Oficina Contable</Name><AddressInSpain><Address>Paseo de la Castellana 1</Address><PostCode>28071</PostCode><Town>Madrid</Town><Province>Madrid</Province><CountryCode>ESP</CountryCode></AddressInSpain></AdministrativeCentre><AdministrativeCentre><CentreCode>L01280796</CentreCode><RoleTypeCode>02</RoleTypeCode><Name>Órgano Gestor</Name><AddressInSpain><Address>Paseo de la Castellana 1</Address><PostCode>28071</PostCode><Town>Madrid</Town><Province>Madrid</Province><CountryCode>ESP</CountryCode></AddressInSpain></AdministrativeCentre><AdministrativeCentre><CentreCode>L01280796</CentreCode><RoleTypeCode>03</RoleTypeCode><Name>Unidad Tramitadora</Name><AddressInSpain><Address>Paseo de la Castellana 1</Address><PostCode>28071</PostCode><Town>Madrid</Town><Province>Madrid</Province><CountryCode>ESP</CountryCode></AddressInSpain></AdministrativeCentre></AdministrativeCentres><LegalEntity><CorporateName>Administración de ejemplo</CorporateName><AddressInSpain><Address>Paseo de la Castellana 1</Address><PostCode>28071</PostCode><Town>Madrid</Town><Province>Madrid</Province><CountryCode>ESP</CountryCode></AddressInSpain></LegalEntity></BuyerParty></Parties><Invoices><Invoice><InvoiceHeader><InvoiceNumber>FAC-2026-00042</InvoiceNumber><InvoiceSeriesCode>FAC</InvoiceSeriesCode><InvoiceDocumentType>FC</InvoiceDocumentType><InvoiceClass>OO</InvoiceClass></InvoiceHeader><InvoiceIssueData><IssueDate>2026-03-15</IssueDate><InvoiceCurrencyCode>EUR</InvoiceCurrencyCode><TaxCurrencyCode>EUR</TaxCurrencyCode><LanguageName>es</LanguageName></InvoiceIssueData><TaxesOutputs><Tax><TaxTypeCode>01</TaxTypeCode><TaxRate>21.00</TaxRate><TaxableBase><TotalAmount>1000.00</TotalAmount></TaxableBase><TaxAmount><TotalAmount>210.00</TotalAmount></TaxAmount></Tax></TaxesOutputs><InvoiceTotals><TotalGrossAmount>1000.00</TotalGrossAmount><TotalGeneralDiscounts>0.00</TotalGeneralDiscounts><TotalGeneralSurcharges>0.00</TotalGeneralSurcharges><TotalGrossAmountBeforeTaxes>1000.00</TotalGrossAmountBeforeTaxes><TotalTaxOutputs>210.00</TotalTaxOutputs><TotalTaxesWithheld>0.00</TotalTaxesWithheld><InvoiceTotal>1210.00</InvoiceTotal><TotalOutstandingAmount>1210.00</TotalOutstandingAmount><TotalExecutableAmount>1210.00</TotalExecutableAmount></InvoiceTotals><Items><InvoiceLine><ItemDescription>Consultoría técnica (10 h)</ItemDescription><Quantity>10</Quantity><UnitOfMeasure>01</UnitOfMeasure><UnitPriceWithoutTax>100.00</UnitPriceWithoutTax><TotalCost>1000.00</TotalCost><GrossAmount>1000.00</GrossAmount><TaxesOutputs><Tax><TaxTypeCode>01</TaxTypeCode><TaxRate>21.00</TaxRate><TaxableBase><TotalAmount>1000.00</TotalAmount></TaxableBase><TaxAmount><TotalAmount>210.00</TotalAmount></TaxAmount></Tax></TaxesOutputs></InvoiceLine></Items><PaymentDetails><Installment><InstallmentDueDate>2026-04-14</InstallmentDueDate><InstallmentAmount>1210.00</InstallmentAmount><PaymentMeans>04</PaymentMeans><AccountToBeCredited><IBAN>ES9121000418450200051332</IBAN></AccountToBeCredited></Installment></PaymentDetails></Invoice></Invoices></fe:Facturae>

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "Falta header Authorization o X-API-Key.",
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_cb2db37945f68e4c8267963644"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta operación requiere el scope 'facturae:read'. Tu API key solo tiene los scopes: ninguno.",
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_b68f4a24ac003835bd62c59661"
  }
}

{
  "error": {
    "type": "not_found_error",
    "code": "invoice_not_found",
    "message": "Factura no encontrada.",
    "param": "invoice_uuid",
    "subcode": "invoice_not_found",
    "doc_url": "https://docs.factuarea.com/guides/errors#invoice_not_found",
    "request_id": "req_d43eaaed6de1524532743b6794"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "business_rule_violation",
    "message": "La factura en estado 'draft' no se puede exportar a Facturae. Solo las facturas emitidas (enviadas o pagadas) son exportables.",
    "subcode": "invoice_not_emittable_for_facturae",
    "doc_url": "https://docs.factuarea.com/guides/errors#business_rule_violation",
    "request_id": "req_d03638a101d04e30506194b8ac"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el límite de requests permitido. Reintenta más tarde.",
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_ecdf42ff23726f9318fbca5f41"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Algo se rompió en nuestro lado al procesar la petición. La condición no la provoca tu payload.",
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_f769c581e4de927038ca729793"
  }
}

Descarregar l'XML de FacturaE

Authorization

Paràmetres de ruta

Headers

Cos de la resposta

`application/xml`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Descarregar l'XML de FacturaE

Authorization

Paràmetres de ruta

Headers

Cos de la resposta

200application/xml

401application/json

403application/json

404application/json

422application/json

429application/json

500application/json

`application/xml`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`