Закупки

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
}

Ответ:

ПолеЗначение
successtrue, если запрос выполнен
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 — право Номенклатура → Массовая закупка номенклатуры.

Личный ключ пользователя работает в его правах; общий ключ кабинета — без ограничений по правам пользователя.

Обновлено: 21.11.2026