Listar stock actual — Restofy Docs

Descripción

Devuelve el saldo de stock actual de los insumos.

Detalles

Retorna el listado paginado con la cantidad disponible vigente de cada insumo en el restaurante, por ubicación de almacenamiento. Sirve como vista rápida de saldos actuales. Acepta búsqueda opcional.

Permisos requeridos

inventory.module

Request

Nombre	Tipo	Requerido	Reglas
search	string	No	max:100

Paginación

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

Ejemplo de request

curl -X POST https://app.restofy.co/api/inventory/list-stock \
  -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-07-15T13:20:48Z

HTTP 200

Request

{
    "limit": 200
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "stock": [
            {
                "stockEntryId": 1,
                "inventoryItemId": 1,
                "storageLocationId": 1,
                "quantity": "25.5000",
                "isAvailable": 1
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 100,
            "total": 1,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}