Restofy Docs

Listar ubicaciones de almacenamiento

POST /api/storage-locations/list-storage-locations

Descripción

Listado paginado de ubicaciones donde el restaurante guarda su inventario.

Detalles

Devuelve las ubicaciones de almacenamiento con paginación y búsqueda libre por nombre. Incluye tanto ubicaciones activas como pausadas para que las pausadas puedan reactivarse desde el listado.

Permisos requeridos

recipes.module

Request

Nombre Tipo Requerido Reglas
search string No
max:100

Paginación

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

Ejemplo de request

curl -X POST https://app.restofy.co/api/storage-locations/list-storage-locations \
  -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": {
        "storageLocations": [
            {
                "storageLocationId": 4,
                "name": "Bodega Bebidas",
                "description": "Almacenamiento de bebidas y licores",
                "isActive": 1,
                "isAvailable": 1
            },
            {
                "storageLocationId": 1,
                "name": "Bodega Principal",
                "description": "Almacenamiento general de insumos secos",
                "isActive": 1,
                "isAvailable": 1
            },
            {
                "storageLocationId": 5,
                "name": "Bodega Principal",
                "description": "Almacenamiento general insumos - Mar y Tierra",
                "isActive": 1,
                "isAvailable": 1
            },
            {
                "storageLocationId": 2,
                "name": "Cuarto Frío - Carnes",
                "description": "Refrigeración para carnes y proteínas",
                "isActive": 1,
                "isAvailable": 1
            },
            {
                "storageLocationId": 6,
                "name": "Cuarto Frío - Mariscos",
                "description": "Refrigeración para pescados y mariscos",
                "isActive": 1,
                "isAvailable": 1
            },
            {
                "storageLocationId": 3,
                "name": "Cuarto Frío - Verduras",
                "description": "Refrigeración para frutas y verduras",
                "isActive": 1,
                "isAvailable": 1
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 100,
            "total": 6,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}