Reportes

Informes disponibles

Keirost incluye un sistema de reportes completo que cubre las necesidades de contabilidad, fiscalidad, RRHH y análisis de negocio.

Contabilidad

Balance de situación, cuenta de resultados, libro mayor, diario, balanza de sumas y saldos.

IVA

Liquidaciones de IVA, modelos tributarios y libros registro.

Nómina y laboral

Nómina, costes laborales, absentismo, headcount.

Stock y movimientos

Valoración de stock, rotación, movimientos y trazabilidad.

Comercial

Aged receivable, beneficios por cliente, por producto, por proyecto.

Cashflow

Flujo de caja y previsión de tesorería.

---

API común de reportes

Todos los reportes siguen la misma estructura:

GET /api/reports/:report_name
GET /api/reports/:report_name?from=YYYY-MM-DD&to=YYYY-MM-DD
GET /api/reports/:report_name?format=pdf|excel|csv

Parámetros comunes

Param	Descripción
from	Fecha inicio del informe
to	Fecha fin del informe
format	json (por defecto), pdf, excel, csv
department_id	Filtrar por departamento (RRHH)
partner_id	Filtrar por partner
warehouse_id	Filtrar por almacén (stock)

Respuesta genérica

{
  "report_name": "balance_sheet",
  "generated_at": "2026-05-08T10:00:00Z",
  "generated_by": "admin",
  "from": "2026-01-01",
  "to": "2026-03-31",
  "data": { ... },
  "summary": { ... }
}

---

Contabilidad

Balance de situación

GET /api/reports/balance-sheet?from=2026-01-01&to=2026-03-31

Activo, pasivo y patrimonio neto a fecha de cierre.

Cuenta de resultados (P&L)

GET /api/reports/pl?from=2026-01-01&to=2026-03-31

Ingresos, costes y resultado del ejercicio. Incluye desglose por categoría de gasto.

Libro mayor

GET /api/reports/ledger?account_id=acc_001&from=2026-01-01&to=2026-03-31

Movimientos de una cuenta contable especifica.

Diario general

GET /api/reports/journal?from=2026-01-01&to=2026-03-31

Todos los asientos contables en orden cronológico.

Balanza de sumas y saldos

GET /api/reports/trial-balance?from=2026-01-01&to=2026-03-31

Suma de debe y haber por cuenta, saldo deudor y acreedor.

Balance de sumas y saldos (8 columnas)

GET /api/reports/trial-balance?type=8col&from=2026-01-01&to=2026-03-31

Formato oficial de 8 columnas para depositacion legal.

---

Fiscalidad

Modelo 130 (IRPF)

GET /api/reports/tax/model130?year=2026&quarter=1&format=pdf

Genera el modelo 130 de IRPF en formato PDF para presentar telemativamente.

Modelo 303 (IVA)

GET /api/reports/tax/model303?year=2026&period=03&format=pdf

Genera el modelo 303 de IVA. Params adicionales:

Param	Descripción
type	repercutido, soportado, regularizacion
exempt	Incluye operaciones exentas

Resumen IVA por trimestre

GET /api/reports/vat?from=2026-01-01&to=2026-03-31

Desglose de IVA devengado, IVA soportado y cuota a ingresar.

Modelo 390 (IVA anual)

GET /api/reports/tax/model390?year=2026&format=pdf

---

RRHH y laboral

Nómina en PDF

GET /api/reports/payslip?payroll_id=pay_2026_05_emp001&format=pdf

Genera el PDF de nómina para un empleado concreto.

Informe de costes laborales

GET /api/reports/labor-cost?from=2026-01-01&to=2026-06-30

Coste total de nóminas (bruto + SS empresa) por departamento y empleado.

Headcount

GET /api/reports/headcount?from=2026-01-01&to=2026-06-30

Número de empleados activos por departamento, evolución mensual.

Resumen de absentismo

GET /api/reports/absenteeism?from=2026-01-01&to=2026-06-30

Días perdidos por tipo de ausencia (enfermedad, accidente, permiso no remunerado).

---

Stock e inventario

Valoración de stock

GET /api/reports/stock-valuation?warehouse_id=wh_001&from=2026-01-01&to=2026-03-31

Valor total del stock según método de valoración (FIFO, PMP).

Movimientos de stock

GET /api/reports/stock-movements?warehouse_id=wh_001&from=2026-01-01&to=2026-03-31

Entradas y salidas de mercancías con detalle de origen/destino.

Rotación de stock

GET /api/reports/stock-rotation?from=2026-01-01&to=2026-06-30

Días de stock medio, velocidad de venta por producto.

---

Comercial y análisis

Aged receivable

GET /api/reports/aging?from=2026-01-01&to=2026-06-30

Deuda de clientes segmentada por antiguedad (corriente, 30, 60, 90+ días).

Beneficios por cliente

GET /api/reports/profit-customer?from=2026-01-01&to=2026-06-30

Margen de beneficio por cliente, volumen de facturación y tendencia.

Beneficios por producto

GET /api/reports/profit-item?from=2026-01-01&to=2026-06-30

Ranking de productos por margen y volumen de ventas.

Beneficios por proyecto

GET /api/reports/profit-project?from=2026-01-01&to=2026-06-30

Margen por proyecto interno (definido en pedidos de servicio).

Beneficios por centro de coste

GET /api/reports/profit-cost-center?from=2026-01-01&to=2026-06-30

Distribución del resultado por centro de coste.

Cashflow

GET /api/reports/cashflow?from=2026-01-01&to=2026-12-31

Previson de flujos de caja: entradas y salidas proyectadas por fecha.

Executive summary

GET /api/reports/executive?from=2026-01-01&to=2026-06-30

Dashboard ejecutivo con KPI principales en un solo informe.

---

Generación asincrona de reportes

Para reportes pesados (ano completo, muchos datos), se generan en segundo plano:

POST /api/reports/:report_name/generate
Content-Type: application/json

{
  "from": "2026-01-01",
  "to": "2026-12-31",
  "format": "excel",
  "notify": true
}

Respuesta:

{
  "task_id": "task_report_001",
  "status": "queued",
  "message": "El informe se generara en segundo plano. Recibiras una notificacion cuando este listo."
}

El resultado se notifica via el sistema de notificaciones in-app con enlace de descarga.

---

Resumen de endpoints

Reporte	Ruta
Balance de situación	/api/reports/balance-sheet
Cuenta de resultados	/api/reports/pl
Libro mayor	/api/reports/ledger
Diario general	/api/reports/journal
Balanza sumas/saldos	/api/reports/trial-balance
IVA por periodo	/api/reports/vat
Modelo 130 (IRPF)	/api/reports/tax/model130
Modelo 303 (IVA)	/api/reports/tax/model303
Modelo 390 (IVA anual)	/api/reports/tax/model390
Nómina PDF	/api/reports/payslip
Costes laborales	/api/reports/labor-cost
Headcount	/api/reports/headcount
Absentismo	/api/reports/absenteeism
Valoración stock	/api/reports/stock-valuation
Movimientos stock	/api/reports/stock-movements
Rotación stock	/api/reports/stock-rotation
Aged receivable	/api/reports/aging
Beneficios por cliente	/api/reports/profit-customer
Beneficios por producto	/api/reports/profit-item
Beneficios por proyecto	/api/reports/profit-project
Beneficios por centro coste	/api/reports/profit-cost-center
Cashflow	/api/reports/cashflow
Resumen ejecutivo	/api/reports/executive