Restofy Docs
Denominaciones de efectivo POST

Listar denominaciones auxiliares

POST /api/currency-denominations/list-currency-denominations

Descripción

Devuelve las denominaciones auxiliares (cheque, voucher, cupón, etc.). Billetes y monedas no se listan acá.

Detalles

Retorna las denominaciones auxiliares disponibles para el cuadre de caja con paginación y búsqueda libre. Los billetes y monedas vienen por seed y se gestionan desde otros módulos.

Permisos requeridos

admin.module

Request

Nombre Tipo Requerido Reglas
search string No
max:100

Paginación

defaultLimit 50
maxLimit 200
allowedSorts sortOrder, valueCents, name
defaultSort sortOrder
defaultDir asc
withTotal true

Ejemplo de request

curl -X POST https://restofy.pro/api/currency-denominations/list-currency-denominations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>"

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

Ejemplo de respuesta

Actualizado: 2026-09-13T21:05:19Z
HTTP 200

Request

{
    "limit": 200
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "currencyDenominations": [
            {
                "denominationId": 13,
                "kind": "aux",
                "name": "Auxiliar 1",
                "valueCents": null,
                "sortOrder": 1,
                "isSystem": 0,
                "isActive": 1
            },
            {
                "denominationId": 14,
                "kind": "aux",
                "name": "Auxiliar 2",
                "valueCents": null,
                "sortOrder": 2,
                "isSystem": 0,
                "isActive": 1
            },
            {
                "denominationId": 15,
                "kind": "aux",
                "name": "Auxiliar 3",
                "valueCents": null,
                "sortOrder": 3,
                "isSystem": 0,
                "isActive": 1
            },
            {
                "denominationId": 16,
                "kind": "aux",
                "name": "Denom Test 6aa70f17cb1bf",
                "valueCents": null,
                "sortOrder": 8,
                "isSystem": 0,
                "isActive": 1
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 200,
            "total": 4,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}