WooCommerce: не обновляются складские остатки при массовом изменении товаров — как исправить

Диагностика проблемы с обновлением складских остатков

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

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

• Типы товаров: используются ли вариации? Вариационные товары требуют отдельного управления запасами на уровне вариаций.
• Методы массового обновления: вы используете встроенный импорт WooCommerce, сторонний плагин или пакетное редактирование через админку?
• Логи ошибок: включите WP_DEBUG и проверьте логи на наличие ошибок, связанных с функциями обновления запасов.
• Кэширование: активен ли объектный кеш или плагин кеширования, который может задерживать обновления?
• Хуки и фильтры: есть ли кастомный код или плагины, которые переопределяют стандартное поведение обновления запасов?

Пошаговое решение проблемы массового обновления складских остатков

1. Проверка и обновление настроек WooCommerce

Перейдите в WooCommerce » Настройки » Товары » Управление запасами. Убедитесь, что опция Включить управление запасами активирована.

2. Использование корректного метода массового обновления

Если вы используете CSV импорт, убедитесь, что в файле присутствует колонка stock_quantity и поле manage_stock установлено в 1 для каждого товара или вариации. Пример CSV-строки для вариации:

ID,type,sku,manage_stock,stock_quantity,parent_id
123,variation,SKU123,1,25,100

При пакетном редактировании в админке через Товары » Все товары и выбором нескольких позиций убедитесь, что действие Изменить корректно изменяет количество запасов, а не только статус.

3. Принудительное обновление запасов через WP-CLI

Если стандартные методы не работают, используйте WP-CLI для обновления запасов напрямую. Например, чтобы задать остаток товара с ID 123:

wp post meta update 123 _stock 25
wp post meta update 123 _stock_status instock

Для массового обновления можно подготовить скрипт на PHP с использованием WP-CLI или через wp-admin:

function update_stock_by_sku($sku, $new_stock) {
    $product_id = wc_get_product_id_by_sku($sku);
    if (!$product_id) return false;
    $product = wc_get_product($product_id);
    if (!$product) return false;
    $product->set_manage_stock(true);
    $product->set_stock_quantity($new_stock);
    $product->save();
    return true;
}
// Пример вызова
update_stock_by_sku('SKU123', 25);

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

Чтобы убедиться, что складские остатки обновлены корректно, выполните следующие проверки:

• В админке WooCommerce откройте карточку товара и проверьте поле Количество на складе.
• Сделайте тестовый заказ товара и убедитесь, что остаток уменьшается корректно.
• Если используете кэш, очистите его (например, плагин кеширования или серверный кеш).
• Проверьте базу данных в таблице wp_postmeta для соответствующих мета-ключей _stock и _stock_status.

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

• Не обновляются вариации: При массовом обновлении изменяйте запасы именно вариаций (тип записи product_variation), а не родительских товаров (variable).
• Ошибки в CSV импорте: Пропущено поле manage_stock или неверный формат чисел в stock_quantity.
• Кэш мешает обновлению: Не очищен объектный или плагинный кэш после обновления запасов.
• Конфликт с плагинами: Некоторые плагины для управления запасами могут блокировать стандартное обновление. Отключите их для теста.
• Отсутствие прав у пользователя: Убедитесь, что аккаунт, под которым вы редактируете товары, имеет необходимые права manage_woocommerce.

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

• Резервное копирование базы: Перед массовыми изменениями сделайте полное резервное копирование базы данных.
• Используйте WP-CLI: Для больших магазинов массовое обновление через WP-CLI быстрее и надежнее, чем через интерфейс.
• Оптимизация запросов: При программном обновлении обрабатывайте товары пакетами по 50–100 штук, чтобы избежать таймаутов и нагрузки.
• Отключение кэша на время обновления: Для корректного отражения изменений временно отключайте плагин кеширования или очищайте кэш после каждой партии обновлений.
• Логирование изменений: Включите логирование или ведите отдельный журнал обновлений для отслеживания ошибок и отката при необходимости.

Сравнение способов массового обновления складских остатков