Редактирование продукта

Изменяет продукт и его состав. Меняются только переданные поля, остальные остаются прежними. Подробнее о частичном редактировании в статье Общие правила.

v1/products/edit.php

Параметры

Чтобы очистить поле, передайте пустую строку. Чтобы снять все категории, поставщиков или альтернативные артикулы, передайте пустой массив.

Как работает

• Состав. Формат строк описан в разделе «Состав продукта» статьи Продукты. Если передан хотя бы один из массивов materials и products, материалы и заготовки заменяются целиком, а непереданный массив считается пустым. Например, если передать только materials, заготовки из состава удалятся. Ресурсы меняются, только если передан resources.
• Размер партии. Количества в составе хранятся на партию. Если изменить batch_size без состава, они останутся прежними, а расход на единицу продукта пересчитается: 0.5 куб. м на партию из 10 штук дает 0.05 на штуку, а на партию из 20 штук уже 0.025. Чтобы сохранить расход на единицу, передайте вместе с batch_size и состав с новыми количествами.
• Себестоимость. После изменения состава, ресурсов, размера партии или цены продажи Controlata пересчитывает себестоимость продукта и продуктов, в состав которых он входит. Производства этого продукта получают отметку bom_changed: состав изменился после их создания. Если производств и поставок продукта еще не было, по новой себестоимости переоцениваются начальный остаток и корректировки остатка.
• Единица измерения. Если новая единица из той же группы (например, «г» вместо «кг»), Controlata пересчитывает остатки, историю движений и минимальный остаток. Если цена не передана, она тоже пересчитывается: 500 за кг станет 0.5 за г. Сменить группу (например, «шт» на «кг») нельзя, если продукт входит в состав других продуктов.
• Минимальный остаток задается на конкретном складе, поэтому вместе с ним нужен storage_id. Продукт должен числиться на этом складе (см. Продукты).
• Категории определяют, на каких складах числится продукт. После их изменения продукт появится на складах с новыми категориями и пропадет со складов прежних категорий, если остаток там нулевой и нет запланированных операций.

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

Новая цена продажи и состав материалов. Заготовки не переданы, поэтому удалятся из состава, ресурсы останутся прежними.

{
    "product_id": 3120,
    "price": 47000,
    "materials": [
        {
            "id": 2051,
            "amount_per_batch": 0.6,
            "unit": "куб. м",
            "loss_percent": 5
        },
        {
            "id": 2060,
            "amount_per_batch": 400,
            "unit": "шт"
        }
    ]
}

Изменить только минимальный остаток:

{
    "product_id": 3120,
    "minimum": 3,
    "storage_id": 3999
}

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

{
    "success": true
}

Ошибки

Ошибки в строках materials, products и resources перечислены в разделе «Состав продукта» статьи Продукты.