Получение данных материала

Максим

Максим

Обновлено Oct 7, 2026

Возвращает данные материала и его остаток на складе.

v1/materials/get_entry.php

Параметры

Поле Тип Обязательное Описание
material_id int Да ID материала
storage_id int Да ID склада

Материал возвращается, только если он числится на складе storage_id. Остатки на всех складах сразу возвращает v1/materials/get_stocks.

Ответ

Объект material с полями материала, его остатком на складе storage_id, категориями и поставщиками. Категории и поставщиков из ответа можно передать в v1/materials/edit без изменений.

Поле Тип Описание
id int ID материала
name string Название
sku string Артикул
unit string Единица измерения, код из статьи Единицы измерения
price float Цена за единицу
notes string Заметки
archived int 1, если материал в архиве
stock float Остаток на складе storage_id
minimum float Минимальный остаток на складе storage_id
planned float Изменение остатка по операциям в статусе План. null, если таких операций нет
categories array Категории материала: объекты с id и name
suppliers array Поставщики материала: объекты с id и name

Пример запроса

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

Пример ответа

{
    "success": true,
    "material": {
        "id": 2051,
        "name": "Доска дубовая",
        "sku": "M010",
        "price": 135000,
        "notes": "",
        "archived": 0,
        "stock": 4.2,
        "minimum": 1,
        "planned": null,
        "unit": "куб. м",
        "categories": [
            {
                "id": 12,
                "name": "Древесина"
            }
        ],
        "suppliers": [
            {
                "id": 45,
                "name": "ООО Лесторг"
            }
        ]
    }
}

Ошибки

Ошибка Причина
No material_id in input Не передано обязательное поле (вместо material_id будет имя поля)
Storage ID not found Склад не найден или удален
Material not found or access denied Материал не найден, удален или не числится на складе