Как использовать WooCommerce REST API для массового изменения заказов

Диагностика задачи: зачем нужен массовый апдейт заказов через REST API

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

Подготовка: что нужно для работы с WooCommerce REST API

Для работы с REST API WooCommerce необходимо:

• Иметь права администратора на сайте WordPress с установленным WooCommerce.
• Активировать ключи API с правами чтения и записи (Read/Write) в WooCommerce - WooCommerce > Настройки > Продвинутые > REST API.
• Установить и настроить инструмент для отправки HTTP-запросов (например, Postman, curl) или написать скрипт на PHP/Python/Node.js.

Пошаговое решение: массовое обновление заказов через REST API

1. Получение списка заказов для обновления

С помощью GET-запроса вы можете взять ID заказов, например, все со статусом processing:

GET https://your-site.com/wp-json/wc/v3/orders?status=processing&consumer_key=ck_xxx&consumer_secret=cs_xxx

Ответом будет JSON-массив заказов с ключами id, status и прочими.

2. Формирование данных для обновления

Для каждого заказа формируем JSON с нужными изменениями. Например, обновить статус заказа на completed:

{
  "status": "completed"
}

3. Отправка PATCH-запроса для каждого заказа

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

PATCH https://your-site.com/wp-json/wc/v3/orders/{order_id}?consumer_key=ck_xxx&consumer_secret=cs_xxx

{
  "status": "completed"
}

В PHP это можно автоматизировать так:

$orders = [123, 124, 125]; // ID заказов для обновления

foreach ($orders as $order_id) {
    $url = "https://your-site.com/wp-json/wc/v3/orders/" . $order_id;
    $data = ['status' => 'completed'];

    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PATCH");
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json'
    ]);
    curl_setopt($ch, CURLOPT_USERPWD, "ck_xxx:cs_xxx");

    $response = curl_exec($ch);
    $httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpcode === 200) {
        echo "Order $order_id updated successfully\n";
    } else {
        echo "Failed to update order $order_id: $response\n";
    }
}

4. Массовое обновление дополнительных полей заказа

Можно добавить метаданные или изменить адрес доставки. Пример добавления кастомного поля:

{
  "meta_data": [
    {
      "key": "custom_note",
      "value": "Обработано через API"
    }
  ]
}

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

• Откройте админку WooCommerce > Заказы и проверьте, что статус изменился на completed для нужных заказов.
• Через API сделайте GET-запрос на обновленные заказы и проверьте значение полей.
• Используйте логирование в скрипте, чтобы отследить успешные и неудачные обновления.

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

• Ошибка 401 Unauthorized: Проверьте корректность ключей API и права доступа.
• Ошибка 405 Method Not Allowed: Убедитесь, что используете метод PATCH для обновления, а не POST или GET.
• Ошибка 400 Bad Request: Проверьте формат JSON, убедитесь в правильности полей в теле запроса.
• Обновление не происходит: Проверьте, что статус заказа разрешено менять (некоторые статусы могут быть закрыты для изменений).

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

• Используйте HTTPS для всех API-запросов, чтобы защитить ключи и данные.
• Ограничьте права ключей API, выдавая минимально необходимые.
• Для массовых обновлений делайте паузы и обрабатывайте небольшими партиями, чтобы не перегрузить сервер.
• В логах сервера отслеживайте ошибки, чтобы вовремя выявлять сбои скриптов.

Сравнение подходов: плагин vs собственный скрипт