Когда бесплатная доставка появляется «иногда», сначала выясните, что именно сравнивается с порогом. Сумма товаров до скидки, subtotal после купона, итог с налогом и уже добавленной доставкой — разные величины. Пока это правило не записано одним предложением, код корзины и checkout легко расходится.
Безопасный первый тест — четыре корзины: на одну копейку ниже порога, ровно на пороге, выше порога и выше порога до купона, но ниже после него. Для каждой сохраните зону доставки, валюту, состав, скидки и идентификатор выбранного правила. Так ошибка превращается из жалобы в воспроизводимый расчёт.
Разберите один заказ как решение правила
| Поле trace | Пример значения | Зачем оно нужно |
|---|---|---|
| items_subtotal | 5000.00 RUB | База без доставки и скидок |
| discount_total | 700.00 RUB | Показывает влияние купона |
| qualifying_amount | 4300.00 RUB | Фактическая сумма для порога |
| shipping_zone | RU-MOW | Отделяет географическое условие |
| matched_rule | free_from_4500 | Указывает конкретную версию правила |
| decision | false: 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 устаревает после добавления товара, изменения количества, купона, адреса, валюты или способа получения. Сервер пересчитывает решение и возвращает новую версию корзины. При оформлении заказа он повторяет проверку внутри окончательного расчёта, а не доверяет флагу, который браузер получил несколько минут назад.
Матрица границ закрывает регресс
- Проверить сумму ниже порога, равную порогу и выше него в одной валюте.
- Применить купон и подтвердить выбранную бизнесом базу до или после скидки.
- Сменить адрес между разрешённой и запрещённой зонами.
- Добавить негабаритный товар и увидеть объяснимое исключение.
- Вернуться назад из оплаты, изменить корзину и получить новый расчёт.
- Создать заказ и сравнить сохранённый shipping rule trace с показанным checkout.
Для разбора подготовьте обезличенный состав корзины, денежные промежуточные значения, зону, активные правила с приоритетами и decision trace. Скрин страницы без этих данных показывает симптом, но не отвечает, какая именно сумма или зона дала неверный результат.