WooCommerce REST API: оформление и обновление заказов без ошибок

Диагностика проблем с оформлением и обновлением заказов через WooCommerce REST API

При работе с WooCommerce REST API нередко возникают ошибки, связанные с оформлением новых заказов и обновлением их статусов. Типичные симптомы:

• Ошибка 400 Bad Request при попытке создать заказ;
• Ошибка 401 Unauthorized при обновлении заказа;
• Заказ создаётся, но статусы не меняются после PUT-запроса;
• Отсутствие обязательных полей в ответе API или неверное форматирование данных.

Для диагностики в первую очередь важно проверить правильность аутентификации, формат передаваемых данных и соответствие версии API, используемой на сайте.

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

1. Настройка аутентификации и подключение

Используйте ключи REST API, созданные в WooCommerce (WooCommerce → Настройки → Продвинутые → REST API). Пример инициализации клиента на PHP с использованием библиотеки Automattic WooCommerce API:

use Automattic\WooCommerce\Client;

$woocommerce = new Client(
    'https://example.com',
    'ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
    'cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
    [
        'version' => 'wc/v3',
        'query_string_auth' => true
    ]
);

2. Создание заказа с обязательными полями

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

$data = [
    'payment_method' => 'bacs',
    'payment_method_title' => 'Direct Bank Transfer',
    'set_paid' => true,
    'billing' => [
        'first_name' => 'Иван',
        'last_name' => 'Иванов',
        'address_1' => 'ул. Ленина, д.1',
        'city' => 'Москва',
        'postcode' => '101000',
        'country' => 'RU',
        'email' => 'ivanov@example.com',
        'phone' => '79991234567'
    ],
    'line_items' => [
        [
            'product_id' => 123,
            'quantity' => 1
        ]
    ]
];

try {
    $order = $woocommerce->post('orders', $data);
    echo 'Заказ создан с ID: ' . $order->id;
} catch (Exception $e) {
    echo 'Ошибка создания заказа: ' . $e->getMessage();
}

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

Для изменения статуса заказа используйте PUT-запрос с параметром status. Например, чтобы пометить заказ как завершённый:

$order_id = 456;
$data = [
    'status' => 'completed'
];

try {
    $updated_order = $woocommerce->put("orders/{$order_id}", $data);
    echo 'Статус заказа обновлён на: ' . $updated_order->status;
} catch (Exception $e) {
    echo 'Ошибка обновления заказа: ' . $e->getMessage();
}

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

• В интерфейсе админки WooCommerce проверьте, что заказ появился с корректными данными и статусом.
• Отправьте GET-запрос на /wp-json/wc/v3/orders/{order_id} и убедитесь, что в ответе статус и детали совпадают с отправленными.
• Включите логирование запросов WooCommerce REST API (например, через плагин WP_DEBUG_LOG) для отлова ошибок.

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

• Ошибка 401 Unauthorized: проверьте правильность ключей, права пользователя (администратор или менеджер заказов), а также включён ли REST API.
• Ошибка 400 Bad Request: убедитесь, что все обязательные поля (billing, line_items) передаются в корректном формате, особенно идентификаторы продуктов и валюта.
• Изменение статуса не применяется: проверьте, что статус, который вы пытаетесь установить, разрешён в WooCommerce (например, 'completed', 'processing', 'on-hold').
• Проблемы с SSL: если API вызывается с внешнего сервера, убедитесь, что сертификат SSL действителен и сервер поддерживает TLS 1.2+.

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

• Используйте HTTPS для всех запросов к REST API.
• Ограничьте доступ к REST API ключам по IP, если это возможно.
• Для массовых операций с заказами используйте пакетные запросы с ограничением по количеству, чтобы не вызывать ошибку 429 Too Many Requests.
• Включите кэширование GET-запросов, чтобы снизить нагрузку на сервер.
• Регулярно обновляйте WooCommerce и REST API библиотеку для устранения уязвимостей.

Сравнение способов создания и обновления заказов