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

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

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

Основы работы с REST API WooCommerce

Для начала нужно убедиться, что REST API включён и настроен. В WooCommerce для этого:

• Перейдите в WooCommerce > Настройки > Продвинутые > REST API
• Создайте ключ API с нужными правами доступа (обычно - чтение/запись)

Полученные Consumer Key и Consumer Secret используются для аутентификации запросов.

Пример базовой авторизации и запроса заказов

function get_orders_via_api() {
    $url = 'https://example.com/wp-json/wc/v3/orders';
    $consumer_key = 'ck_xxxxx';
    $consumer_secret = 'cs_xxxxx';

    $response = wp_remote_get( $url, array(
        'headers' => array(
            'Authorization' => 'Basic ' . base64_encode( $consumer_key . ':' . $consumer_secret )
        )
    ) );

    if( is_wp_error( $response ) ) {
        return false;
    }

    $body = wp_remote_retrieve_body( $response );
    return json_decode( $body, true );
}

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

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

Например, выберем все заказы со статусом processing:

$orders = get_orders_via_api() ?: [];
$processing_orders = array_filter($orders, function($order) {
    return $order['status'] === 'processing';
});

Шаг 2. Формирование запроса на обновление статуса

Для каждого заказа отправим PATCH-запрос с новым статусом completed:

function update_order_status( $order_id, $new_status ) {
    $url = "https://example.com/wp-json/wc/v3/orders/" . $order_id;
    $consumer_key = 'ck_xxxxx';
    $consumer_secret = 'cs_xxxxx';

    $data = json_encode([ 'status' => $new_status ]);

    $response = wp_remote_request( $url, [
        'method'  => 'PUT',
        'headers' => [
            'Authorization' => 'Basic ' . base64_encode( $consumer_key . ':' . $consumer_secret ),
            'Content-Type' => 'application/json',
        ],
        'body'    => $data,
    ]);

    if ( is_wp_error( $response ) ) {
        return false;
    }
    return wp_remote_retrieve_response_code( $response ) === 200;
}

Шаг 3. Автоматизация обновления всех выбранных заказов

foreach ( $processing_orders as $order ) {
    $success = update_order_status( $order['id'], 'completed' );
    if ( $success ) {
        echo "Заказ #{$order['id']} обновлён\n";
    } else {
        echo "Ошибка при обновлении заказа #{$order['id']}\n";
    }
}

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

• Проверьте в административной панели WooCommerce, что статусы заказов изменились с processing на completed.
• Используйте REST API для получения заказа и убедитесь, что поле status обновлено.
• Логируйте ответы API, чтобы отследить возможные ошибки.

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

• Ошибка 401 Unauthorized — обычно из-за неправильных ключей или их прав. Проверьте, что ключи актуальны и имеют права на запись.
• Ошибка 404 Not Found — неверный URL API или версия. Убедитесь, что используете /wp-json/wc/v3/ и правильный домен.
• Проблемы с SSL — если сервер не поддерживает HTTPS или есть проблемы с сертификатом, REST API может не работать. Проверьте SSL и используйте правильный протокол.
• Ограничения хостинга — некоторые хостинги блокируют HTTP-запросы. Проверьте ограничения и при необходимости настройте сервер.

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

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

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