Закупки
API закупок — список закупок и массовое добавление товаров в текущую закупку склада. Черновик создаётся автоматически, уже добавленные товары не меняются.
Ключ, формат запросов и ответов — в статье Общие правила API.
API работает с разделом Склад и товары → Закупки → Закупка товаров (/purchase) — это рабочий список «что и у кого заказать». Он не создаёт документы и не меняет остатки.
Список закупок
GET /api/purchases — последние закупки, сначала незавершённая (черновик).
| Параметр | Значение |
|---|---|
store_id | ИД склада — только закупки этого склада |
limit | Сколько закупок вернуть (1–100, по умолчанию 20) |
Поля закупки: id, store_id, store (склад), time (дата последнего изменения), draft (1 — черновик, 0 — завершена), lines_count — сколько товаров в закупке.
Добавить товары в закупку
POST /api/purchases — добавить товары в последнюю незавершённую закупку склада. Если черновика нет, будет создана новая закупка. Уже добавленные товары (та же номенклатура у того же поставщика) не меняются: количество в существующей строке остаётся прежним.
Тело запроса — JSON:
| Поле | Значение |
|---|---|
store_id | ИД склада (обязательно) |
products | Массив ИД товаров (до 1000) |
quantity | Количество для новых строк, по умолчанию 1 |
purchase_id | ИД конкретной незавершённой закупки; не указан — последняя незавершённая закупка склада |
{
"store_id": 1,
"products": [123, 456, 789],
"quantity": 1
}
Ответ:
| Поле | Значение |
|---|---|
success | true, если запрос выполнен |
purchase_id | ИД закупки, в которую добавили товары |
added | Сколько товаров добавлено |
skipped | Сколько товаров уже было в закупке и пропущено |
not_found | Сколько ИД не найдено в номенклатуре |
{
"success": true,
"purchase_id": 521,
"added": 2,
"skipped": 1,
"not_found": 0,
"txt": ["Успешно сохранено"]
}
Поставщик и закупочная цена новых строк определяются автоматически — по последней проведённой приёмке товара, как в карточке Добавить товар. Единица измерения берётся из карточки товара.
Права
GET /api/purchases— право Номенклатура → Закупка номенклатуры.POST /api/purchases— право Номенклатура → Массовая закупка номенклатуры.
Личный ключ пользователя работает в его правах; общий ключ кабинета — без ограничений по правам пользователя.