Автоматический возврат товара в WooCommerce после отмены заказа

В чем суть проблемы с возвратом товаров после отмены заказа в WooCommerce

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

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

• Сравните количество товара на складе до и после отмены заказа.
• Проверьте статус заказа: отменён ли он через WooCommerce (статус cancelled или refunded).
• Откройте детали заказа и убедитесь, что количество товаров не было возвращено в запас.
• Включите логирование WooCommerce Inventory, если используете расширения для управления запасами, чтобы увидеть фактические операции.

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

Реализуем обработку события смены статуса заказа на "cancelled" и "refunded", чтобы автоматически возвращать количество товаров на склад.

add_action('woocommerce_order_status_cancelled', 'custom_restore_stock_on_cancelled_order');
add_action('woocommerce_order_status_refunded', 'custom_restore_stock_on_cancelled_order');

function custom_restore_stock_on_cancelled_order($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Проверяем, не была ли уже восстановлена складская доступность
    if (get_post_meta($order_id, '_stock_restored', true)) {
        return;
    }

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

        $qty = $item->get_quantity();
        // Увеличиваем складское количество
        wc_update_product_stock($product, $qty, 'increase');
    }

    // Отмечаем, что склад был восстановлен для этого заказа
    update_post_meta($order_id, '_stock_restored', 1);
}

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

Почему важна проверка мета-поля _stock_restored?

Чтобы избежать двойного возврата при повторных сменах статуса, мы ставим флаг. Без этого при повторном выставлении статуса "cancelled" количество будет увеличено повторно, и склад будет «переполнен».

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

• Создайте тестовый заказ с товаром, у которого управление складом включено.
• Отмените заказ через админку WooCommerce, установив статус на "Отменён" или "Возвращён".
• Проверьте, что количество товара в карточке продукта увеличилось на количество из заказа.
• Если используете кэширование или облачное хранение, очистите кэш и обновите данные.

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

• Отсутствует управление запасами у товара: если у товара выключена опция управления запасами, функция возврата не сработает. Проверьте в настройках товара manage_stock.
• Двойное увеличение склада: если нет проверки флага _stock_restored, при нескольких сменах статуса склад завышается.
• Конфликты с плагинами: некоторые плагины управления запасами могут перезаписывать поведение WooCommerce. В таком случае нужно адаптировать код под их API.
• Кеширование и задержки: иногда изменения не видны из-за кеша, проверьте и очистите кеш.

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

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

Сравнение вариантов решения возврата товара в WooCommerce