Factuarea API
FacturaE (B2G)

Descargar el XML de FacturaE

Devuelve en streaming el XML FacturaE **3.2.2** de la factura (cumplimiento B2G), conforme al XSD y con desglose completo de impuestos. Cuando la empresa tiene un certificado de firma activo, el cuerpo va firmado **XAdES-EPES** (política de firma Facturae v3.1) y el nombre de fichero es `.xsig`; sin certificado, el XML se devuelve sin firmar como `.xml`. El header de respuesta `X-Facturae-Signed: true|false` distingue ambos casos. Las facturas en borrador devuelven 422 `invoice_not_emittable_for_facturae`.

GET
/invoices/{invoice}/facturae

Authorization

AuthorizationBearer <token>

En: header

Parámetros de ruta

invoice*string

Cuerpo de la respuesta

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 emitida a FACe (el punto general de entrada B2G español). Requiere los tres códigos DIR3 del cliente y un certificado de firma activo; el XML FacturaE 3.2.2 se firma XAdES-EPES y se presenta a través del web service de FACe, devolviendo el número de registro. Sin cuerpo de petición: la factura viaja en la ruta y los códigos DIR3 se leen del cliente. Las claves de prueba (`fact_test_`) simulan el envío (registro `FACE-SANDBOX-*`) sin contactar con FACe. Errores: 422 (`invoice_not_emittable_for_facturae`, `client_missing_dir3_codes`, `signing_certificate_required`), 409 `face_submission_already_exists` (ya existe un envío activo para la factura), 502 `face_transmission_failed` (no se persiste nada cuando el web service de FACe está caído).

Lista las actividades de informes de impuestos

Devuelve la línea de tiempo de actividad paginada por cursor (generación, descarga, etc.) de una única generación de informe fiscal.