Restofy Docs
Cajas registradoras POST

Listar cajas

POST /api/cash-registers/list-cash-registers

Descripción

Devuelve las cajas registradas del negocio con paginación y búsqueda libre.

Detalles

Retorna las cajas del negocio con paginación y búsqueda libre por nombre o ubicación. Incluye tanto las cajas activas como las pausadas para permitir reactivarlas.

Permisos requeridos

admin.module

Request

Nombre Tipo Requerido Reglas
search string No
max:100

Paginación

defaultLimit 50
maxLimit 100
defaultDir asc
withTotal true
allowedSorts [cashRegisterId]

Ejemplo de request

curl -X POST https://restofy.pro/api/cash-registers/list-cash-registers \
  -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": {
        "cashRegisters": [
            {
                "cashRegisterId": 1,
                "cashRegisterUuid": "dda0b66c-4e3a-11f1-97bb-5a94900d81f5",
                "legalEntityId": 1,
                "name": "Caja Principal",
                "legalEntityName": "Mi Negocio",
                "location": "Principal",
                "namePc": "PC-01",
                "seriePc": "SN-001",
                "accountId": 16,
                "defaultInvoiceSequenceId": 1,
                "defaultInvoiceSequenceName": "Secuencia POS",
                "printerId": null,
                "activeSessionId": null,
                "isActive": 1,
                "isAvailable": 1
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 100,
            "total": 1,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}