Informes

Los agregados que responden a "¿cómo va el negocio?".

3 endpoints GET · 3 Solo lectura

Empieza por consultarResumen, que trae en una sola llamada los KPIs del mes —ventas, cobros, pagos, pendientes, MRR y pipeline— y sirve como cabecera de cualquier panel.

A partir de ahí, ventas y resultado profundizan en la cifra: admiten agrupar para devolver la serie mensual o el desglose por familia y cliente. Para el drill-down documento a documento, cada área de documentos tiene su propio listado.

Flujo típico

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

/api/v1/reports/summary Los KPIs del mes de un vistazo
/api/v1/reports/sales La serie mensual o el top de clientes
/api/v1/reports/profit-and-loss El margen entre ventas y compras

Endpoints del área 3

GET /api/v1/reports/summary

Resumen del panel

Los KPIs del mes en una sola llamada: ventas, cobros, pendiente de cobro, MRR/ARR y pipeline del CRM.

GET /api/v1/reports/sales

Ventas del período

Devuelve las ventas entre dos fechas (albaranes + facturas directas), separando cuánto proviene de servicios recurrentes.

GET /api/v1/reports/profit-and-loss

Resultado y margen

Ventas menos compras del período: margen bruto en euros y en porcentaje, con serie mensual opcional.

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.