WooCommerce: автоматическое изменение статуса заказа при отменах и возвратах

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

Проблема: при отмене или возврате товара в WooCommerce заказ не меняет статус автоматически, что приводит к путанице в учёте и управлении заказами. Часто это возникает из-за отсутствия нужных хуков или неправильно настроенных обработчиков статусов.

Для диагностики используйте логи WooCommerce и отладку хуков с помощью плагина Query Monitor или простого кода для вывода текущих статусов при изменении заказа.

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

Проверьте, вызывается ли этот хук при ручных и программных изменениях статусов.

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

1. Добавляем обработчик отмены заказа

Чтобы автоматически менять статус на «отменён» при инициировании отмены, используйте следующий код в functions.php вашей темы или в плагине:

add_action('woocommerce_order_item_cancelled', 'auto_change_status_on_cancel', 10, 2);
function auto_change_status_on_cancel($item_id, $order) {
    if ($order && $order instanceof WC_Order) {
        // Меняем статус на отменён, если он ещё не установлен
        if ($order->get_status() !== 'cancelled') {
            $order->update_status('cancelled', 'Заказ автоматически отменён');
        }
    }
}

2. Автоматическое изменение статуса при возврате

WooCommerce фиксирует возвраты как изменения в платежах, но статус заказа не меняется по умолчанию. Добавим обработку для смены статуса на refunded:

add_action('woocommerce_order_refunded', 'auto_change_status_on_refund', 10, 2);
function auto_change_status_on_refund($order_id, $refund_id) {
    $order = wc_get_order($order_id);
    if ($order && $order instanceof WC_Order) {
        if ($order->get_status() !== 'refunded') {
            $order->update_status('refunded', 'Заказ автоматически помечен как возвращён');
        }
    }
}

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

Для проверки:

• Создайте тестовый заказ в WooCommerce.
• Инициируйте отмену товара или заказа через админку.
• Убедитесь, что статус заказа меняется на cancelled.
• Создайте возврат через WooCommerce и проверьте смену статуса на refunded.
• Проверьте логи ошибок сервера и WooCommerce для отсутствия ошибок.

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

• Хук не срабатывает: Проверьте, что код добавлен правильно и активен. Убедитесь, что используете правильные хуки WooCommerce. Например, woocommerce_order_item_cancelled срабатывает только для отмены позиции, а не всего заказа.
• Статус не меняется: Метод update_status() должен использоваться через объект WC_Order. Проверьте, что объект заказа получен корректно.
• Конфликты с другими плагинами: Отключите сторонние плагины, которые могут влиять на обработку заказов, чтобы убедиться, что они не блокируют смену статусов.

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

• Не блокируйте критические хуки: Избегайте использования die() или тяжелых операций в хуках обработки статусов.
• Кэширование: Если используете кэш на сайте, очищайте его после программного обновления статусов, чтобы изменения сразу отображались в админке и для пользователей.
• Логи: Включите логирование WooCommerce для отлова ошибок, связанных с заказами, и анализируйте их регулярно.

Сравнение способов автоматизации изменения статусов