Descarregar el XML Facturae actual o retingut

Retorna com a flux l'XML Facturae 3.2.2 d'una factura emesa: .xsig signat si hi ha certificat de signatura; si no, .xml (consulta X-Facturae-Signed). - Sense submission_id exporta l'origen legal actual; les factures en esborrany i programades retornen 422 invoice_not_emittable_for_facturae. - Amb un submission_id propi retorna els bytes retinguts exactes d'aquest intent, mai regenerats ni completats amb dades en viu. - El hash i l'ETag només acompanyen un artefacte retingut conegut.

Authorization

AuthorizationBearer <token>

La teva API key com a token Bearer: fact_live_… en producció, fact_test_… en sandbox. Consulta la guia d'autenticació.

A: header

Paràmetres de ruta

company*string

Identificador públic (UUID v7) de l'empresa. Obtén-lo de GET /v1/me (data.scope[].id).

Formatuuid

invoice*string

Identificador públic (UUID v7) de la factura.

Formatuuid

Paràmetres de consulta

submission_id?|

Intent propi de FACe que s'exporta. Omès o null exporta la font legal actual; un UUID retorna els bytes exactes conservats d'aquest intent, mai regenerats ni tornats a signar.

Headers

Factuarea-Version?string

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

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/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()));

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>

S'ha enviat la capçalera X-Active-Profile retirada

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

Capçalera Factuarea-Version malformada

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

Factuarea-Version no admesa

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

Empresa desactivada

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

Empresa no trobada o fora de l'abast de l'API key

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

Descarregar el XML Facturae actual o retingut

Authorization

Paràmetres de ruta

Paràmetres de consulta

Headers

Cos de la resposta

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`