Ir al contenido

Comparación de movimientos

GET/api/report/data/cashbox-movement/comparation

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.

cashbox_idintegerobligatorio

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

typestring

year (por defecto) o month. Otro valor responde 422 con El tipo de comparación debe ser year o month.

yearinteger

Año a comparar. Por defecto, el año actual.

monthintegercondicional

Obligatorio 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_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/comparation?cashbox_id=1&type=month&year=2026&month=10" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"
Comparación200
{
"total_expenses": 9100.4,
"total_income": 12000,
"expenses_percentage": 43.14,
"income_percentage": 56.86
}
Datos no válidos422
{
"message": "El mes es requerido",
"errors": {
"month": ["El mes es requerido"]
}
}
Sin autenticar401
{
"message": "Unauthenticated."
}