Caja
POST
Listar saldos de clientes de la sesión
POST /api/cashier/get-customer-balances
Descripción
Devuelve las gift cards, anticipos y saldos a favor registrados durante la sesión.
Detalles
Retorna los movimientos de saldos de clientes de la sesión: gift cards y anticipos cobrados, saldos a favor otorgados y las anulaciones devueltas en efectivo. Cada movimiento informa el monto y si suma o resta al saldo del cliente. Falla si la sesión no existe o el usuario no tiene acceso a ella.
Permisos requeridos
cash.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| cashRegisterSessionId | int | Sí |
min_value:1
|
Paginación
| defaultLimit | 25 |
| maxLimit | 50 |
| allowedSorts | createdAt |
| defaultSort | createdAt |
| defaultDir | desc |
| withTotal | true |
Ejemplo de request
curl -X POST https://app.restofy.co/api/cashier/get-customer-balances \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"cashRegisterSessionId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"cashRegisterSessionId": 2
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"balances": [
{
"journalEntryId": 1,
"type": "gift_card_issue",
"title": "Venta gift card GC-F2EA5C49",
"notes": "Venta gift card GC-F2EA5C49",
"entryStatus": "normal",
"amountCents": "40000",
"paidFromName": "Caja Principal",
"createdAt": "2026-07-15T13:18:42.000Z",
"actorName": "App Testing"
}
],
"pagination": {
"page": 1,
"limit": 25,
"total": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
}