Ir al contenido

Resumen de una caja

GET/api/cashbox/{id}/summary

Devuelve el resumen de una caja en una moneda y un período: control del período, ingresos por segmento y centros de costo con más egresos. Si no envías fechas, usa el mes actual.

idintegerobligatorio

Identificador de la caja.

coin_idintegerobligatorio

Moneda de las cifras. Debe existir en monedas.

date_fromdatecondicional

Inicio del período. Obligatorio si envías date_to.

date_todatecondicional

Fin del período. Obligatorio si envías date_from y debe ser igual o posterior a date_from.

No exige un permiso del módulo: CashboxPolicy::view devuelve verdadero para cualquier usuario autenticado. Ver Permisos y políticas.

Ventana de terminal
curl -G \
"https://servererp.allendostmen.app/api/cashbox/3/summary" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
--data-urlencode "coin_id=1" \
--data-urlencode "date_from=2026-11-01" \
--data-urlencode "date_to=2026-11-30"
Resumen de la caja200
{
"coin_id": 1,
"period": {
"from": "2026-11-01",
"to": "2026-11-30"
},
"control": {
"bank_commissions": {
"count": 2,
"amount": 12.5
},
"annulled": {
"count": 1,
"amount": 80
},
"without_voucher": {
"count": 3
},
"without_accounting_account": {
"count": 1
},
"without_cost_center": {
"count": 2
}
},
"income_by_segment": [
{
"segment_id": null,
"name": "Sin segmento",
"amount": 1500,
"count": 4
}
],
"expense_by_cost_center": [
{
"cost_center_id": 7,
"code": "CC-007",
"name": "Operaciones",
"spent": 420.5,
"set_point": null
}
]
}
Datos no válidos422
{
"message": "Debe seleccionar la moneda.",
"errors": {
"coin_id": [
"Debe seleccionar la moneda."
]
}
}
Caja no encontrada404
{
"message": "No query results for model [App\\Models\\Cashbox] 3"
}