Ir al contenido

Historial mensual

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

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.

yearstring

Añ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_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/month?cashbox_id=1&year=2025,2026" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"
Historial por año200
[
{
"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 }
]
}
]
Datos no válidos422
{
"message": "Debe seleccionar una caja",
"errors": {
"cashbox_id": ["Debe seleccionar una caja"]
}
}
Sin autenticar401
{
"message": "Unauthenticated."
}