Factuarea API
Factures recurrents

Recupera les estadístiques de factures recurrents

KPIs agregats de les teves factures recurrents: recomptes per estat, vencen avui / aquesta setmana, generades i fallides aquest mes, desglossament per freqüència, properes execucions programades i ingressos estimats aquest mes.

GET
/recurring_invoices/stats

Authorization

AuthorizationBearer <token>

A: header

Cos de la resposta

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

Obtenir una factura recurrent

Obté una plantilla de factura recurrent pel seu `uuid`.

Actualitzar una factura recurrent

Actualitza una plantilla de factura recurrent. La cadència i les línies s'apliquen a les factures generades després de l'actualització; les factures generades prèviament no es veuen afectades.