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

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

В WooCommerce иногда возникает необходимость изменить адреса платежа (billing) и доставки (shipping) в уже созданном заказе автоматически. Причины могут быть разные: исправление данных клиентом через форму вне стандартного редактирования, интеграция с CRM, массовое обновление заказов, либо специальные условия доставки по геолокации.

Без корректного обновления этих данных заказ может иметь некорректные адреса, что приведёт к проблемам с доставкой и оплатой.

Как программно изменить адреса в заказе WooCommerce

Используем методы WC_Order для обновления адресов

Класс WC_Order предоставляет методы для установки данных адреса платежа и доставки. Важно после изменения вызвать save() для сохранения изменений в базе.

Пример кода для замены адресов:

function update_order_addresses( $order_id, $new_billing, $new_shipping ) {
    $order = wc_get_order( $order_id );
    if ( ! $order ) {
        return new WP_Error( 'invalid_order', 'Заказ не найден' );
    }

    // Обновляем адрес платежа
    foreach ( $new_billing as $key => $value ) {
        $order->set_billing( $key, $value );
    }

    // Обновляем адрес доставки
    foreach ( $new_shipping as $key => $value ) {
        $order->set_shipping( $key, $value );
    }

    $order->save();
    return true;
}

Пример вызова функции с новым адресом:

$new_billing = [
    'first_name' => 'Иван',
    'last_name' => 'Петров',
    'address_1' => 'ул. Ленина, д.1',
    'city' => 'Москва',
    'postcode' => '123456',
    'country' => 'RU',
    'email' => 'ivan.petrov@example.com'
];

$new_shipping = [
    'first_name' => 'Иван',
    'last_name' => 'Петров',
    'address_1' => 'ул. Ленина, д.1',
    'city' => 'Москва',
    'postcode' => '123456',
    'country' => 'RU'
];

update_order_addresses( 1234, $new_billing, $new_shipping );

Описание ключей массива адреса

Для set_billing() и set_shipping() доступны ключи:

• first_name
• last_name
• company
• address_1
• address_2
• city
• state
• postcode
• country
• email (только billing)
• phone (только billing)

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

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

$order = wc_get_order( 1234 );
echo 'Billing address: ' . $order->get_formatted_billing_address();
echo 'Shipping address: ' . $order->get_formatted_shipping_address();

Также проверьте в админке WooCommerce в карточке заказа — там должны отобразиться новые адреса.

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

• Ошибка: заказ не найден
  Причина: передан неверный ID заказа или заказ удалён. Проверьте корректность ID и наличие заказа.
• Адрес не сохраняется
  Причина: забыли вызвать $order->save() после установки полей.
• Некорректные ключи массива адреса
  Используйте только допустимые ключи, перечисленные выше. Иначе данные не применятся.
• Данные не отображаются в админке
  Возможно, кэширование. Очистите кэш сайта и браузера.

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

• Обязательно проверяйте права текущего пользователя перед изменением заказа, чтобы избежать несанкционированных изменений.
• Если меняете адреса массово, запускайте скрипты в CLI или через wp_cron, чтобы не нагружать сайт.
• Сохраняйте резервные копии базы перед массовыми изменениями.
• Избегайте прямого изменения данных в таблицах базы, используйте API WooCommerce для корректного обновления и запуска хук-событий.

Сравнение вариантов обновления адресов в WooCommerce