WooCommerce: автоматическое изменение стоимости и складского остатка при обновлении заказа

Диагностика проблемы: почему нужно автоматически изменять цену и складские остатки

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

Если вы сталкиваетесь с одной из следующих ситуаций, автоматизация обновления цены и остатка — правильное решение:

• Изменение цены товара после оформления заказа из-за скидок или корректировок;
• Обновление складского остатка при изменении количества товаров в заказе;
• Необходимость синхронизации данных заказа с текущими данными каталога;
• Проблемы с отображением некорректной стоимости при редактировании заказа в админке.

Какие хуки и функции использовать для решения задачи

Основной хук для отслеживания обновления заказа — woocommerce_update_order. Однако, для более гибкого контроля стоит использовать woocommerce_order_status_changed или woocommerce_before_order_object_save, чтобы перехватить момент обновления перед сохранением.

Основные функции для работы с товарами и заказом:

• WC_Order::get_items() — получить товары заказа;
• WC_Order_Item_Product::set_subtotal() и ::set_total() — изменить цену конкретного товара;
• WC_Product::set_stock_quantity() — обновить запас товара;
• WC_Order::calculate_totals() — пересчитать итог заказа;
• WC_Order::save() — сохранить изменения заказа.

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

Ниже пример кода, который при обновлении заказа проверяет текущие цены и остатки товаров и синхронизирует их в заказе:

add_action('woocommerce_before_order_object_save', function($order) {
    // Проверяем, что это объект заказа
    if (! $order instanceof WC_Order) {
        return;
    }

    $items = $order->get_items();
    $updated = false;

    foreach ($items as $item_id => $item) {
        if (! $item instanceof WC_Order_Item_Product) {
            continue;
        }

        $product = $item->get_product();
        if (! $product) {
            continue;
        }

        // Получаем актуальную цену и остаток
        $current_price = $product->get_price();
        $current_stock = $product->get_stock_quantity();

        // Сравниваем с ценой в заказе
        $item_price = $item->get_total() / $item->get_quantity();

        if (floatval($item_price) !== floatval($current_price)) {
            // Обновляем цену
            $new_total = $current_price * $item->get_quantity();
            $item->set_subtotal($new_total);
            $item->set_total($new_total);
            $updated = true;
        }

        // Обновляем складской остаток товара
        $product->set_stock_quantity($current_stock);
        $product->save();
    }

    if ($updated) {
        $order->calculate_totals();
    }
});

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

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

• Создайте тестовый заказ с определёнными товарами и ценами.
• Измените цену товара в каталоге WooCommerce через админку.
• Обновите заказ в админке (например, измените статус, добавьте комментарий).
• Проверьте, что цена товара в заказе изменилась согласно новой цене.
• Проверьте складской остаток товара — он должен совпадать с тем, что в каталоге.
• Проверьте, что итог заказа корректно пересчитан.

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

• Отсутствие проверки типа объекта заказа: функция может вызываться не для заказа, что приведёт к ошибкам. Всегда проверяйте instanceof WC_Order.
• Изменения не сохраняются: после внесения изменений вызывайте $order->save() если изменения не применяются автоматически.
• Проблемы с типами цен: используйте floatval() для сравнения цен, чтобы избежать проблем с точностью.
• Обновление складского остатка без учёта реального движения товаров: будьте осторожны при ручном изменении остатков, чтобы не нарушить логику управления запасами WooCommerce.

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

• Минимизируйте изменения в хуках, которые вызываются часто, чтобы избежать замедления админки.
• Если у вас большой магазин, подумайте о кэшировании цен и остатков, чтобы не нагружать базу данными.
• Используйте транзакции или функции WooCommerce для работы с остатками, чтобы избежать гонок данных.
• Для сложных правил ценообразования лучше использовать отдельные плагины или кастомные решения, интегрированные с этим кодом.

Сравнение вариантов реализации