WooCommerce: устройство автоматической обновы стоков и цен через Cron и REST API

Диагностика задачи: зачем и когда нужна автоматическая обновa?

Интернет-магазины на WooCommerce часто используют внешние учетные системы, склады или поставщиков, которые предоставляют актуальные данные о наличии товаров и ценах. Ручное обновление занимает время и чревато ошибками. Автоматизация обновления стоков и цен решает эту проблему, поддерживая каталог в актуальном состоянии и снижая количество возвратов и недовольства клиентов.

Признаки необходимости автоматизации

• Частое изменение ассортимента и цен.
• Несоответствие данных в WooCommerce и на складе.
• Ошибки в заказах из-за устаревших данных.
• Большое количество товаров, ручное обновление занимает много времени.

Пошаговое решение: настройка автоматической обновы стоков и цен

1. Подготовка источника данных

Данные о стоках и ценах должны быть доступны в формате, удобном для обработки. Чаще всего это внешний REST API от поставщика или выгрузка в CSV/XML. Мы рассмотрим вариант с REST API.

2. Создание пользовательской функции для обновления товаров

Создайте функцию, которая по ID или SKU товара обновит его наличие и цену.

function update_product_stock_and_price($product_id, $new_stock, $new_price) {
    $product = wc_get_product($product_id);
    if (!$product) {
        return false;
    }
    $product->set_stock_quantity($new_stock);
    $product->set_stock_status($new_stock > 0 ? 'instock' : 'outofstock');
    $product->set_regular_price($new_price);
    $product->save();
    return true;
}

Обратите внимание: используем методы WooCommerce API, чтобы корректно обновлять данные и триггерить нужные хуки.

3. Написание задачи для Cron, которая получит данные и обновит товары

Добавим функцию, которая выполняет запрос к API поставщика, парсит ответ и вызывает обновление.

function fetch_and_update_products_from_supplier() {
    $response = wp_remote_get('https://supplier.example.com/api/products');
    if (is_wp_error($response)) {
        error_log('Ошибка запроса к API поставщика: ' . $response->get_error_message());
        return;
    }
    $data = json_decode(wp_remote_retrieve_body($response), true);
    if (empty($data)) {
        error_log('Пустой ответ от API поставщика');
        return;
    }
    foreach ($data as $item) {
        // Предполагаем, что в $item есть 'sku', 'stock', 'price'
        $product_id = wc_get_product_id_by_sku($item['sku']);
        if (!$product_id) {
            continue; // товар не найден, можно добавить логику создания
        }
        update_product_stock_and_price($product_id, intval($item['stock']), sanitize_text_field($item['price']));
    }
}

4. Регистрация Cron задачи

Добавим событие в WordPress Cron для запуска обновления, например, раз в час.

if (!wp_next_scheduled('update_products_hourly_event')) {
    wp_schedule_event(time(), 'hourly', 'update_products_hourly_event');
}
add_action('update_products_hourly_event', 'fetch_and_update_products_from_supplier');

Можно использовать WP-Cron, но для надежности лучше настроить системный cron и запускать wp-cron.php через curl или wget.

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

• Проверьте логи ошибок (wp-content/debug.log или error_log) на наличие ошибок при выполнении задачи.
• Сравните данные товаров в WooCommerce с поставщиком после запуска Cron.
• Запустите задачу вручную через do_action('update_products_hourly_event'); и проверьте обновления.
• Проверьте панель администратора WooCommerce: наличие и цена должны обновиться.

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

• Ошибка: Не обновляются товары по SKU. Причина: неверный SKU или SKU не уникален. Проверьте, что SKU в WooCommerce совпадает с данными поставщика.
• Ошибка: WP-Cron не запускается. Причина: неактивирован или отключен WP-Cron. Решение: настроить реальный системный cron для запуска wp-cron.php.
• Ошибка: данные не проходят валидацию. Причина: неочищенные данные из API могут содержать неправильный формат. Используйте функции sanitize_text_field, intval и проверки перед записью.
• Ошибка: обновления не сохраняются. Причина: не вызван $product->save() или ошибка в коде.

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

• Кэширование и лимиты запросов: если API поставщика имеет ограничения, добавьте кэширование ответов или используйте частичное обновление только измененных товаров.
• Авторизация при запросах к API: используйте безопасные токены или ключи, храните их в wp-config.php или в настройках с шифрованием.
• Обработка ошибок: логируйте ошибки в отдельный файл или используйте сторонние сервисы мониторинга (Sentry, Bugsnag).
• Безопасность данных: не выводите ключи и токены в публичный код и не передавайте их в URL.
• Оптимизация Cron: не запускайте обновление чаще, чем это необходимо. При большом количестве товаров разбивайте обновление на части.

Таблица сравнения способов обновления WooCommerce товаров