Obtener los datos de un material

Maxim

Maxim

Última actualización el Oct 8, 2026

Devuelve los datos de un material y sus existencias en un almacén.

v1/materials/get_entry.php

Parámetros

Campo Tipo Obligatorio Descripción
material_id int Sí ID del material
storage_id int Sí ID del almacén

El material se devuelve solo si figura en el almacén storage_id. Las existencias en todos los almacenes a la vez las devuelve v1/materials/get_stocks.

Respuesta

Un objeto material con los campos del material, sus existencias en el almacén storage_id, sus categorías y proveedores. Las categorías y los proveedores de la respuesta se pueden enviar a v1/materials/edit sin cambios.

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

Ejemplo de solicitud

{
    "material_id": 2051,
    "storage_id": 3998
}

Ejemplo de respuesta

{
    "success": true,
    "material": {
        "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"
            }
        ]
    }
}

Errores

Error Motivo
No material_id in input Falta un campo obligatorio (en lugar de material_id, el nombre del campo)
Storage ID not found Almacén no encontrado o eliminado
Material not found or access denied Material no encontrado, eliminado o que no figura en el almacén