WooCommerce: как автоматически удалять товары из заказа после его отмены

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

Стандартное поведение WooCommerce при отмене заказа не предусматривает автоматическое удаление товаров из этого заказа. Это может привести к путанице при повторном использовании заказов для отчетов или интеграций, а также к некорректному учету остатков на складе, если не активированы соответствующие настройки возврата.

Проверьте, действительно ли заказ отменен и его статус установлен в cancelled или refunded. Для этого в админке WooCommerce перейдите в Заказы и убедитесь в статусе проблемного заказа.

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

1. Использование хука для обработки смены статуса заказа

Добавим код, который при переводе заказа в статус отменен (cancelled) удалит все товары из позиции заказа.

add_action('woocommerce_order_status_cancelled', 'wpcompany_clear_order_items_on_cancelled', 10, 1);
function wpcompany_clear_order_items_on_cancelled($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Получаем все товары заказа
    $items = $order->get_items();
    if (empty($items)) return;

    foreach ($items as $item_id => $item) {
        $order->remove_item($item_id);
    }

    $order->calculate_totals();
    $order->save();
}

2. Обработка статуса "Возвращен" (refunded)

Если в вашем магазине возвраты оформляются через статус refunded, аналогично можно очистить товары заказа:

add_action('woocommerce_order_status_refunded', 'wpcompany_clear_order_items_on_refunded', 10, 1);
function wpcompany_clear_order_items_on_refunded($order_id) {
    wpcompany_clear_order_items_on_cancelled($order_id);
}

3. Проверка и тестирование

• Создайте тестовый заказ с несколькими товарами.
• Переведите статус заказа в cancelled или refunded.
• Обновите страницу заказа в админке и убедитесь, что список товаров пуст.
• Проверьте, что сумма заказа стала равна 0.

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

Чтобы проверить работу скрипта, можно использовать простой сниппет для вывода информации после смены статуса:

add_action('woocommerce_order_status_cancelled', function($order_id) {
    $order = wc_get_order($order_id);
    error_log('Товары после очистки: ' . print_r($order->get_items(), true));
});

В логе сервера не должно отображаться товаров после отмены заказа.

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

• Ошибка: Товары не удаляются после смены статуса.
  Причина: Код добавлен не в functions.php активной темы или конфликт с плагинами.
  Решение: Проверьте место добавления кода, временно отключите другие плагины для теста.
• Ошибка: Итоговая сумма заказа не обновляется.
  Причина: Метод calculate_totals() не вызван или вызван неправильно.
  Решение: Убедитесь, что после удаления товаров вызывается $order->calculate_totals(); и $order->save();.
• Ошибка: Статус заказа не меняется на cancelled.
  Причина: Статус меняется вручную, но не через интерфейс или API.
  Решение: Для автоматизации убедитесь, что смена статуса происходит корректно, чтобы сработали хуки.

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

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

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

Метод	Плюсы	Минусы	Когда использовать
Код в functions.php (хуки статуса)	Простой, не требует плагинов, быстро работает	Требует базовых знаний PHP, возможны конфликты с другими плагинами	Малые и средние магазины, кастомные решения
Плагины для управления заказами	Готовые настройки, поддержка, удобный интерфейс	Дополнительные ресурсы, возможность избыточности	Крупные магазины, нет времени на кодинг
Внешние интеграции (через API)	Автоматизация на уровне внешних сервисов	Сложность настройки, задержки	Интеграция с ERP, CRM