Производство
От Максим
От Максим
Методы для производства и его статусов
Производство
Производство: выпуск продуктов по их составу. Вы передаете только продукты и количество, а Controlata сама рассчитывает расход материалов, использованных продуктов и ресурсов по составам продуктов и себестоимость по FIFO. Через API производство можно создавать, редактировать и удалять, менять его статус, получать список и данные производства. Пути методов указаны относительно базового адреса API, а общие для всех методов правила (авторизация, формат запросов, частичное редактирование, постраничная выдача) описаны в статьях Обзор API и Общие правила. Методы | Метод | Что делает | |---|---| | v1/production/get_statuses | Возвращает статусы производства компании | | v1/production/add | Создает производство | | v1/production/edit | Изменяет производство | | v1/production/delete | Удаляет производство | | v1/production/update_status | Меняет статус производства | | v1/production/get_list | Возвращает список производств | | v1/production/get_entry | Возвращает производство с продуктами и расходом |
Статусы производства
Возвращает статусы производства компании в том порядке, в каком они идут в Controlata. Статусы могут быть настроены индивидуально, поэтому получайте коды этим методом, а не задавайте их в интеграции вручную. v1/production/get_statuses.php Параметры Метод не принимает параметров, тело запроса можно не передавать. Ответ Массив statuses. | Поле | Тип | Описание | |---|---|---| | code | int | Код статуса. Его передают в status методов v1/production/update_status и v1/production/get_list | | name | string | Название статуса | Коды идут по порядку, начиная с 0. Если компания не настраивала статусы, возвращаются статусы по умолчанию: | Код | Статус | |---|---| | 0 | План | | 1 | В процессе | | 2 | Сделано | Статусы, созданные в компании, приходят с названиями, которые им дали в Controlata. Пример запроса {} Пример ответа { "success": true, "statuses": [ { "code": 0, "name": "План" }, { "code": 1, "name": "В процессе" }, { "code": 2, "name": "Сделано" } ] } Ошибки Метод возвращает только общие ошибки авторизации и лимита запросов, см. Обзор API.
Создание производства
Создает производство. Расход материалов, использованных продуктов и ресурсов 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 | Неверный формат даты |
Редактирование производства
Изменяет производство. Меняются только переданные поля, остальные остаются прежними. v1/production/edit.php Параметры | Поле | Тип | Обязательное | Описание | |---|---|---|---| | production_id | int | Да | ID производства | | products | array | Нет | Выпускаемые продукты: id или sku и amount, как в v1/production/add. Заменяют текущие целиком | | 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 | Нет | Склад, на который поступают произведенные продукты | Статус этим методом не меняется, для него есть v1/production/update_status. Номер изменить нельзя. Пример запроса { "production_id": 39978, "products": [ { "id": 512, "amount": 12 } ], "notes": "Добавили два стола" } Пример ответа { "success": true } Ошибки | Ошибка | Причина | |---|---| | No production_id in input | Не передан production_id | | Production not found or access denied | Производство не найдено или удалено | | Products of a production linked to a sale cannot be changed. Edit the sale instead | Изменение продуктов производства под заказ | | No products in input | Передан пустой массив products | | Products is not an array | products не массив | | Product with id 512 not found | Продукт не найден или удален | | Amount must be greater than 0 for product with id 512 | Количество не число или не больше 0 после округления | | Storage ID is not set | Передан products_storage_id, равный 0, или пустой склад | | Storage ID not found | Склад не найден или удален | | Date is not a valid date in format YYYY-MM-DD | Неверный формат даты | Остальные ошибки строк products такие же, как в v1/production/add.
Удаление производства
Удаляет производство. v1/production/delete.php Параметры | Поле | Тип | Обязательное | Описание | |---|---|---|---| | production_id | int | Да | ID производства | Удаление нельзя отменить. Производство под заказ (order_id больше 0) этим методом не удаляется: отключите производство в заказе или удалите заказ, см. Создание заказа. Пример запроса { "production_id": 39978 } Пример ответа { "success": true } Ошибки | Ошибка | Причина | |---|---| | No production_id in input | Не передан production_id | | Production not found or access denied | Производство не найдено или уже удалено | | A production linked to a sale cannot be deleted. Edit the sale instead | Производство создано под заказ |
Смена статуса производства
Меняет статус производства. От статуса зависит, списаны ли материалы, использованные продукты и ресурсы и поступили ли произведенные продукты на склад. v1/production/update_status.php Параметры | Поле | Тип | Обязательное | Описание | |---|---|---|---| | production_id | int | Да | ID производства | | status | int | Да | Код статуса из v1/production/get_statuses | Пример запроса { "production_id": 39978, "status": 2 } Пример ответа { "success": true } Ошибки | Ошибка | Причина | |---|---| | No production_id in input | Не передано обязательное поле (вместо production_id будет имя поля) | | Invalid status value. Must be one of: 0, 1, 2 | Код не из списка статусов компании. В тексте ошибки перечислены допустимые коды | | Production not found or access denied | Производство не найдено или удалено |
Получение списка производств
Возвращает производства компании, от новых к старым: по дате, а внутри одной даты по номеру. v1/production/get_list.php Параметры | Поле | Тип | Обязательное | Описание | |---|---|---|---| | date_from | string | Нет | Производства с этой даты включительно, YYYY-MM-DD | | date_to | string | Нет | Производства по эту дату включительно, YYYY-MM-DD | | status | int | Нет | Код статуса из v1/production/get_statuses | | limit | int | Нет | Размер страницы, от 1 до 1000 | | offset | int | Нет | Сколько записей пропустить | Без limit возвращается весь список. Подробнее о постраничной выдаче в статье Общие правила. Ответ Массив production с полями производства (без продуктов и расхода, их возвращает Получение данных производства): | Поле | Тип | Описание | |---|---|---| | id | int | ID производства | | num | int | Номер. Присваивается автоматически | | name | string | Название | | date | string | Дата производства, YYYY-MM-DD | | status | int | Код статуса из Статусов производства | | order_id | int | ID заказа, под который создано производство. 0, если не связано с заказом | | produce_subproducts | int | 1, если заготовки производятся вместе с продуктами | | materials_storage_id | int | Склад, с которого списываются материалы. 0, если склад выбирается автоматически | | materials_storage_name | string | Название склада материалов | | products_storage_id | int | Склад, на который поступают произведенные продукты | | products_storage_name | string | Название склада произведенных продуктов | | subproducts_storage_id | int | Склад, с которого списываются использованные продукты. 0, если выбирается автоматически | | subproducts_storage_name | string | Название склада использованных продуктов | | cost | float | Себестоимость всего производства | | price | float | Стоимость произведенных продуктов по их цене продажи | | amount | float | Общее количество продуктов. null, если у продуктов разные единицы измерения | | lines | int | Количество строк продуктов | | notes | string | Заметки | Поле total содержит общее число производств, подходящих под фильтры. Пример запроса { "date_from": "2026-10-01", "status": 0, "limit": 100, "offset": 0 } Пример ответа { "success": true, "production": [ { "id": 39978, "num": 152, "name": "Партия столов", "date": "2026-10-06", "status": 0, "order_id": 0, "produce_subproducts": 1, "materials_storage_id": 3998, "materials_storage_name": "Главный", "products_storage_id": 4001, "products_storage_name": "Готовая продукция", "subproducts_storage_id": 0, "subproducts_storage_name": null, "cost": 184250, "price": 390000, "amount": 50, "lines": 2, "notes": "" } ], "total": 1 } Ошибки | Ошибка | Причина | |---|---| | Date is not a valid date in format YYYY-MM-DD | Неверный формат date_from или date_to | | Invalid status value. Must be a number | status не число | | Invalid limit value. Must be between 1 and 1000 | Неверный limit | | Offset requires limit | Передан offset без limit |
Получение данных производства
Возвращает производство: его поля, выпускаемые продукты и расход материалов, использованных продуктов и ресурсов. v1/production/get_entry.php Параметры | Поле | Тип | Обязательное | Описание | |---|---|---|---| | production_id | int | Да | ID производства | Ответ Объект production с полями производства: | Поле | Тип | Описание | |---|---|---| | id | int | ID производства | | num | int | Номер. Присваивается автоматически | | name | string | Название | | date | string | Дата производства, YYYY-MM-DD | | status | int | Код статуса из Статусов производства | | order_id | int | ID заказа, под который создано производство. 0, если не связано с заказом | | produce_subproducts | int | 1, если заготовки производятся вместе с продуктами | | materials_storage_id | int | Склад, с которого списываются материалы. 0, если склад выбирается автоматически | | materials_storage_name | string | Название склада материалов | | products_storage_id | int | Склад, на который поступают произведенные продукты | | products_storage_name | string | Название склада произведенных продуктов | | subproducts_storage_id | int | Склад, с которого списываются использованные продукты. 0, если выбирается автоматически | | subproducts_storage_name | string | Название склада использованных продуктов | | cost | float | Себестоимость всего производства | | price | float | Стоимость произведенных продуктов по их цене продажи | | amount | float | Общее количество продуктов. null, если у продуктов разные единицы измерения | | lines | int | Количество строк продуктов | | notes | string | Заметки | и четырьмя массивами строк. products: произведенные продукты. | Поле | Тип | Описание | |---|---|---| | id | int | ID продукта | | sku | string | Артикул | | name | string | Название | | amount | float | Количество | | unit | string | Единица измерения | | cost | float | Себестоимость строки | | price | float | Стоимость строки по цене продажи продукта | | notes | string | Комментарий к строке. Пустая строка, если его нет | materials: расход материалов по всему производству. Если материал списан с нескольких складов, для каждого склада приходит отдельная строка. | Поле | Тип | Описание | |---|---|---| | id | int | ID материала | | sku | string | Артикул | | name | string | Название | | storage_id | int | Склад, с которого списан материал | | amount | float | Количество | | unit | string | Единица измерения | | cost | float | Себестоимость | subproducts: использованные продукты из состава выпускаемых. Если заготовки производятся (produce_subproducts равно 1), они сюда не попадают: вместо них в materials и resources входит расход по их составу. | Поле | Тип | Описание | |---|---|---| | id | int | ID продукта | | sku | string | Артикул | | name | string | Название | | storage_id | int | Склад, с которого списан продукт | | amount | float | Количество | | unit | string | Единица измерения | | cost | float | Себестоимость | resources: использованные ресурсы. | Поле | Тип | Описание | |---|---|---| | id | int | ID ресурса | | name | string | Название | | type | string | Тип расчета: «rate» фиксированная ставка, «percent» процент, «amortized» амортизация | | amount | float | Количество | | unit | string | Единица измерения | | cost | float | Стоимость | Массив products можно отправить в v1/production/edit без изменений. Расход через API не меняется: он рассчитывается по составам продуктов. Пример запроса { "production_id": 39978 } Пример ответа { "success": true, "production": { "id": 39978, "num": 152, "name": "Партия столов", "date": "2026-10-06", "status": 1, "order_id": 0, "produce_subproducts": 0, "materials_storage_id": 3998, "materials_storage_name": "Главный", "products_storage_id": 4001, "products_storage_name": "Готовая продукция", "subproducts_storage_id": 3998, "subproducts_storage_name": "Главный", "cost": 61540, "price": 130000, "amount": 10, "lines": 1, "notes": "", "products": [ { "id": 512, "sku": "P-TABLE-01", "name": "Стол обеденный", "amount": 10, "unit": "шт", "cost": 61540, "price": 130000, "notes": "Покрыть маслом в два слоя" } ], "materials": [ { "id": 2051, "sku": "M010", "name": "Доска дубовая", "storage_id": 3998, "amount": 0.4, "unit": "куб. м", "cost": 54000 } ], "subproducts": [ { "id": 530, "sku": "P-LEG-01", "name": "Ножка стола", "storage_id": 3998, "amount": 40, "unit": "шт", "cost": 6000 } ], "resources": [ { "id": 77, "name": "Работа столяра", "type": "rate", "amount": 20, "unit": "ч", "cost": 1540 } ] } } Ошибки | Ошибка | Причина | |---|---| | No production_id in input | Не передан production_id | | Production not found or access denied | Производство не найдено или удалено |