Factuarea API
Informes fiscales (130/303/347)

Recupera las estadísticas del informe de impuestos

Devuelve KPIs agregados del histórico de informes fiscales generados: totales por tipo y formato, tamaño de fichero acumulado, y el trimestre/año fiscal actual.

GET
/tax_reports/stats

Authorization

AuthorizationBearer <token>

En: header

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

{
  "data": {
    "object": "tax_report_stats",
    "total_reports": 12,
    "by_type": {
      "modelo_303": 8,
      "modelo_347": 4
    },
    "by_format": {
      "txt_aeat": 6,
      "pdf": 4,
      "excel": 2
    },
    "total_size_bytes": 24576,
    "current_quarter": {
      "year": 2026,
      "quarter": 2
    },
    "current_year": 2026
  }
}

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

Vista previa de un informe de impuestos

Calcula el desglose de un informe fiscal sin persistir una generación ni escribir ficheros. Ideal para UIs interactivas que confirman los totales antes de consolidar.

Crea un webhook endpoint

Crea un webhook endpoint que recibe notificaciones de eventos mediante callbacks HTTPS. El `secret` de firma se devuelve **una sola vez** en esta respuesta y nunca más — guárdalo de forma segura.