Решение проблемы неправильного отображения количества товара в WooCommerce после отмены заказа

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

Проблема: после отмены или возврата заказа количество товара на складе не обновляется корректно, из-за чего в магазине отображается неправильный остаток. Это приводит к неверным данным о наличии и может вызвать потерю продаж или недовольство клиентов.

Чтобы проверить наличие проблемы, необходимо:

• Создать тестовый заказ с несколькими товарами, убедиться, что складские запасы уменьшились.
• Отменить или вернуть этот заказ через админку WooCommerce.
• Проверить, обновилось ли количество товара в каталоге и на странице товара.
• Сравнить данные в базе данных в таблице wp_postmeta для ключа _stock перед и после отмены.

Основные причины возникновения проблемы

• Конфликты с плагинами, влияющими на управление запасами.
• Неправильная настройка статусов заказов и их связанного обновления складских запасов.
• Кастомные функции или хуки, которые не вызывают обновление склада при отмене заказа.

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

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

1. Добавляем функцию для восстановления запасов при отмене заказа

В файл functions.php вашей темы или в кастомный плагин вставьте следующий код:

add_action('woocommerce_order_status_cancelled', 'restore_stock_on_order_cancelled', 10, 1);
add_action('woocommerce_order_status_refunded', 'restore_stock_on_order_cancelled', 10, 1);

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

    // Восстанавливаем складские запасы для каждого товара в заказе
    foreach ($order->get_items() as $item) {
        $product = $item->get_product();
        if ($product && $product->managing_stock()) {
            $qty = $item->get_quantity();
            $product->increase_stock($qty);
            $product->save();
        }
    }
}

Этот код слушает события смены статуса заказа на отменённый (cancelled) или возврат (refunded), и восстанавливает количество товаров на складе.

2. Проверяем конфликты с плагинами кэширования

Если у вас включено кэширование страниц (например, через WP Rocket, LiteSpeed Cache, или серверное кэширование), то отображение количества может не обновляться мгновенно. Для решения:

• Добавьте исключения для страниц товаров и корзины в настройках кэша.
• Используйте AJAX для обновления количества на клиентской стороне.

3. Обновляем страницу товара и корзину через AJAX

Для мгновенного обновления количества можно добавить AJAX-запрос, который будет подтягивать актуальный остаток после отмены заказа (например, при работе с фронтендом администратора или кастомными интерфейсами). Пример простого AJAX-запроса для получения текущего склада товара:

add_action('wp_ajax_get_product_stock', 'ajax_get_product_stock');
function ajax_get_product_stock() {
    if (!isset($_POST['product_id'])) {
        wp_send_json_error('Product ID missing');
    }
    $product_id = intval($_POST['product_id']);
    $product = wc_get_product($product_id);
    if (!$product) {
        wp_send_json_error('Invalid product');
    }
    $stock_qty = $product->get_stock_quantity();
    wp_send_json_success(array('stock' => $stock_qty));
}

Затем на фронтенде можно отправлять AJAX-запрос и обновлять информацию о наличии без перезагрузки страницы.

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

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

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

• Код не срабатывает при смене статуса заказа
  Проверьте, что используемые хуки woocommerce_order_status_cancelled и woocommerce_order_status_refunded не переопределяются другими плагинами, а функция подключена корректно.
• Запасы не восстанавливаются у товаров с вариациями
  Убедитесь, что вы используете $item->get_product(), а не просто ID, чтобы получить объект вариации. В противном случае вызов increase_stock() не сработает.
• Кэширование мешает обновлению данных
  Отключите кэширование на страницах с динамическим содержимым (корзина, каталог), либо реализуйте AJAX-обновление.
• Ошибка синхронизации при массовом обновлении заказов
  Используйте WP CLI или скрипты, чтобы массово пересчитать запасы, если были внесены изменения вручную или через сторонние инструменты.

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

• При работе с AJAX убедитесь, что запросы проверяются на права доступа и nonce-токены, чтобы избежать CSRF-атак.
• Не увеличивайте количество запросов к базе данных без необходимости — кэшируйте результаты или обновляйте запасы только при реальных изменениях статуса заказа.
• Тестируйте изменения на staging-сервере перед внедрением на живом сайте.

Сравнение способов решения проблемы

Метод	Преимущества	Недостатки
Хуки WooCommerce (код)	Точный контроль, автоматизация, без сторонних плагинов	Требует навыков разработки, возможны конфликты с плагинами
Плагины для управления запасами	Простота установки, поддержка, UI	Могут нагружать сайт, иногда платные, ограниченная кастомизация
Обновление через AJAX	Мгновенное обновление отображения, улучшенный UX	Дополнительная разработка, нагрузка на сервер при большом трафике