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

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

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

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

Реализуем это с помощью хука WooCommerce woocommerce_order_status_changed, который срабатывает при изменении статуса заказа. Будем отслеживать переходы в статусы cancelled и refunded и очищать товары в заказе.

Код для functions.php или собственного плагина:

add_action('woocommerce_order_status_changed', 'auto_remove_items_on_order_cancel_refund', 10, 4);
function auto_remove_items_on_order_cancel_refund($order_id, $old_status, $new_status, $order) {
    if (in_array($new_status, array('cancelled', 'refunded'))) {
        foreach ($order->get_items() as $item_id => $item) {
            $order->remove_item($item_id);
        }
        $order->calculate_totals();
        $order->save();
    }
}

Объяснение:

• woocommerce_order_status_changed - хук для отслеживания смены статуса заказа.
• Проверяем, что новый статус cancelled или refunded.
• Перебираем все товары заказа и удаляем их методом remove_item.
• Пересчитываем итоговую сумму заказа методом calculate_totals и сохраняем изменения.

Альтернативный вариант: удалять товары только при возврате (refunded)

add_action('woocommerce_order_status_changed', 'auto_remove_items_on_refund_only', 10, 4);
function auto_remove_items_on_refund_only($order_id, $old_status, $new_status, $order) {
    if ($new_status === 'refunded') {
        foreach ($order->get_items() as $item_id => $item) {
            $order->remove_item($item_id);
        }
        $order->calculate_totals();
        $order->save();
    }
}

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

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

1. Создайте тестовый заказ с товарами.
2. Переведите заказ в статус cancelled или refunded через админку WooCommerce.
3. Откройте заказ и убедитесь, что блок с товарами пуст.
4. Проверьте общую сумму заказа — она должна быть равна нулю.
5. При необходимости проверьте базу данных в таблице wp_woocommerce_order_items — записи о товарах должны отсутствовать для этого заказа.

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

• Товары не удаляются при смене статуса: проверьте, что функция подключена и хук работает. Можно добавить error_log внутри функции для отладки.
• Итоговая сумма не обновляется: обязательно вызывайте calculate_totals() и save() после удаления товаров.
• Ошибка при вызове методов объекта $order: убедитесь, что параметр $order передается в функцию как объект WC_Order. Если нет, получите заказ через wc_get_order($order_id).
• Конфликты с другими плагинами: тестируйте на чистой установке, отключайте другие плагины, если баги сохраняются.

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

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

Сравнение вариантов реализации удаления товаров из заказов WooCommerce