Заказы

Списание по статусу

Перед сохранением нового статуса (msOnBeforeChangeOrderStatus) компонент проверяет, что списание возможно: нет конфликта с ms3Variants, хватает остатка, для строк заказа удаётся подобрать комбинацию. Если проверка не проходит, статус не меняется.

После смены статуса (msOnChangeOrderStatus), когда заказ попадает в ms3remains_deduct_statuses, по каждой строке списывается остаток:

1. В ms3remains_order_deductions пишется строка (order_id, order_product_id, status_id). Если такая строка уже есть, списание пропускается. Повторный перевод в тот же статус не списывает дважды.
2. Ещё раз проверяется доступность.
3. Остаток уменьшается через changeBy(-qty).

Смена статуса идёт в транзакции БД (обёртка OrderStatusService). Если списание падает после сохранения статуса, транзакция откатывает и статус, и остатки.

Опции строки заказа читаются из msOrderProduct.options. Комбинация считается так же, как на вкладке остатков, поэтому списывается именно та строка, которую видит менеджер.

Изменение строки заказа после списания

Количество и опции строки меняйте до перевода заказа в статус списания. Компонент не корректирует остаток при правке уже списанной строки (msOnBeforeUpdateOrderProduct не слушается).

Если заказ уже списан, сначала переведите его в статус возврата, поправьте строки, затем снова спишите. Так остаток не разъедется, и не появляется второй путь записи рядом со сменой статуса.

Возврат

Когда заказ попадает в статус из ms3remains_refund_statuses, списанное по этому заказу возвращается: строки списаний помечаются refundedon, остаток увеличивается обратно. Удаление заказа (msOnRemoveOrder) работает так же.

Возврат идемпотентен: уже возвращённые строки не возвращаются повторно.

Проверки в корзине

Три переключателя управляют проверками до заказа:

Настройка	Событие	Что проверяет
ms3remains_check_before_cart	добавление в корзину	остаток комбинации
ms3remains_check_before_order	оформление заказа	остаток всех строк
ms3remains_check_options	оба события	что выбраны все отслеживаемые опции (кроме строк с _variant_id)

Поведение проверок:

• товар без строк остатка — неотслеживаемый, проверки пропускаются
• не выбраны опции из ms3remains_option_keys (и нет _variant_id) — ошибка «Выберите опции» (ms3remains_choose_options)
• выбран вариант ms3Variants (_variant_id) — проверка check_options не требует ключей из option_keys, строку остатка задаёт вариант
• остатка не хватает — ошибка «Недостаточно товара на складе» с доступным количеством в плейсхолдере [[+available]] (ms3remains_err_insufficient_stock)
• комбинацию подобрать нельзя (чужой вариант, битые опции) — ошибка ms3remains_err_invalid_stock_identity

check_options действует только когда включён сам компонент и хотя бы одна из проверок корзины/заказа.

Неотслеживаемые товары

Товар без строк в ms3remains_remains продаётся без ограничений: проверки корзины его пропускают, списание по заказу его пропускает. Чтобы начать отслеживать товар, задайте ему остаток во вкладке «Остатки» или через CSV.

Чтобы перестать отслеживать, обнулите строки остатка и удалите их через CSV с пустым количеством либо напрямую в БД. В UI удаления строк нет: нулевой остаток означает «нет в наличии», а не «не отслеживается».