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.
Parámetros de consulta
Sección titulada «Parámetros de consulta»yearstringAñ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_idintegerobligatorioCaja que se consulta. Si falta, responde 422 con Debe seleccionar una caja.
account_idintegerLimita el cálculo a una cuenta.
coin_idintegerLimita el cálculo a las cuentas de esa moneda dentro de la caja.
Permiso
Sección titulada «Permiso»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.
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"const response = await fetch( "https://servererp.allendostmen.app/api/report/data/cashbox-movement/history/year?cashbox_id=1&year=2024,2025,2026", { headers: { Authorization: `Bearer ${token}`, Accept: "application/json", }, },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->get('https://servererp.allendostmen.app/api/report/data/cashbox-movement/history/year?cashbox_id=1&year=2024,2025,2026');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."}