WooCommerce: автоматическая синхронизация остатков товара при массовых изменениях

Диагностика проблемы с синхронизацией остатков в WooCommerce

При массовом обновлении товаров в WooCommerce часто возникает ситуация, когда остатки товаров на складах не синхронизируются корректно. Это может привести к несоответствию данных между административной частью и витриной, а также к ошибкам в заказах и недовольству покупателей.

Основные признаки проблемы:

• На витрине отображается неправильное количество доступных товаров.
• При массовом импорте/обновлении остатков значения не изменяются.
• В отчетах WooCommerce остатки не соответствуют фактическим.
• При изменении вариаций товара остатки не обновляются.

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

Почему стандартные методы массового обновления не всегда работают

Массовое обновление через CSV или плагины импорта часто просто меняет пользовательские мета-поля (_stock, _stock_status), но не запускает необходимые хуки и функции WooCommerce для пересчёта и синхронизации остатков, особенно для вариаций и складских операторов.

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

Пошаговое решение: автоматическая синхронизация остатков при массовом обновлении

1. Используйте WC_Product_Factory для обновления запасов

Для корректного обновления остатков используйте API WooCommerce, а не прямое изменение метаполей. Пример кода для массового обновления запасов товаров по ID:

function wc_mass_update_stock( $products_stock_data ) {
    foreach ( $products_stock_data as $product_id => $new_stock ) {
        $product = wc_get_product( $product_id );
        if ( ! $product ) {
            continue;
        }
        $product->set_stock_quantity( $new_stock );
        $product->set_stock_status( $new_stock > 0 ? 'instock' : 'outofstock' );
        $product->save();
    }
}

Где $products_stock_data — массив вида [123 => 10, 124 => 0].

2. Для вариативных товаров обновляйте вариации отдельно

Обновление вариаций требует отдельного обхода:

function wc_update_variation_stock( $variation_id, $new_stock ) {
    $variation = wc_get_product( $variation_id );
    if ( ! $variation || 'variation' !== $variation->get_type() ) {
        return;
    }
    $variation->set_stock_quantity( $new_stock );
    $variation->set_stock_status( $new_stock > 0 ? 'instock' : 'outofstock' );
    $variation->save();
}

3. Автоматизируйте запуск синхронизации после импорта

Если вы используете сторонние плагины импорта, подключитесь к их хукам завершения импорта и вызовите свои функции обновления.

Например, для плагина WP All Import можно использовать хук pmxi_after_xml_import:

add_action( 'pmxi_after_xml_import', 'wc_custom_stock_sync_after_import' );
function wc_custom_stock_sync_after_import() {
    // Здесь вызовите wc_mass_update_stock или аналогичный код
}

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

• Проверьте в админке WooCommerce наличие корректных остатков на товарах и вариациях.
• Сделайте пробный заказ товара с обновленным запасом — убедитесь, что остаток уменьшается.
• Проверьте через базу данных, что _stock и _stock_status синхронизированы и обновлены.
• Используйте WP-CLI команду для проверки запасов: wp wc product get 123 --field=stock_quantity.

Частые ошибки и их устранение

• Обновление метаполей напрямую без вызова save() — приводит к отсутствию обновления кэша и хуков. Используйте методы WC_Product::set_stock_quantity() и save().
• Игнорирование вариаций — массовое обновление может менять только родительские товары, забывая вариации. Обходите все вариации и обновляйте отдельно.
• Конфликты с плагинами импорта — убедитесь, что после импорта запускается ваша синхронизация, иначе данные будут неактуальны.
• Проблемы с кэшированием — если установлен объектный кеш (Redis, Memcached), очистите его после обновлений.

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

• Для больших магазинов с тысячами товаров обновляйте остатки пакетами по 50-100 штук с паузами, чтобы не нагружать сервер.
• Используйте транзакции MySQL при необходимости для атомарности обновлений.
• Ограничьте доступ к функциям обновления запасов ролями администратора или автоматизируйте через Cron с проверкой безопасности.
• Логируйте обновления остатков для аудита и быстрого реагирования на ошибки.

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