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

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

В стандартной установке WooCommerce изменение статуса заказа при возврате товара не происходит автоматически. Это может привести к путанице в учёте и аналитике, а также к неправильным уведомлениям для клиентов и менеджеров.

Чтобы убедиться, что проблема именно в отсутствии автоматического обновления статуса, проверьте следующие моменты:

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

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

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

Для автоматизации процесса воспользуемся хуком woocommerce_order_refunded, который срабатывает при оформлении возврата.

2. Функция для смены статуса заказа

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

add_action('woocommerce_order_refunded', 'auto_change_order_status_on_refund', 10, 2); 
function auto_change_order_status_on_refund( $order_id, $refund_id ) {
    if ( ! $order_id ) {
        return;
    }

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

    // Проверяем, что возврат полностью или частично покрывает заказ
    $refund = wc_get_order( $refund_id );
    if ( ! $refund ) {
        return;
    }

    // Пример: меняем статус на 'cancelled' при любом возврате
    $order->update_status('cancelled', 'Статус автоматически изменён после возврата.');
}

3. Кастомизация статуса

Вы можете заменить 'cancelled' на любой другой статус, например 'refunded', если он у вас зарегистрирован. Для добавления собственного статуса используйте register_post_status, но для простоты лучше использовать штатные.

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

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

• Оформите возврат товара через админку WooCommerce.
• Проверьте, что статус основного заказа изменился на выбранный (например, cancelled).
• Убедитесь, что в истории изменений заказа появилась запись с комментарием Статус автоматически изменён после возврата.

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

• Хук не срабатывает: Возможно, вы используете плагин для возвратов, который не вызывает стандартный хук woocommerce_order_refunded. Проверьте совместимость плагинов.
• Неправильное использование ID возврата: Важно, чтобы второй аргумент функции был ID возврата. Если функция вызывается с неправильными параметрами, код не сработает.
• Кэширование: Если на сайте используется агрессивное кэширование, обновления статуса могут не отображаться моментально. Очистите кэш.

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

• Не используйте тяжелые операции в хуках, особенно при массовых возвратах, чтобы не замедлять сайт.
• Добавляйте логирование для отслеживания срабатываний в production, например, через error_log или плагины логов.
• Создавайте резервные копии перед внесением изменений в код.

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