Максим

Максим

Обновлено Nov 20, 2026

Создает поставку. Статус поставки берется из настройки Статус новой поставки по умолчанию в настройках системы, а от статуса зависит, поступят ли материалы и продукты на склад сразу (см. Смену статуса поставки).

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.