Factuarea API
FacturaE (B2G)

Descarregar l'XML de FacturaE

Retorna en streaming l'XML FacturaE **3.2.2** de la factura (compliment B2G), conforme a l'XSD i amb desglossament complet d'impostos. Quan l'empresa té un certificat de signatura actiu, el cos va signat **XAdES-EPES** (política de signatura Facturae v3.1) i el nom de fitxer és `.xsig`; sense certificat, l'XML es retorna sense signar com a `.xml`. El header de resposta `X-Facturae-Signed: true|false` distingeix ambdós casos. Les factures en esborrany retornen 422 `invoice_not_emittable_for_facturae`.

GET
/invoices/{invoice}/facturae

Authorization

AuthorizationBearer <token>

A: header

Paràmetres de ruta

invoice*string

Cos de la resposta

application/xml

application/json

application/json

application/json

application/json

"string"

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No se ha proporcionado una API key válida en el header Authorization.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta API key no tiene el scope requerido para esta operación.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_01HKQS5NBC3P8M1KX4V7SLNHQD"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el rate limit de 60 peticiones por minuto. Reintenta tras 30 segundos.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVL"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Ha ocurrido un error inesperado. Si persiste, contacta con soporte adjuntando el request_id.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_01HKQS5NLX2D7X0U5H6J1KCAWM"
  }
}

Enviar la factura a FACe

Presenta una factura emesa a FACe (el punt general d'entrada B2G espanyol). Requereix els tres codis DIR3 del client i un certificat de signatura actiu; l'XML FacturaE 3.2.2 es signa XAdES-EPES i es presenta a través del web service de FACe, retornant el número de registre. Sense cos de petició: la factura viatja a la ruta i els codis DIR3 es llegeixen del client. Les claus de prova (`fact_test_`) simulen l'enviament (registre `FACE-SANDBOX-*`) sense contactar amb FACe. Errors: 422 (`invoice_not_emittable_for_facturae`, `client_missing_dir3_codes`, `signing_certificate_required`), 409 `face_submission_already_exists` (ja existeix un enviament actiu per a la factura), 502 `face_transmission_failed` (no es persisteix res quan el web service de FACe està caigut).

Llista les activitats d'informes d'impostos

Retorna la línia de temps d'activitat paginada per cursor (generació, descàrrega, etc.) d'una única generació d'informe fiscal.