Saltearse al contenido
Keirost Keirost · Docs

Reportes

Informes disponibles

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

Contabilidad

Balance de situacion, cuenta de resultados, libro mayor, diario, balanza de sumas y saldos.

IVA

Liquidaciones de IVA, modelos tributarios y libros registro.

Nomina y laboral

Nomina, costes laborales, absentismo, headcount.

Stock y movimientos

Valoracion de stock, rotacion, movimientos y trazabilidad.

Comercial

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

Cashflow

Flujo de caja y prevision de tesoreria.

API comun 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

Parametros comunes

ParamDescripcion
fromFecha inicio del informe
toFecha fin del informe
formatjson (por defecto), pdf, excel, csv
department_idFiltrar por departamento (RRHH)
partner_idFiltrar por partner
warehouse_idFiltrar por almacen (stock)

Respuesta generica

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

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 categoria 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 cronologico.

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:

ParamDescripcion
typerepercutido, soportado, regularizacion
exemptIncluye 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

Nomina en PDF

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

Genera el PDF de nomina para un empleado concreto.

Informe de costes laborales

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

Coste total de nominas (bruto + SS empresa) por departamento y empleado.

Headcount

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

Numero de empleados activos por departamento, evolucion mensual.

Resumen de absentismo

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

Dias perdidos por tipo de ausencia (enfermedad, accidente, permiso no remunerado).

Stock e inventario

Valoracion de stock

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

Valor total del stock segun metodo de valoracion (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 mercancias con detalle de origen/destino.

Rotacion de stock

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

Dias de stock medio, velocidad de venta por producto.

Comercial y analisis

Aged receivable

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

Deuda de clientes segmentada por antiguedad (corriente, 30, 60, 90+ dias).

Beneficios por cliente

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

Margen de beneficio por cliente, volumen de facturacion 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

Distribucion 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.

Generacion 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

ReporteRuta
Balance de situacion/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
Nomina PDF/api/reports/payslip
Costes laborales/api/reports/labor-cost
Headcount/api/reports/headcount
Absentismo/api/reports/absenteeism
Valoracion stock/api/reports/stock-valuation
Movimientos stock/api/reports/stock-movements
Rotacion 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