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

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

В интернет-магазинах на WooCommerce часто возникает необходимость автоматизировать рутинные процессы, например, подтверждение оплаты, изменение статуса заказа, обновление информации по доставке и передача данных в CRM или складские системы. Ручная обработка заказов увеличивает вероятность ошибок и задержек, особенно при большом потоке. REST API WooCommerce предоставляет мощный инструмент для удалённого управления заказами, что позволяет интегрировать магазин с внешними сервисами и создавать кастомные автоматизации.

Основы: как подключиться к WooCommerce REST API

Для работы с REST API WooCommerce необходимо получить ключи потребителя (Consumer Key) и секрет (Consumer Secret) из админки сайта. Они создаются в разделе WooCommerce > Настройки > Расширенные > REST API. Ключи должны иметь права чтения и записи, чтобы можно было менять статусы заказов.

Пример базового запроса на PHP с использованием Guzzle (современный HTTP-клиент):

use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://example.com/wp-json/wc/v3/']);
$response = $client->request('GET', 'orders', [
    'auth' => ['consumer_key', 'consumer_secret'],
    'query' => ['status' => 'processing']
]);
$orders = json_decode($response->getBody(), true);

Параметры для запросов, которые важно знать

• status — фильтр по статусу заказа (pending, processing, completed и т.д.)
• per_page и page — для постраничного получения данных
• Методы: GET для получения, POST для создания, PUT для обновления

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

Частая задача — автоматически переводить заказ из статуса pending в processing сразу после подтверждения оплаты через внешнюю систему.

Шаг 1. Получаем заказы с нужным статусом

$response = $client->request('GET', 'orders', [
    'auth' => ['consumer_key', 'consumer_secret'],
    'query' => ['status' => 'pending', 'per_page' => 10]
]);
$orders = json_decode($response->getBody(), true);

Шаг 2. Обрабатываем каждый заказ и меняем статус

foreach ($orders as $order) {
    $order_id = $order['id'];
    // Допустим, проверяем оплату через внешний API или логику
    $payment_confirmed = checkExternalPayment($order_id); // ваша функция
    if ($payment_confirmed) {
        $update_response = $client->request('PUT', "orders/{$order_id}", [
            'auth' => ['consumer_key', 'consumer_secret'],
            'json' => ['status' => 'processing']
        ]);
    }
}

Шаг 3. Настраиваем автоматический запуск скрипта

Чтобы скрипт работал регулярно, настроьте CRON-задачу на сервере, которая будет запускать PHP-скрипт с кодом выше, например, каждые 5 минут.

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

Проверьте в админке WooCommerce, что заказы с ранее статусом pending меняются на processing. Можно добавить логирование в код:

file_put_contents('order_update.log', "Order {$order_id} status updated\n", FILE_APPEND);

Также с помощью REST API сделайте запрос на получение конкретного заказа и проверьте поле status. Для этого:

$response = $client->request('GET', "orders/{$order_id}", [
    'auth' => ['consumer_key', 'consumer_secret']
]);
$order = json_decode($response->getBody(), true);
echo $order['status'];

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

• Ошибка 401 Unauthorized: Неверные ключи потребителя или неправильные права доступа. Проверьте ключи в админке WooCommerce, убедитесь, что они имеют права чтения и записи.
• Ошибка 403 Forbidden: Ограничения на сервере (например, .htaccess или firewall блокирует запросы). Проверьте настройки сервера, разрешите доступ к REST API.
• Отсутствие обновления статуса: Возможно, вы используете не тот идентификатор заказа или не передаёте корректный JSON в PUT-запросе. Используйте инструменты дебага, например Postman, чтобы проверить запросы вручную.
• Проблемы с кодировкой или JSON: Всегда используйте параметр 'json' => [...] в Guzzle, чтобы автоматически сериализовать данные.

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

• Используйте HTTPS для всех запросов к REST API.
• Храните ключи API в защищённых переменных окружения, а не в открытом коде.
• Ограничьте права ключей до необходимого минимума (например только чтение/запись заказов).
• Кэшируйте результаты запросов, если данные не меняются часто, чтобы снизить нагрузку на сервер.
• Добавьте обработку ошибок и повторные попытки в случае временных сбоев сети.

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