Максим

Максим

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

Создает продукт вместе с составом. Продукт появляется на складе storage_id и на складах, которые хранят все продукты или его категории.

v1/products/add.php

Параметры

Поле Тип Обязательное Описание
name string Да Название
unit string Да Единица измерения, код из статьи Единицы измерения
storage_id int Да Склад, на котором создается остаток
sku string Нет Артикул
price float Нет Цена продажи за единицу. По умолчанию 0
batch_size float Нет Размер партии: на какое количество продукта указан состав. По умолчанию 1
stock float Нет Начальный остаток на складе storage_id. По умолчанию 0
minimum float Нет Минимальный остаток на складе storage_id. По умолчанию 0
notes string Нет Заметки
categories array Нет Категории: объекты с id или name (см. Категории)
suppliers array Нет ID поставщиков из v1/suppliers/get_list
alternative_sku array Нет Альтернативные SKU: объекты с полями sku и label (необязательная подпись)
materials array Нет Материалы в составе
products array Нет Заготовки в составе
resources array Нет Ресурсы в составе

Категорию можно передать по названию: если такой нет, она будет создана. ID существующих категорий возвращает v1/categories/get_list.

Уникальность основного и альтернативных SKU не проверяется.

Состав продукта

Состав задается на одну партию (batch_size единиц) и передается массивами materials (материалы), products (заготовки) и resources (ресурсы).

Строки materials и products

Поле Тип Обязательное Описание
id int Да ID материала или продукта
amount_per_batch float Да Количество на партию
unit string Да Единица строки. Из той же группы, что единица материала или продукта: для материала в «кг» подойдут «кг» или «г»
loss_percent float Нет Потери в процентах. По умолчанию 0. Принимаются, только если в настройках компании включено отображение потерь в составе
position int Нет Порядковый номер строки в составе

position задает порядок строк состава в интерфейсе Controlata, общий для materials и products. Строки без него идут последними, в порядке передачи. Controlata перенумеровывает позиции с 0, поэтому в Получении данных продукта они могут отличаться от переданных.

Строки resources

Каждая строка ресурса содержит id ресурса. Нужны ли amount_per_batch и unit, зависит от типа ресурса (о типах в статье Создание ресурса):

Тип ресурса amount_per_batch unit
Фиксированная ставка Количество на партию, например часы работы Нужен
Фиксированная ставка, цена указывается в составе продукта Сумма на партию в рублях Не нужен
Процент Не передается: берется из ресурса Не нужен
Процент, указывается в составе продукта Процент Не нужен
Амортизация Количество на партию, например часы работы оборудования Нужен

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

Стол: в партии 10 штук, на партию уходит 0.5 куб. м доски с потерями 5%, 400 саморезов, 40 ножек (заготовка) и 30 часов работы столяра. Накладные расходы считаются процентом, который задан в самом ресурсе, поэтому для него достаточно id.

{
    "name": "Стол обеденный",
    "sku": "P100",
    "unit": "шт",
    "price": 45000,
    "batch_size": 10,
    "storage_id": 3999,
    "stock": 5,
    "minimum": 2,
    "categories": [{ "id": 21 }],
    "suppliers": [{ "id": 46 }],
    "alternative_sku": [
        {
            "label": "Ozon",
            "sku": "OZ-P100"
        }
    ],
    "materials": [
        {
            "id": 2051,
            "amount_per_batch": 0.5,
            "unit": "куб. м",
            "loss_percent": 5
        },
        {
            "id": 2060,
            "amount_per_batch": 400,
            "unit": "шт"
        }
    ],
    "products": [
        {
            "id": 312,
            "amount_per_batch": 40,
            "unit": "шт"
        }
    ],
    "resources": [
        {
            "id": 57,
            "amount_per_batch": 30,
            "unit": "ч"
        },
        {
            "id": 58
        }
    ]
}

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

{
    "success": true,
    "product_id": 3120
}

Ошибки

Ошибка Причина
No name in input Не передано обязательное поле (вместо name будет имя поля)
Name must not be empty Пустое название
Name must be a string Название передано не строкой, например массивом
Unit not set Передана пустая единица измерения
Unit not found Неизвестная единица измерения или единица только для ресурсов
Storage ID is not set storage_id равен 0 или пустой
Storage ID not found Склад не найден или удален
Batch size must be greater than 0 Размер партии 0 или меньше
Invalid price value. Must be a number Значение не число, например "12,5" (так же для batch_size, stock и minimum)
Category 12 not found Категория не найдена
Supplier not found or access denied Поставщик не найден или удален
Alternative_sku is not an array alternative_sku передан не массивом
SKU must be from 1 to 50 characters for alternative_sku 0 Альтернативный SKU пустой или длиннее 50 символов (в конце номер строки с 0)
Label must not exceed 100 characters for alternative_sku 0 Подпись альтернативного SKU длиннее 100 символов

Ошибки в строках состава

В тексте ошибки вместо 2051 будет ID позиции, а вместо 0 номер строки в массиве (с 0).

Ошибка Причина
Materials is not an array materials передан не массивом (так же для products и resources)
Line 0 of materials must be an object Строка не объект (так же для products и resources)
No id for material 0 Не передан id материала или он не число (так же для product)
Material 2051 not found Материал не найден или удален
Product 2051 not found Продукт не найден или удален
Product cannot be a component of itself Продукт добавлен в собственный состав
Amount per batch must be greater than 0 for material 2051 Количество не передано, не число или после округления до 3 знаков равно 0 (так же для product и resource)
Unit not found for material 2051. Use a unit of the same group as the material unit Единица не передана, неизвестна или из другой группы (так же для product)
Loss percent must be from 0 to 100 for material 2051 Потери меньше 0, не меньше 100 или не число (так же для product)
Loss percent is disabled in company settings for material 2051 Потери переданы, но в настройках компании выключено их отображение в составе (так же для product)
Resource for line 0 not found Ресурс не найден или удален
Percent must not exceed 100 for resource 2051 Процент в составе больше 100
Unit not found for resource 2051. Use a unit of the same group as the resource unit Единица ресурса не передана, неизвестна или из другой группы