WooCommerce: автоматическое обновление остатков при возврате и отмене заказа

Диагностика проблемы: почему остатки не обновляются при возврате или отмене заказа

Часто в WooCommerce встречается ситуация, когда после возврата товара клиентом или отмены заказа количество товара на складе не обновляется. Это ведёт к неправильному отображению остатков, что может привести к ошибочным продажам или отсутствию товара в наличии.

Для начала важно проверить настройки управления запасами в WooCommerce и убедиться, что включён учёт остатков. Далее стоит изучить, корректно ли работает логика возвратов и отмен, а также не блокируют ли обновления сторонние плагины или кастомный код.

Как проверить, что остатки не обновляются

• Создайте тестовый заказ с несколько товаров, количество которых ограничено.
• Отмените заказ или создайте возврат через панель WooCommerce.
• Проверьте изменение количества товара в админке в разделе «Товары».
• Если количество не изменилось — проблема налицо.

Пошаговое решение: автоматическое обновление запасов при возврате и отмене

1. Включение управления запасами в WooCommerce

Перейдите WooCommerce > Настройки > Товары > Запасы и убедитесь, что опция «Включить управление запасами» активна.

2. Добавление кода для обновления остатков при возврате заказа

WooCommerce по умолчанию обновляет остатки при отмене заказа, но не всегда при возврате. Для решения этой задачи добавим хук, который увеличит количество товаров при возврате:

add_action('woocommerce_order_refunded', 'wp0_update_stock_after_refund', 10, 2);
function wp0_update_stock_after_refund($order_id, $refund_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    foreach ($order->get_items() as $item_id => $item) {
        $product = $item->get_product();
        if (!$product || !$product->managing_stock()) continue;

        $qty = $item->get_quantity();
        $product->increase_stock($qty);
        $product->save();
    }
}

Этот код перебирает все товары в заказе и увеличивает их количество на складе на возвратное количество.

3. Проверка обновления остатков при отмене заказа

Стандартно WooCommerce уменьшает остатки при оформлении заказа и возвращает их при отмене. Если это не происходит, возможно конфликт с плагинами или кастомным кодом. Для отладки временно отключите все плагины, кроме WooCommerce, и проверьте логику повторно.

Проверка результата после внедрения

• Создайте тестовый заказ с ограниченным количеством товара.
• Оформите возврат части товаров через WooCommerce > Заказы > Редактировать заказ > Добавить возврат.
• Обратите внимание, что после возврата количество товара увеличивается на складе.
• Отмените тестовый заказ и проверьте, что количество товара также обновилось.
• Проверьте логи ошибок PHP и WooCommerce, чтобы убедиться, что нет сбоев.

Частые ошибки и их исправление

• Остатки не изменяются при возврате: не подключен хук woocommerce_order_refunded или кастомный код содержит ошибки. Проверьте синтаксис и наличие функции.
• Конфликт плагинов: некоторые плагины управления заказами или возвратами могут перезаписывать поведение. Попробуйте отключить их для теста.
• Управление запасами отключено: без включенного учёта остатков обновление не произойдет. Проверьте настройки WooCommerce.
• Кэширование: если остатков не видно обновленных, попробуйте очистить кэш сайта и браузера.

Практические советы по безопасности и производительности

• Добавляйте кастомный код в дочернюю тему или в отдельный плагин, чтобы избежать потери при обновлениях.
• Используйте wc_get_order() и методы объектов WooCommerce для корректной работы с данными.
• Проверяйте наличие товара и управление запасами перед изменением остатков — это снизит вероятность ошибок.
• Для крупных магазинов с высокой нагрузкой контролируйте производительность, избегая лишних операций с базой в циклах.
• Настройте журналирование возвратов и изменений остатков для аудита и отладки.

Сравнение подходов к обновлению запасов при возврате