Listar cuentas de caja fuerte

Descripción

Listado paginado del catálogo de cuentas de caja fuerte del restaurante.

Detalles

Devuelve las cuentas de caja fuerte configuradas en el restaurante. Admite búsqueda libre para acotar el listado.

Permisos requeridos

finance.module

Request

Nombre	Tipo	Requerido	Reglas
search	string	No	max:100

Paginación

defaultLimit	50
maxLimit	100
defaultDir	asc
withTotal	true
allowedSorts	[name, safeType]

Ejemplo de request

curl -X POST https://restofy.pro/api/safe-accounts/list-safe-accounts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>"

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z

HTTP 200

Request

{
    "limit": 200
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "safeAccounts": [
            {
                "safeAccountId": 9111,
                "accountId": 9111,
                "name": "Boveda principal",
                "location": "Oficina administrativa",
                "safeType": "vault",
                "notes": "Boveda de efectivo del cierre diario.",
                "isSystem": 0,
                "isActive": 1,
                "currentBalanceCents": 500000000
            },
            {
                "safeAccountId": 9112,
                "accountId": 9112,
                "name": "Buzon nocturno",
                "location": "Barra principal",
                "safeType": "drop",
                "notes": null,
                "isSystem": 0,
                "isActive": 1,
                "currentBalanceCents": 0
            },
            {
                "safeAccountId": 1,
                "accountId": 55,
                "name": "Caja fuerte del sistema",
                "location": null,
                "safeType": "other",
                "notes": "Caja fuerte virtual del sistema usada como contraparte default en operaciones de caja",
                "isSystem": 1,
                "isActive": 1,
                "currentBalanceCents": -20000000
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 100,
            "total": 3,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}