Ir al contenido

Historial anual

GET/api/report/data/cashbox-movement/history/year

Devuelve una fila por año con el total de egresos y de ingresos de la caja. Excluye los movimientos anulados y las transferencias internas.

yearstring

Año o lista de años separados por coma. Por defecto, el año actual. Se descartan los valores que no son numéricos.

cashbox_idintegerobligatorio

Caja que se consulta. Si falta, responde 422 con Debe seleccionar una caja.

account_idinteger

Limita el cálculo a una cuenta.

coin_idinteger

Limita el cálculo a las cuentas de esa moneda dentro de la caja.

Esta consulta no exige un permiso del módulo: el controlador no llama a Gate::authorize ni a una política. Solo requiere un token válido de Sanctum. Si necesitas restringirla, hay que agregar la autorización en CashboxMovementController.

Ventana de terminal
curl -X GET \
"https://servererp.allendostmen.app/api/report/data/cashbox-movement/history/year?cashbox_id=1&year=2024,2025,2026" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"
Totales por año200
[
{ "year": 2025, "total_expenses": 98200.5, "total_income": 120400 },
{ "year": 2026, "total_expenses": 18250.4, "total_income": 24100 }
]
Datos no válidos422
{
"message": "Debe seleccionar una caja",
"errors": {
"cashbox_id": ["Debe seleccionar una caja"]
}
}
Sin autenticar401
{
"message": "Unauthenticated."
}