Создает производство. Расход материалов, использованных продуктов и ресурсов Controlata рассчитывает сама по составам продуктов, передавать его не нужно.
v1/production/add.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| products | array | Да | Выпускаемые продукты, см. ниже |
| date | string | Нет | Дата производства, YYYY-MM-DD. По умолчанию сегодня |
| name | string | Нет | Название |
| notes | string | Нет | Заметки |
| produce_subproducts | int | Нет | 1: производить заготовки вместе с продуктами, 0: списывать со склада готовыми. По умолчанию по настройке компании |
| materials_storage_id | int | Нет | Склад, с которого списываются материалы. 0: выбирать автоматически |
| subproducts_storage_id | int | Нет | Склад, с которого списываются использованные продукты. 0: выбирать автоматически |
| products_storage_id | int | Нет | Склад, на который поступают произведенные продукты |
Строка products:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| id | int | id или sku | ID продукта |
| sku | string | id или sku | Артикул продукта |
| amount | float | Да | Количество, больше 0 |
| notes | string | Нет | Комментарий к строке |
Продукт указывается по id или sku (ищется и по альтернативным SKU). Один продукт можно указать в нескольких строках.
Новое производство создается в статусе из настройки Статус нового производства по умолчанию.
Пример запроса
{
"date": "2026-10-06",
"name": "Партия столов",
"products": [
{
"id": 512,
"amount": 10,
"notes": "Покрыть маслом в два слоя"
},
{
"sku": "P-CHAIR-01",
"amount": 40
}
],
"materials_storage_id": 3998,
"products_storage_id": 4001,
"produce_subproducts": 1
}
Пример ответа
{
"success": true,
"production_id": 39978,
"num": 152,
"status": 0
}
В ответе приходят ID, номер и код статуса нового производства.
Ошибки
| Ошибка | Причина |
|---|---|
| No products in input | Не передан products или передан пустой массив |
| Products is not an array | products не массив |
| Line 0 of products must be an object | Строка products не объект (вместо 0 будет номер строки) |
| SKU or id not set for product 0 | В строке нет ни id, ни sku |
| Product with id 512 not found | Продукт не найден или удален (для артикула: Product with SKU "P-CHAIR-01" not found) |
| Amount must be greater than 0 for product with id 512 | Количество не число или не больше 0 после округления |
| Invalid notes value for product with id 512. Must be a string | notes в строке не строка |
| Notes for product with id 512 are too long: maximum 10000 characters | Комментарий строки длиннее 10 000 символов |
| Storage ID is not set | Передан products_storage_id, равный 0 |
| Storage ID not found | Склад не найден или удален |
| Date is not a valid date in format YYYY-MM-DD | Неверный формат даты |