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

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

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

Как программно создать заказ в WooCommerce

WooCommerce предоставляет класс WC_Order и функции для работы с заказами. Ниже пример кода, который создаёт заказ с одним товаром, устанавливает покупателя и задаёт статус:

function wptricks_create_order_automatically() {
    $product_id = 123; // ID товара
    $user_id = 1; // ID покупателя

    $address = array(
        'first_name' => 'Иван',
        'last_name'  => 'Иванов',
        'email'      => 'ivan@example.com',
        'phone'      => '88005553535',
        'address_1'  => 'ул. Примерная, д.1',
        'city'       => 'Москва',
        'postcode'   => '101000',
        'country'    => 'RU'
    );

    // Создаём заказ
    $order = wc_create_order();

    // Добавляем товар в заказ
    $order->add_product(wc_get_product($product_id), 1);

    // Устанавливаем адреса
    $order->set_address($address, 'billing');
    $order->set_address($address, 'shipping');

    // Назначаем покупателя
    $order->set_customer_id($user_id);

    // Устанавливаем статус
    $order->set_status('processing');

    // Расчет totals
    $order->calculate_totals();

    // Сохраняем заказ
    $order->save();

    return $order->get_id();
}

Этот код создаст заказ с одним товаром и статусом processing. Вызовите функцию, например, из AJAX или CRON.

Автоматическое обновление статусов заказов по условию

Для автоматического изменения статуса заказа (например, после подтверждения оплаты вручную или из внешней системы) используйте следующий пример:

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

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

Такую функцию можно запускать через CRON или в хуках, например, после успешной оплаты.

Проверка результата: как убедиться, что заказ создан и статус изменён

• Зайдите в админку WooCommerce → Заказы и найдите новый заказ по ID или данным покупателя.
• Проверьте, что в заказе есть нужный товар и установлены корректные адреса.
• Убедитесь, что статус заказа совпадает с установленным в коде (например, processing).
• Для автоматического обновления статуса проверьте историю изменений в заказе — комментарии к заказу должны содержать запись об обновлении.

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

• Пустой или некорректный ID товара: Вызов wc_get_product($product_id) вернёт false, и товар не добавится. Проверьте, что товар существует и опубликован.
• Отсутствие пользователя с указанным ID: При указании set_customer_id убедитесь, что такой пользователь есть в базе.
• Неправильный формат адреса: Функция set_address требует ассоциативный массив с правильными ключами. Ошибки вызовут некорректное сохранение данных.
• Статус заказа не поддерживается: Используйте допустимые статусы WooCommerce: pending, processing, completed, cancelled, refunded, failed.
• Отсутствие вызова calculate_totals(): Без этого итоговые суммы не пересчитаются, заказ будет иметь неверные данные.

Проверка и отладка

• Включите логирование ошибок PHP и WooCommerce через WP_DEBUG и WC_Logger.
• Добавьте в код функции error_log() с ключевыми точками для отслеживания процесса.
• Проверьте, вызывается ли функция создания заказа (например, через вызов в шаблоне или CRON).

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

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

Сравнение методов создания заказов: плагин vs код