Событие перед изменением товара

[OnBeforeUpdateItemProduct] - событие перед изменением товара

Событие срабатывает перед обновлением полей товара торгового каталога через \Bitrix\Catalog\Model\Product::update(). Работает со всеми сущностями из МС кроме модификаций (variant). Для модификаций есть отдельное событие ниже.

Описание события

Параметры события

Параметр	Тип	Описание
entity	string	Сущность: product, bundle, service
currentItem	array	Данные о текущем элементе (содержит BX и MS)
productCurrentItem	array	Текущие поля товара в торговом каталоге
productUpdate	array	Массив данных для передачи в Product::update()

Структура currentItem

[
    'BX' => [  // элемент инфоблока Битрикс
        'ID' => 1234,
        'IBLOCK_ID' => 5,
        'NAME' => 'Название товара',
        'XML_ID' => 'abc123externalcode',
        'ACTIVE' => 'Y',
        // ... другие поля элемента инфоблока
    ],
    'MS' => $itemMs  // объект из МойСклад
]

Структура productCurrentItem

[
    'ID' => 1234,
    'TYPE' => 1,                // 1 = простой, 3 = с ТП, 6 = комплект
    'QUANTITY' => 10.0,
    'WEIGHT' => 500.0,          // вес в граммах
    'WIDTH' => 0.0,
    'LENGTH' => 0.0,
    'HEIGHT' => 0.0,
    'MEASURE' => 5,             // ID единицы измерения
    'VAT_ID' => 1,              // ID ставки НДС
    'VAT_INCLUDED' => 'Y',     // НДС включен в цену
    'UF_PRODUCT_GROUP' => 0,   // маркировка
    'BARCODE_LIST' => [...]    // штрихкоды (если загружены)
]

Структура productUpdate

Содержит только изменённые поля:

[
    'WEIGHT' => 750.0,          // вес
    'WIDTH' => 10.0,            // ширина
    'LENGTH' => 20.0,           // длина
    'HEIGHT' => 5.0,            // высота
    'MEASURE' => 6,             // единица измерения
    'TYPE' => 3,                // тип товара (TYPE_SKU если есть модификации)
    'VAT_ID' => 2,              // ставка НДС
    'VAT_INCLUDED' => 'N',     // НДС не включен
]

Возвращаемое значение

Верните EventResult::SUCCESS с модифицированным массивом $productUpdate.

return new \Bitrix\Main\EventResult(\Bitrix\Main\EventResult::SUCCESS, $productUpdate);

Пример кода

\Bitrix\Main\EventManager::getInstance()->addEventHandler(
    'rbs.moyskladstocks',
    'OnBeforeUpdateItemProduct',
    'OnBeforeUpdateItemProductHandler'
);

function OnBeforeUpdateItemProductHandler(\Bitrix\Main\Event $event)
{
    $eventParams = $event->getParameters();

    $entity = $eventParams['entity']; //сущность в МойСклад, которая обрабатывается (три варианта значения: product / bundle / service)
    $currentItem = $eventParams['currentItem']; //данные о текущем элементе инфоблока, подробнее ниже

    $itemBx = $currentItem['BX']; //текущий элемент инфоблока, доступ к полям через массив
    $item = $currentItem['MS']; //этот же товар из МС, доступ к полям через поля объекта

    //это массив данных, который затем передается в \Bitrix\Catalog\Model\Product::update();
    $productUpdate = $eventParams['productUpdate'];

    //Отправляем \Bitrix\Main\EventResult::SUCCESS только в случае, если нужно поменять данные перед отправкой
    return new \Bitrix\Main\EventResult(\Bitrix\Main\EventResult::SUCCESS, $productUpdate);
}

---

[OnBeforeUpdateItemVariant] - событие перед изменением товара (для модификаций)

Аналогично OnBeforeUpdateItemProduct, но срабатывает только для модификаций (variant). Дополнительно передаёт данные о родительском товаре.

Описание события

Параметры события

Параметр	Тип	Описание
entity	string	Всегда variant
currentItem	array	Данные о текущем элементе (содержит BX и MS)
parentItem	array	Данные о родительском товаре
productCurrentItem	array	Текущие поля товара (торг. предложения) в торговом каталоге
productUpdate	array	Массив данных для передачи в Product::update()

Структура parentItem

[
    'parentId' => 5678,  // ID родительского товара в Битрикс
    'parentProductParams' => [  // данные родительского товара в торговом каталоге
        'ID' => 5678,
        'TYPE' => 3,
        'QUANTITY' => 0.0,
        'WEIGHT' => 500.0,
        'WIDTH' => 10.0,
        'LENGTH' => 20.0,
        'HEIGHT' => 5.0,
        'MEASURE' => 5,
        'VAT_ID' => 1,
        'VAT_INCLUDED' => 'Y',
        'UF_PRODUCT_GROUP' => 0,
    ]
]

Возвращаемое значение

Верните EventResult::SUCCESS с модифицированным массивом $productUpdate.

return new \Bitrix\Main\EventResult(\Bitrix\Main\EventResult::SUCCESS, $productUpdate);

Пример кода

\Bitrix\Main\EventManager::getInstance()->addEventHandler(
    'rbs.moyskladstocks',
    'OnBeforeUpdateItemVariant',
    'OnBeforeUpdateItemVariantHandler'
);

function OnBeforeUpdateItemVariantHandler(\Bitrix\Main\Event $event)
{
    $eventParams = $event->getParameters();

    $entity = $eventParams['entity']; //сущность в МойСклад, которая обрабатывается (только variant)
    $currentItem = $eventParams['currentItem']; //данные о текущем элементе инфоблока

    $itemBx = $currentItem['BX']; //текущий элемент инфоблока, доступ к полям через массив
    $item = $currentItem['MS']; //этот же товар из МС, доступ к полям через поля объекта

    $parentItem = $eventParams['parentItem']; //данные о родительском товаре в битриксе
    $parentItemId = $parentItem['parentId']; // ID родительского товара в битриксе
    $parentItemProductParams = $parentItem['parentProductParams']; //данные родительского товара в торговом каталоге

    //это массив данных, который затем передается в \Bitrix\Catalog\Model\Product::update();
    $productUpdate = $eventParams['productUpdate'];

    //Отправляем \Bitrix\Main\EventResult::SUCCESS только в случае, если нужно поменять данные перед отправкой
    return new \Bitrix\Main\EventResult(\Bitrix\Main\EventResult::SUCCESS, $productUpdate);
}