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

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

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

Ниже рассмотрим, как автоматически удалять товары из заказов при смене их статуса на отменённый или возвращённый, чтобы поддерживать базу данных в актуальном состоянии.

Диагностика текущего состояния заказа

Для начала необходимо определить, как именно в вашей установке WooCommerce фиксируются отмены и возвраты товаров. Обычно в заказах WooCommerce позиции (line items) не имеют отдельного статуса, а статус меняется у самого заказа:

• cancelled — отменённый заказ;
• refunded — возвращённый заказ.

Если возврат оформляется через стандартный функционал возврата, позиции остаются в заказе, но сумма возвращается покупателю.

Для проверки статуса заказа используйте следующий код в отладочном плагине или functions.php:

add_action('woocommerce_order_status_changed', 'check_order_status_change', 10, 4);
function check_order_status_change($order_id, $old_status, $new_status, $order) {
    error_log("Order #$order_id changed from $old_status to $new_status");
}

Таким образом, вы убедитесь, какие статусы используются в вашей теме и плагинах для отмены и возврата.

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

Для автоматического удаления товаров из заказа при смене его статуса на cancelled или refunded используйте следующий код:

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

Объяснение:

• Хук woocommerce_order_status_changed ловит смену статуса заказа.
• Если новый статус — отменённый или возвращённый, перебираем все позиции заказа.
• Удаляем позиции методом remove_item().
• Пересчитываем итоговую сумму заказа методом calculate_totals().
• Сохраняем изменения в базе через save().

Как проверить, что решение работает

1. Создайте тестовый заказ в WooCommerce с несколькими товарами.

2. Измените статус заказа в админке на cancelled или оформите возврат, переключив статус на refunded.

3. Обновите страницу просмотра заказа в админке или в личном кабинете покупателя — товары должны исчезнуть из списка позиций.

4. Проверьте, что итоговая сумма заказа равна нулю.

5. При необходимости проверьте логи ошибок для выявления проблем.

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

• Позиции не удаляются: возможно, хук срабатывает не в том приоритете. Попробуйте повысить приоритет (например, до 30).
• Итоговая сумма не обновляется: вызов calculate_totals() обязателен после удаления позиций.
• Заказы с кешированием: при использовании плагинов кеширования или оптимизации базы может понадобиться очистка кеша или отключение оптимизации для заказов.
• Конфликт с плагинами возврата: некоторые плагины работают с отдельными мета-данными, которые могут не учитывать удаление позиций. В этом случае нужна доработка логики под конкретный плагин.

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

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

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