WooCommerce: автоматическое отслеживание статусов заказов через REST API

Почему важно автоматизировать отслеживание статусов заказов в WooCommerce

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

Диагностика задачи: что нужно и что проверить

Перед автоматизацией важно понять:

• Какие статусы заказов нужно отслеживать (например: processing, completed, cancelled).
• Как часто нужна синхронизация (раз в минуту, час и т.д.).
• Доступен ли REST API WooCommerce с необходимыми правами (чтение заказов).
• Корректно ли настроена аутентификация (OAuth 1.0, Basic Auth или JWT).
• Не мешают ли плагинам или настройкам ограничения по частоте запросов.

Пошаговое решение: настройка и пример кода

1. Включение REST API и генерация ключей

В административной панели WooCommerce перейдите в WooCommerce → Настройки → Продвинутые → REST API. Создайте ключ с правами чтение для пользователя с нужными правами.

2. Пример запроса к API для получения статусов заказов

Ниже пример PHP-кода для получения заказов с определённым статусом:

<?php
$store_url = 'https://example.com';
$consumer_key = 'ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
$consumer_secret = 'cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx';

// Подключение библиотеки HTTP (например, Guzzle или wp_remote_get)

function get_orders_by_status($status) {
    global $store_url, $consumer_key, $consumer_secret;
    $endpoint = $store_url . '/wp-json/wc/v3/orders?status=' . $status;

    $args = [
        'headers' => [
            'Authorization' => 'Basic ' . base64_encode($consumer_key . ':' . $consumer_secret),
        ],
    ];

    $response = wp_remote_get($endpoint, $args);

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

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

// Получаем заказы со статусом 'processing'
$orders = get_orders_by_status('processing');
if ($orders) {
    foreach ($orders as $order) {
        echo 'Заказ №' . $order['id'] . ' - статус: ' . $order['status'] . "\n";
    }
} else {
    echo 'Ошибка получения заказов';
}
?>

3. Настройка регулярного запуска скрипта

Для автоматизации можно использовать WP-Cron или системный cron на сервере. Пример добавления в functions.php:

function schedule_order_status_check() {
    if (!wp_next_scheduled('check_order_status_event')) {
        wp_schedule_event(time(), 'hourly', 'check_order_status_event');
    }
}
add_action('wp', 'schedule_order_status_check');

add_action('check_order_status_event', 'check_order_status_callback');
function check_order_status_callback() {
    // Вызов функции get_orders_by_status и обработка результатов
    $orders = get_orders_by_status('processing');
    if ($orders) {
        // Логика обработки, например, уведомление, обновление БД и т.д.
    }
}

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

• Запустите скрипт вручную и убедитесь, что возвращаются заказы с нужным статусом.
• Проверьте логи ошибок сервера и WordPress.
• Настройте логирование ответов API для отладки.
• Убедитесь, что cron-задание запускается по расписанию (проверка через WP-CLI: wp cron event list).
• Проверьте уведомления или обновления данных, если они настроены.

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

• Ошибка аутентификации 401: проверьте корректность ключей и метод авторизации. Basic Auth требует HTTPS.
• Пустой ответ или ошибки 403/404: убедитесь, что REST API включен и пользователь имеет права.
• Проблемы с cron: WP-Cron зависит от посещений сайта, лучше настроить системный cron.
• Перегрузка сервера из-за частых запросов: уменьшите частоту запросов или используйте кеширование результатов.

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

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

Сравнение вариантов реализации автоматического отслеживания заказов