Ir al contenido

Comparación de períodos

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

Devuelve una serie por año, del año actual hacia atrás, con el valor de cada mes y el total del período. Sirve para superponer años en un gráfico. A diferencia de las demás consultas del grupo, no excluye los movimientos anulados ni las transferencias.

cashbox_idintegerobligatorio

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

coin_idinteger

Limita el cálculo a las cuentas de esa moneda dentro de la caja.

periodstring

anual (por defecto, los 12 meses) o tetramensual (los últimos 4 meses hasta el mes actual, o hasta diciembre en años pasados).

countinteger

Cuántos años devolver. Por defecto 2; se ajusta al rango de 1 a 5.

mov_typestring

egreso (por defecto) o ingreso. Cualquier otro valor se trata como egreso.

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/comparison?cashbox_id=1&period=anual&count=2&mov_type=egreso" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"
Series por año200
[
{
"period_label": "2026",
"year": 2026,
"months": [
{ "month": "01", "label": "Ene", "value": 9100.4 },
{ "month": "02", "label": "Feb", "value": 9150 }
],
"total": 18250.4
}
]
Datos no válidos422
{
"message": "Debe seleccionar una caja",
"errors": {
"cashbox_id": ["Debe seleccionar una caja"]
}
}
Sin autenticar401
{
"message": "Unauthenticated."
}