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 permisocashbox.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.
Consultas de datos
Sección titulada «Consultas de datos»| 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 |
Descargas
Sección titulada «Descargas»| Ruta | Formato | Página |
|---|---|---|
GET /api/report/excel/cashbox-movement/all |
Excel | Exportación de movimientos |
GET /api/report/pdf/cashbox-movement/all |
Exportación de movimientos | |
GET /api/report/excel/account-conciliation/{conciliation} |
Excel | Exportar conciliación |
GET /api/report/pdf/account-conciliation/{conciliation} |
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} |
Exportar cierre mensual | |
GET /api/report/excel/account-closure-monthly-preview |
Excel | Vista previa del cierre |
GET /api/report/pdf/account-closure-monthly-preview |
Vista previa del cierre |
Inteligencia artificial
Sección titulada «Inteligencia artificial»| Ruta | Qué hace | Página |
|---|---|---|
POST /api/ai/cashbox |
Responde una pregunta sobre los datos de Caja | Consulta con IA |
Qué considerar
Sección titulada «Qué considerar»- Las consultas de datos exigen
cashbox_id; sin él responden422conDebe 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.
