Download current or retained Facturae XML

Stream the Facturae 3.2.2 XML of an issued invoice: signed .xsig with a signing certificate, otherwise .xml (see X-Facturae-Signed). - Without submission_id it exports the current legal source; draft and scheduled invoices return 422 invoice_not_emittable_for_facturae. - With an own submission_id it returns that attempt's exact retained bytes, never regenerated or completed with live data. - Hash and ETag only accompany a known retained artifact.

Authorization

AuthorizationBearer <token>

Your API key as a bearer token: fact_live_… in production, fact_test_… in sandbox. See the authentication guide.

In: header

Path Parameters

company*string

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

Formatuuid

invoice*string

Public identifier (UUID v7) of the invoice.

Formatuuid

Query Parameters

submission_id?|

Own FACe attempt to export. Omitted or null exports the current legal source; a UUID returns the exact retained bytes of that attempt, never regenerated or re-signed.

Headers

Factuarea-Version?string

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Formatdate

Response Body

`application/xml`

`application/json`

Request example

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/companies/01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01/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()));

Response example

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>

Retired X-Active-Profile header sent

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_unknown",
    "subcode": "retired_active_profile_header",
    "message": "La cabecera 'X-Active-Profile' fue retirada de la API v1: la empresa efectiva se indica en el segmento de empresa de la ruta.",
    "param": "X-Active-Profile",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_unknown",
    "request_id": "req_01J8Y3M2Q40000000000000001"
  }
}

Malformed Factuarea-Version header

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid_format",
    "message": "El header 'Factuarea-Version' debe tener formato YYYY-MM-DD.",
    "param": "Factuarea-Version",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid_format",
    "request_id": "req_01J8Y3M2Q40000000000000002"
  }
}

Unsupported Factuarea-Version

{
  "error": {
    "type": "invalid_request_error",
    "code": "unsupported_api_version",
    "message": "La versión de API '2020-01-01' no está soportada.",
    "param": "Factuarea-Version",
    "doc_url": "https://docs.factuarea.com/guides/errors#unsupported_api_version",
    "request_id": "req_01J8Y3M2Q40000000000000003"
  }
}

{
  "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"
  }
}

GET /v1/companies/{company}/invoices/{invoice}/facturae · 403 insufficient_scope

{
  "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"
  }
}

facturae_operation_forbidden

{
  "error": {
    "type": "authorization_error",
    "code": "facturae_operation_forbidden",
    "message": "No tienes permiso para realizar esta operación de Facturae.",
    "details": {
      "operation": "read_submission_artifact",
      "reason": "access"
    },
    "doc_url": "https://docs.factuarea.com/guides/errors#facturae_operation_forbidden",
    "request_id": "req_01KFAC3E5S9X2M7Q4R8T6V0WZB"
  }
}

Company deactivated

{
  "error": {
    "type": "authorization_error",
    "code": "company_inactive",
    "message": "Esta empresa está desactivada. Actívala para operar.",
    "param": "company",
    "doc_url": "https://docs.factuarea.com/guides/errors#company_inactive",
    "request_id": "req_01J8Y3M2Q40000000000000005"
  }
}

GET /v1/companies/{company}/invoices/{invoice}/facturae · 404 invoice_not_found

{
  "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"
  }
}

Company not found or outside the API key scope

{
  "error": {
    "type": "not_found_error",
    "code": "profile_not_found",
    "message": "La empresa indicada no existe o no está en el ámbito de tu credencial.",
    "param": "company",
    "doc_url": "https://docs.factuarea.com/guides/errors#profile_not_found",
    "request_id": "req_01J8Y3M2Q40000000000000004"
  }
}

{
  "error": {
    "type": "conflict_error",
    "code": "invoice_payment_terms_version_conflict",
    "message": "El calendario de pago ha cambiado. Recarga la factura.",
    "param": "expected_payment_terms_version",
    "details": {
      "current_version": 2,
      "recovery": "reload_or_keep_local"
    },
    "doc_url": "https://docs.factuarea.com/guides/errors#invoice_payment_terms_version_conflict",
    "request_id": "req_01J8Y3M2Q4CF0000000000IPT1"
  }
}

GET /v1/companies/{company}/invoices/{invoice}/facturae · 422 business_rule_violation

{
  "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"
  }
}

GET /v1/companies/{company}/invoices/{invoice}/facturae · 422 invalid_facturae_structured_data (param buyer.postal_code)

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_facturae_structured_data",
    "message": "Falta o no es válido el código postal (en España son 5 dígitos) del cliente y Facturae lo exige para generar el XML. Corrígelo en la ficha del cliente y vuelve a exportar.",
    "param": "buyer.postal_code",
    "details": {
      "field_errors": {
        "buyer.postal_code": [
          "Falta o no es válido el código postal (en España son 5 dígitos) del cliente y Facturae lo exige para generar el XML. Corrígelo en la ficha del cliente y vuelve a exportar."
        ]
      },
      "diagnostic": "schema_invalid",
      "xpath": "/fe:Facturae/Parties/BuyerParty/LegalEntity/AddressInSpain/PostCode"
    },
    "doc_url": "https://docs.factuarea.com/guides/errors#invalid_facturae_structured_data",
    "request_id": "req_5b2e9c41d7a8f03e6c1b94a7d2"
  }
}

invoice_not_emittable_for_facturae

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

{
  "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"
  }
}

GET /v1/companies/{company}/invoices/{invoice}/facturae · 500 internal_error

{
  "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"
  }
}

facturae_artifact_unavailable

{
  "error": {
    "type": "api_error",
    "code": "facturae_artifact_unavailable",
    "message": "El archivo Facturae de este envío no está disponible.",
    "param": "submission_id",
    "details": {
      "attempt_id": "019e0000-0000-7000-8000-000000000901",
      "reason": "corrupt"
    },
    "doc_url": "https://docs.factuarea.com/guides/errors#facturae_artifact_unavailable",
    "request_id": "req_01KFAC3E5S9X2M7Q4R8T6V0WZB"
  }
}

Download current or retained Facturae XML

Authorization

Path Parameters

Query Parameters

Headers

Response Body

200application/xml

400application/json

401application/json

403application/json

404application/json

409application/json

422application/json

429application/json

500application/json

`application/xml`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`