Создает поставку. Статус поставки берется из настройки Статус новой поставки по умолчанию в настройках системы, а от статуса зависит, поступят ли материалы и продукты на склад сразу (см. Смену статуса поставки).
v1/purchases/add.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| supplier_id | int | supplier_id или supplier_name | ID существующего поставщика |
| supplier_name | string | supplier_id или supplier_name | Имя поставщика. Если такого нет, он создается из полей с префиксом supplier_ |
| materials | array | materials или products | Строки материалов |
| products | array | materials или products | Строки продуктов |
| num | string | Нет | Номер поставки. Если не передан, присваивается следующий номер |
| date_placed | string | Нет | Дата заказа поставки. По умолчанию сегодня |
| date_received | string | Нет | Дата получения |
| materials_storage_id | int | Нет | Склад материалов. По умолчанию склад из настроек |
| products_storage_id | int | Нет | Склад продуктов. По умолчанию склад из настроек |
| delivery_price | float | Нет | Стоимость доставки. По умолчанию 0 |
| discount | float | Нет | Скидка. По умолчанию 0 |
| notes | string | Нет | Заметки |
Строки поставки
Состав поставки передается двумя массивами: materials для материалов и products для продуктов. Нужна хотя бы одна строка в одном из массивов.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| id | int | id или sku | ID материала или продукта |
| sku | string | id или sku | Артикул. Продукт ищется и по альтернативным SKU |
| amount | float | Да | Количество |
| total | float | Да | Сумма строки (не цена за единицу) |
| notes | string | Нет | Комментарий к строке |
В отличие от заказов, неизвестная позиция не пропускается: запрос отклоняется с ошибкой, и поставка не создается.
Поставщик
Поставщик указывается одним из двух способов:
- supplier_id: ID существующего поставщика, например из v1/suppliers/add;
- supplier_name: имя поставщика. Если поставщика с таким именем нет, Controlata создаст его вместе с поставкой из полей ниже.
| Поле | Тип | Описание |
|---|---|---|
| supplier_name | string | Наименование юрлица или имя ИП и физлица |
| supplier_type | int | Тип: 1 юрлицо, 2 ИП, 3 физлицо. По умолчанию 1 |
| supplier_email | string | Электронная почта |
| supplier_phone | string | Телефон |
| supplier_address | string | Юридический адрес |
| supplier_inn | string | ИНН |
| supplier_kpp | string | КПП |
| supplier_ogrn | string | ОГРН |
| supplier_agreement | string | Договор |
| supplier_manager_name | string | Руководитель |
| supplier_manager_post | string | Должность руководителя |
| supplier_notes | string | Заметки о поставщике |
Если переданы оба поля, используется supplier_id, а supplier_* игнорируются. Если поставщик с таким именем уже есть, поставка привязывается к нему, поля supplier_* не обновляются.
Пример запроса
{
"supplier_id": 45,
"date_placed": "2026-10-06",
"materials_storage_id": 3998,
"materials": [
{
"sku": "M010",
"amount": 0.2,
"total": 26000,
"notes": "Проверить толщину"
},
{
"id": 2052,
"amount": 10,
"total": 4000
}
],
"delivery_price": 1500,
"notes": "Счет № 118"
}
Пример ответа
{
"success": true,
"purchase_id": 29645,
"num": "15",
"status": 1
}
num содержит номер поставки, status содержит код статуса, в котором она создана.
Ошибки
| Ошибка | Причина |
|---|---|
| No supplier_name or supplier_id in input | Не передан поставщик |
| Supplier not found or access denied | Поставщик supplier_id не найден или удален |
| Supplier name must not be empty | Пустое supplier_name |
| Supplier name must be a string | supplier_name не строка |
| Invalid supplier_type value. Must be one of: 1, 2, 3 | Неверный тип нового поставщика |
| Storage ID not found | Склад не найден или удален |
| Materials is not an array | materials не массив (так же для products) |
| No products or materials in input | Не передано ни одной строки |
| Line 0 of materials must be an object | Строка не является объектом (вместо 0 будет номер строки) |
| SKU or id not set for material 0 | В строке нет ни id, ни sku |
| Material with SKU "M010" not found | Позиция не найдена или удалена |
| Amount must be greater than 0 for material with SKU "M010" | Количество не передано, не число или не больше 0 после округления |
| Total must be 0 or greater for material with SKU "M010" | Сумма строки не передана, не число или меньше 0 |
| Invalid notes value for material with SKU "M010". Must be a string | notes в строке не строка |
| Notes for material with SKU "M010" are too long: maximum 10000 characters | Комментарий строки длиннее 10 000 символов |
| Date is not a valid date in format YYYY-MM-DD | Неверная дата заказа или получения |
| Invalid delivery_price value. Must be a number, 0 or greater | Стоимость доставки не число или меньше 0 |
| Invalid discount value. Must be a number, 0 or greater | Скидка не число или меньше 0 |
В текстах ошибок строк вместо material будет product для строк продуктов, а вместо SKU "M010" будет id 2052, если строка передана по id.