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

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

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

Типичные вопросы, которые требуют решения через хуки WooCommerce:

• Как автоматически переводить заказ в статус «В обработке» после успешной оплаты?
• Как триггерить отправку данных заказа в CRM при смене статуса?
• Как добавить кастомное действие при создании заказа, например, заблокировать товар на складе?

Обзор ключевых хуков WooCommerce для обработки заказов

WooCommerce предоставляет несколько важных хуков для работы с заказами:

• woocommerce_thankyou — срабатывает после успешной оплаты заказа (ID заказа передается в параметре).
• woocommerce_order_status_changed — вызывается при изменении статуса заказа, передает ID заказа, старый и новый статус.
• woocommerce_checkout_update_order_meta — позволяет добавить или изменить метаданные заказа после оформления.
• woocommerce_order_status_processing и woocommerce_order_status_completed — хуки, срабатывающие при смене статуса на processing и completed соответственно.

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

Задача: после успешной оплаты автоматически переводить заказ в статус processing (если он еще не в этом статусе), чтобы запустить внутренние процессы обработки.

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

add_action('woocommerce_thankyou', 'auto_set_order_processing_status', 10, 1); 
function auto_set_order_processing_status($order_id) {
    if (!$order_id) return;

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

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

Шаг 2. Тестируем в реальных условиях

Оформите тестовый заказ с оплатой в режиме теста (например, через платежный шлюз Sandbox). После успешной оплаты посмотрите в админке WooCommerce, поменялся ли статус заказа с pending на processing.

Дополнительный пример: автоматическая отправка данных заказа в CRM при смене статуса

Частая задача — отправить данные о заказе в CRM-систему после изменения статуса, например, с processing на completed.

add_action('woocommerce_order_status_completed', 'send_order_to_crm', 10, 1);
function send_order_to_crm($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    $data = [
        'order_id' => $order->get_id(),
        'total' => $order->get_total(),
        'email' => $order->get_billing_email(),
        'items' => []
    ];

    foreach ($order->get_items() as $item) {
        $data['items'][] = [
            'product_id' => $item->get_product_id(),
            'quantity' => $item->get_quantity(),
        ];
    }

    // Пример простой отправки POST запроса через wp_remote_post
    $response = wp_remote_post('https://crm.example.com/api/orders', [
        'headers' => ['Content-Type' => 'application/json'],
        'body' => json_encode($data),
        'timeout' => 10,
    ]);

    if (is_wp_error($response)) {
        error_log('Ошибка при отправке заказа в CRM: ' . $response->get_error_message());
    }
}

Как проверить, что автоматизация работает

• Создайте тестовый заказ и пройдите полный цикл оплаты.
• Проверьте изменение статуса в админке WooCommerce.
• Проверьте логи ошибок PHP или WooCommerce.
• Для интеграций — убедитесь, что данные заказов появились в CRM или другом сервисе.

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

• Хук не срабатывает: часто вызвано неправильным приоритетом или неверным именем функции. Проверьте spelling и порядок подключения кода.
• Статус заказа не меняется: вызов update_status должен быть именно у объекта WC_Order, и статус должен быть допустимым WooCommerce.
• Ошибка подключения к внешнему сервису: проверьте правильность URL, наличие SSL, доступ с сервера и timeout.
• Проблемы с кешированием: если изменения не видны сразу, очистите кеш сайта и браузера.

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

• Используйте nonce и проверяйте права пользователя, если хук обрабатывает пользовательский ввод.
• Для интеграций с внешними API используйте асинхронные запросы или WP-Cron, чтобы не замедлять обработку страницы.
• Логируйте ошибки в отдельный файл, чтобы быстро находить проблемы без засорения основного лог-файла.
• Минимизируйте количество тяжелых операций в хуках, чтобы не влиять на время отклика сайта.

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