Historial mensual
Devuelve, por cada año pedido, los totales de ingresos y egresos y su detalle mes a mes. Excluye los movimientos anulados y las transferencias internas. Para el año en curso solo salen los meses hasta el actual; los años sin ingresos ni egresos se omiten.
Parámetros de consulta
Sección titulada «Parámetros de consulta»yearstringAño o lista de años separados por coma, por ejemplo 2025,2026. 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/month?cashbox_id=1&year=2025,2026" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json"const response = await fetch( "https://servererp.allendostmen.app/api/report/data/cashbox-movement/history/month?cashbox_id=1&year=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/month?cashbox_id=1&year=2025,2026');[ { "year": 2026, "total_expenses": 18250.4, "total_income": 24100, "months": [ { "month": "01", "total_expenses": 9100.4, "total_income": 12000 }, { "month": "02", "total_expenses": 9150, "total_income": 12100 } ] }]{ "message": "Debe seleccionar una caja", "errors": { "cashbox_id": ["Debe seleccionar una caja"] }}{ "message": "Unauthenticated."}