Ir al contenido

Reportes y consultas de datos

Caja ofrece tres familias de rutas de reporte, todas bajo /api/report y protegidas por auth:sanctum:

  • Datos (/api/report/data/cashbox-movement/...): devuelven JSON con totales y estados para alimentar gráficos y tarjetas. Ninguna exige un permiso del módulo.
  • Descargas (/api/report/excel/... y /api/report/pdf/...): devuelven un archivo, no JSON. Exigen el permiso cashbox.export.
  • Consulta con IA (/api/ai/cashbox): responde preguntas en lenguaje natural con un límite de 15 solicitudes por minuto.

La base de todas las rutas es https://servererp.allendostmen.app/api, con el encabezado Authorization: Bearer $TOKEN.

Ruta Qué devuelve Página
GET /api/report/data/cashbox-movement/history/month Ingresos y egresos por año y por mes Historial mensual
GET /api/report/data/cashbox-movement/history/year Ingresos y egresos por año Historial anual
GET /api/report/data/cashbox-movement/comparation Porcentaje de ingresos y egresos de un año o mes Comparación de movimientos
GET /api/report/data/cashbox-movement/comparison Serie mensual de varios años para comparar Comparación de períodos
GET /api/report/data/cashbox-movement/conciliation-status Movimientos conciliados y no conciliados Estado de conciliación
GET /api/report/data/cashbox-movement/accounts-conciliation-status Estado de conciliación y cierre de cada cuenta Conciliación por cuenta
Ruta Formato Página
GET /api/report/excel/cashbox-movement/all Excel Exportación de movimientos
GET /api/report/pdf/cashbox-movement/all PDF Exportación de movimientos
GET /api/report/excel/account-conciliation/{conciliation} Excel Exportar conciliación
GET /api/report/pdf/account-conciliation/{conciliation} PDF Exportar conciliación
GET /api/report/excel/account-closure-monthly/{year}/{month} Excel Exportar cierre mensual
GET /api/report/pdf/account-closure-monthly/{year}/{month} PDF Exportar cierre mensual
GET /api/report/excel/account-closure-monthly-preview Excel Vista previa del cierre
GET /api/report/pdf/account-closure-monthly-preview PDF Vista previa del cierre
Ruta Qué hace Página
POST /api/ai/cashbox Responde una pregunta sobre los datos de Caja Consulta con IA
  • Las consultas de datos exigen cashbox_id; sin él responden 422 con Debe seleccionar una caja.
  • Las consultas de historial y comparación de movimientos excluyen anulados y transferencias internas. La comparación de períodos y el estado de conciliación no.
  • Los errores siguen el formato de Errores.