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

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

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

Перед началом работы важно проверить, что на вашем сайте корректно настроен REST API и есть права доступа с нужными возможностями. Для этого выполните запрос GET к /wp-json/wc/v3/orders с авторизацией, чтобы удостовериться, что API отвечает и возвращает список заказов.

Подключение к WooCommerce REST API: базовые настройки

Для работы с REST API WooCommerce потребуется создать ключи API в админке:

• Перейдите в WooCommerce → Настройки → Продвинутые → REST API
• Создайте новый ключ с правами Read/Write
• Сохраните Consumer Key и Consumer Secret

Пример базового подключения на PHP с использованием библиотеки woocommerce/wc-api-php:

require __DIR__ . '/vendor/autoload.php';
use Automattic\WooCommerce\Client;

$woocommerce = new Client(
    'https://your-site.ru',
    'consumer_key',
    'consumer_secret',
    [
        'version' => 'wc/v3',
        'timeout' => 30,
    ]
);

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

1. Получение списка заказов, подходящих под критерии

Для примера обновим статусы всех заказов со статусом processing на completed. Сначала получим список заказов со статусом processing:

$orders = $woocommerce->get('orders', ['status' => 'processing', 'per_page' => 100]);

Обратите внимание, что по умолчанию API возвращает максимум 10 записей. Используйте параметр per_page до 100, и если заказов больше — реализуйте пагинацию с помощью параметра page.

2. Обновление статусов заказов в цикле

Пройдём по массиву заказов и обновим статус каждого заказа:

foreach ($orders as $order) {
    $woocommerce->put('orders/' . $order->id, [
        'status' => 'completed'
    ]);
}

Так вы автоматически измените статусы без ручного редактирования.

3. Массовое удаление заказов

Чтобы удалить заказы, используйте HTTP DELETE запрос. Пример удаления заказов с кастомным фильтром:

foreach ($orders as $order) {
    $woocommerce->delete('orders/' . $order->id, ['force' => true]);
}

Опция force=true позволяет удалить заказ полностью, минуя корзину.

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

• Проверьте через админку WooCommerce, что статусы заказов изменились на completed.
• Для удаления закажите список заказов с помощью API и убедитесь, что удалённые заказы отсутствуют.
• Используйте такие запросы для выборочной проверки:

  $woocommerce->get('orders/' . $order_id);

  если заказ не найден — он удалён.

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

• Ошибка аутентификации 401 Unauthorized: Проверьте корректность Consumer Key и Consumer Secret, а также права пользователя в WooCommerce.
• Недостаточно прав (403 Forbidden): Ключ должен иметь права Read/Write для изменения заказов.
• Ошибка лимита запросов: WooCommerce может ограничивать количество API-запросов. Используйте задержки между запросами или реализуйте пакетную обработку.
• Обновление не применяется: Проверьте, что статус заказа допустим для изменения (например, нельзя перевести отменённый заказ в completed).

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

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

Сравнение способов массового управления заказами