Factuarea API
Facturas recurrentes

Recupera las estadísticas de facturas recurrentes

KPIs agregados de tus facturas recurrentes: recuentos por estado, vencen hoy / esta semana, generadas y fallidas este mes, desglose por frecuencia, próximas ejecuciones programadas e ingresos estimados este mes.

GET
/recurring_invoices/stats

Authorization

AuthorizationBearer <token>

En: header

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

{
  "data": {
    "object": "recurring_invoice_stats",
    "total": 24,
    "active": 18,
    "paused": 3,
    "cancelled": 2,
    "completed": 1,
    "due_today": 1,
    "due_this_week": 4,
    "generated_this_month": 11,
    "failed_this_month": 0,
    "frequency_breakdown": {
      "monthly": 15,
      "quarterly": 5,
      "yearly": 4
    },
    "next_scheduled": [
      {
        "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a08",
        "name": "Cuota mantenimiento mensual Acme",
        "next_run_date": "2026-02-01"
      }
    ],
    "estimated_revenue_this_month": 5324
  }
}

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

Obtener una factura recurrente

Obtiene una plantilla de factura recurrente por su `uuid`.

Actualizar una factura recurrente

Actualiza una plantilla de factura recurrente. La cadencia y las líneas se aplican a las facturas generadas tras la actualización; las facturas generadas previamente no se ven afectadas.