Автоматизация обработки возвратов в WooCommerce с помощью хуков

Диагностика задачи: зачем автоматизировать возвраты в WooCommerce

Возвраты товаров — частая операция в интернет-магазинах на WooCommerce. Ручная обработка возвратов занимает время, приводит к ошибкам и снижает качество сервиса. Автоматизация позволяет автоматически менять статус заказа, уведомлять клиентов и сотрудников, запускать процессы возврата средств и обновлять складские остатки без ручного вмешательства.

Какие хуки WooCommerce использовать для автоматизации возвратов

WooCommerce не имеет отдельного статуса «возврат», но возвраты чаще всего оформляются через возврат средств (refund) или изменение статуса заказа. Для автоматизации подходят следующие хуки:

• woocommerce_order_refunded – вызывается при создании возврата средств к заказу;
• woocommerce_order_status_changed – позволяет отслеживать изменение статуса заказа;
• woocommerce_refund_created – срабатывает при создании объекта возврата;
• woocommerce_admin_order_totals_after_refunds – для кастомного отображения возвратов в админке.

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

1. Добавление кода в functions.php или кастомный плагин

Добавим обработчик на woocommerce_order_refunded, чтобы при возврате средств автоматически менять статус заказа на refunded и отправлять уведомление клиенту.

add_action('woocommerce_order_refunded', 'auto_update_order_status_on_refund', 10, 2);
function auto_update_order_status_on_refund($order_id, $refund_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Проверяем текущий статус
    if ('refunded' !== $order->get_status()) {
        $order->update_status('refunded', 'Автоматическое обновление статуса после возврата средств');
    }

    // Отправляем уведомление клиенту
    WC()->mailer()->customer_refunded_order($order, $refund_id);
}

2. Дополнительное уведомление службе поддержки

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

add_action('woocommerce_order_refunded', 'notify_support_on_refund', 20, 2);
function notify_support_on_refund($order_id, $refund_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    $to = 'support@example.com'; // замените на реальный адрес
    $subject = 'Возврат оформлен: заказ #' . $order_id;
    $message = 'Возврат средств оформлен для заказа #' . $order_id . "\nПричина: " . $order->get_customer_note();

    wp_mail($to, $subject, $message);
}

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

• Оформите возврат средств в админке WooCommerce по любому заказу;
• Проверьте, что статус автоматически сменился на refunded;
• Убедитесь, что клиент получил письмо с уведомлением о возврате;
• Проверьте входящие письма поддержки — должно прийти уведомление о возврате.

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

• Не меняется статус заказа после возврата: проверьте, что код подключен в active theme или плагине, и нет конфликтов с другими хуками, которые могут перезаписывать статус.
• Письма не отправляются: проверьте настройки почты WordPress, используйте SMTP-плагин для надежной доставки.
• Ошибка при вызове customer_refunded_order: убедитесь, что WooCommerce обновлен, эта функция доступна с версии 3.0 и выше.

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

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

Сравнение вариантов автоматизации возвратов