Obtener la lista de materiales

Maxim

Maxim

Última actualización el Oct 8, 2026

Devuelve los materiales que figuran en un almacén (incluidos los que tienen existencias cero), ordenados por nombre. Los materiales archivados también se incluyen.

v1/materials/get_list.php

Parámetros

Campo Tipo Obligatorio Descripción
storage_id int Sí ID del almacén
limit int No Tamaño de página, de 1 a 1000
offset int No Cuántos registros omitir

Sin limit se devuelve toda la lista. Consulta la paginación en Reglas generales.

Respuesta

Un array materials con los campos del material y sus existencias en el almacén storage_id:

Campo Tipo Descripción
id int ID del material
name string Nombre
sku string SKU
unit string Unidad de medida, un código de Unidades de medida
price float Precio por unidad
notes string Notas
archived int 1 si el material está archivado
stock float Existencias en el almacén storage_id
minimum float Existencias mínimas en el almacén storage_id
planned float Cambio de existencias por operaciones en estado Planificado. null si no hay ninguna
categories array Categorías del material: objetos con id y name
suppliers array Proveedores del material: objetos con id y name

El campo total contiene el número total de materiales del almacén.

Ejemplo de solicitud

{
    "storage_id": 3998,
    "limit": 100,
    "offset": 0
}

Ejemplo de respuesta

{
    "success": true,
    "materials": [
        {
            "id": 2051,
            "name": "Tablón de roble",
            "sku": "M010",
            "price": 135000,
            "notes": "",
            "archived": 0,
            "stock": 4.2,
            "minimum": 1,
            "planned": null,
            "unit": "m3",
            "categories": [
                {
                    "id": 12,
                    "name": "Madera"
                }
            ],
            "suppliers": [
                {
                    "id": 45,
                    "name": "Maderas García"
                }
            ]
        }
    ],
    "total": 1
}

Errores

Error Motivo
No storage_id in input Falta storage_id
Storage ID not found Almacén no encontrado o eliminado
Invalid limit value. Must be between 1 and 1000 limit no válido
Offset requires limit se envió offset sin limit