Когда бесплатная доставка появляется «иногда», сначала выясните, что именно сравнивается с порогом. Сумма товаров до скидки, subtotal после купона, итог с налогом и уже добавленной доставкой — разные величины. Пока это правило не записано одним предложением, код корзины и checkout легко расходится.

Безопасный первый тест — четыре корзины: на одну копейку ниже порога, ровно на пороге, выше порога и выше порога до купона, но ниже после него. Для каждой сохраните зону доставки, валюту, состав, скидки и идентификатор выбранного правила. Так ошибка превращается из жалобы в воспроизводимый расчёт.

Разберите один заказ как решение правила

Поле traceПример значенияЗачем оно нужно
items_subtotal5000.00 RUBБаза без доставки и скидок
discount_total700.00 RUBПоказывает влияние купона
qualifying_amount4300.00 RUBФактическая сумма для порога
shipping_zoneRU-MOWОтделяет географическое условие
matched_rulefree_from_4500Указывает конкретную версию правила
decisionfalse: amount_below_thresholdОбъясняет результат интерфейсу

Trace не должен содержать адрес целиком или персональные данные. Достаточно нормализованной зоны, денежных значений, технического ID правила и причины. Если корзина говорит eligible=true, а заказ сохраняется с платным способом, сравнивайте версии входных данных между этими двумя моментами.

База расчёта задаётся явно

qualifyingAmount = itemsSubtotal
if rule.applyCouponBeforeThreshold:
    qualifyingAmount -= eligibleCouponDiscount
qualifies = qualifyingAmount >= rule.minimumAmount
qualifies = qualifies && zone.matches(destination)
qualifies = qualifies && currency == rule.currency
return Decision(qualifies, qualifyingAmount, rule.id, reason)

В документации WooCommerce выбор «до купона» или «после купона» сделан отдельной настройкой — это хороший пример того, почему скрытое допущение нельзя оставлять в коде. В своём магазине запишите правило бизнеса рядом с конфигурацией и версионируйте его, чтобы старый заказ можно было объяснить после изменения порога.

Зона проверяется раньше красивого баннера

  • Определите страну, регион и индекс из подтверждённого адреса, а не из IP пользователя.
  • Пустой адрес возвращает состояние «нужно выбрать регион», а не бесплатную доставку по умолчанию.
  • Правило относится к конкретной shipping zone и набору разрешённых методов.
  • Недоступный товар, отдельный склад или негабарит обрабатываются явным исключением.
  • Валюта порога совпадает с валютой qualifying amount либо сумма конвертируется по зафиксированному курсу.

Баннер «до бесплатной доставки осталось…» обязан вызывать тот же расчёт, что и checkout. Если виджет хранит ручной порог, а метод доставки читает настройки зоны, они разойдутся при первом обновлении. Передавайте клиенту qualifying amount, threshold и причину из одного backend-ответа.

Несколько правил требуют детерминированного приоритета

Купон с бесплатной доставкой, порог по сумме, акция для категории и льгота для конкретного региона могут сработать одновременно. Задайте порядок: запреты для негабарита, затем обязательные условия зоны, затем специальные купоны, затем общий порог. Результат включает победившее правило; порядок строк в базе не должен случайно менять цену.

Пересчёт выполняется после каждого значимого изменения

Eligibility устаревает после добавления товара, изменения количества, купона, адреса, валюты или способа получения. Сервер пересчитывает решение и возвращает новую версию корзины. При оформлении заказа он повторяет проверку внутри окончательного расчёта, а не доверяет флагу, который браузер получил несколько минут назад.

Матрица границ закрывает регресс

  1. Проверить сумму ниже порога, равную порогу и выше него в одной валюте.
  2. Применить купон и подтвердить выбранную бизнесом базу до или после скидки.
  3. Сменить адрес между разрешённой и запрещённой зонами.
  4. Добавить негабаритный товар и увидеть объяснимое исключение.
  5. Вернуться назад из оплаты, изменить корзину и получить новый расчёт.
  6. Создать заказ и сравнить сохранённый shipping rule trace с показанным checkout.

Для разбора подготовьте обезличенный состав корзины, денежные промежуточные значения, зону, активные правила с приоритетами и decision trace. Скрин страницы без этих данных показывает симптом, но не отвечает, какая именно сумма или зона дала неверный результат.

Проверенные источники