Comparación de movimientos
Suma los ingresos y los egresos de un año completo o de un mes, y calcula qué porcentaje del total representa cada uno. Excluye los movimientos anulados y las transferencias internas. Si no hay movimientos, todos los valores son 0.
Parámetros de consulta
Sección titulada «Parámetros de consulta»cashbox_idintegerobligatorioCaja que se consulta. Si falta, responde 422 con Debe seleccionar una caja.
typestringyear (por defecto) o month. Otro valor responde 422 con El tipo de comparación debe ser year o month.
yearintegerAño a comparar. Por defecto, el año actual.
monthintegercondicionalObligatorio si type es month. Entre 1 y 12; si no, responde 422 con El mes es requerido o El mes debe estar entre 1 y 12.
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/comparation?cashbox_id=1&type=month&year=2026&month=10" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json"const response = await fetch( "https://servererp.allendostmen.app/api/report/data/cashbox-movement/comparation?cashbox_id=1&type=month&year=2026&month=10", { 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/comparation?cashbox_id=1&type=month&year=2026&month=10');{ "total_expenses": 9100.4, "total_income": 12000, "expenses_percentage": 43.14, "income_percentage": 56.86}{ "message": "El mes es requerido", "errors": { "month": ["El mes es requerido"] }}{ "message": "Unauthenticated."}