Base URL https://api.afer.pro Referencia aferapp.com Reservar demo
Referencia de la API

Facturas recurrentes

Cuotas y suscripciones: alta, catálogo vivo, MRR, altas, bajas y renovaciones.

7 endpoints GET · 6 POST · 1

Todo lo que factura solo y se repite —cuotas de mantenimiento, iguales, suscripciones— en un solo sitio: los documentos y las métricas que salen de ellos.

crearRecurrente da de alta la cuota, consultarRecurrentes lista las vivas y obtenerRecurrente devuelve una con su periodicidad y sus fechas. Sobre eso, consultarMRR da la foto a una fecha —separando MRR de ARR con el mismo criterio de vigencia que el panel— y altas, bajas y renovaciones explican el movimiento.

Flujo típico

Un recorrido habitual por esta área, de principio a fin.

  1. /api/v1/recurring-invoices Das de alta la cuota
  2. /api/v1/recurring/mrr Ves el recurrente vivo hoy
  3. /api/v1/recurring/churn Vigilas lo que se pierde

Endpoints del área 7

POST /api/v1/recurring-invoices
Crear recurrente
Crea una plantilla de facturación recurrente anual para un cliente: una suscripción que Afer facturará automáticamente.
GET /api/v1/recurring-invoices
Listar recurrentes
El catálogo de servicios recurrentes con su periodicidad, vigencia, última facturación e importe por ciclo.
GET /api/v1/recurring-invoices/{id}
Obtener recurrente
Devuelve un servicio recurrente concreto por su identificador, con su cabecera, su contraparte y todas sus líneas.
GET /api/v1/recurring/mrr
MRR y ARR vivos
El negocio recurrente vivo en una fecha: MRR (no anuales), ARR (anuales) y contratos activos por periodicidad.
GET /api/v1/recurring/new
Recurrentes creados
Devuelve los servicios recurrentes dados de alta entre dos fechas, agrupados por periodicidad: semanales, mensuales, anuales…
GET /api/v1/recurring/renewals
Renovaciones de recurrentes
Calcula las renovaciones de los servicios recurrentes en un rango de fechas: cuántas veces renueva cada uno, en qué fechas y por qué importe.
GET /api/v1/recurring/churn
Recurrentes dados de baja
El churn del negocio recurrente: servicios con fecha de caducidad dentro del rango, agrupados por periodicidad.
Antes de empezar

Todos estos endpoints comparten el mismo formato de llamada, autenticación por API key y envelope de respuesta: los tienes en Primeros pasos.