Создает продукт вместе с составом. Продукт появляется на складе 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 | Единица ресурса не передана, неизвестна или из другой группы |