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

Когда нужно автоматически менять адрес доставки в WooCommerce?

В стандартном процессе оформления заказа WooCommerce использует адрес, введённый пользователем. Однако в реальных бизнес-сценариях иногда требуется программно изменить адрес доставки после оформления заказа, например:

• Исправить ошибку в адресе (например, объединить поля, добавить регион).
• Заменить адрес на склад-партнёр или пункт самовывоза.
• Добавить дополнительные данные к адресу доставки, основанные на условиях (тип заказа, сумма, геолокация).

Без изменения адреса вручную в админке такое автоматическое обновление повышает удобство и снижает количество ошибок доставки.

Диагностика проблемы: почему стандартное изменение адреса не работает?

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

• Вы изменяете данные слишком поздно или рано, когда они уже сохранены или не применяются к объекту заказа.
• Изменения адреса записываются не в те поля объекта WC_Order, которые отвечают за доставку.
• Кэширование данных заказа в WooCommerce или сторонних плагинах мешает увидеть изменения.
• Отсутствие вызова метода save() после изменения объекта заказа.

Пошаговое решение для автоматического изменения адреса доставки

Шаг 1. Используем правильный хук для изменения адреса

Хук woocommerce_checkout_update_order_meta вызывается сразу после оформления заказа, но лучше менять адрес доставки на этапе woocommerce_checkout_create_order, когда создаётся объект заказа, но ещё не сохранён.

Шаг 2. Пример кода для автоматического изменения адреса доставки

add_action('woocommerce_checkout_create_order', 'wporders_change_shipping_address', 20, 2);
function wporders_change_shipping_address($order, $data) {
    // Пример: добавим к адресу доставки постфикс "- склад №3"
    $shipping_address_1 = $order->get_shipping_address_1();
    if ($shipping_address_1) {
        $new_address = $shipping_address_1 . ' - склад №3';
        $order->set_shipping_address_1($new_address);
    }
    // Можно изменить и другие поля, например, город
    $order->set_shipping_city('Москва');
}

Шаг 3. Сохраняем заказ

В этом хуке объект ещё не сохранён, поэтому вызов $order->save() не требуется — WooCommerce сохранит заказ после выполнения всех хуков.

Как проверить, что адрес изменён?

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

Частые ошибки при изменении адреса доставки

• Изменение адреса после сохранения заказа: если хук срабатывает слишком поздно (например, woocommerce_order_status_completed), изменения не сохранятся без повторного вызова save().
• Изменение неправильных полей: используйте методы set_shipping_address_*, нельзя менять адрес напрямую через метаполя.
• Отсутствие проверки существования поля: вызывайте методы только если поле не пустое, чтобы избежать ошибок.
• Конфликт с плагинами кэширования или оптимизации: отключите кэш на время тестов, чтобы изменения сразу отображались.

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

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

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