Shipping Rates

Описание

Базовый плагин @payloadcms/plugin-ecommerce добавляет на заказы только поле адреса доставки. Этот плагин восполняет пробел до оформления заказа: в админ-панели появляется коллекция shipping-zones, на корзины и заказы добавляется группа shipping для записи выбранного способа, а endpoint POST /api/shipping-rates/quote рассчитывает стоимость доставки по указанному адресу. Зона определяется по стране (конкретной стране или шаблону * для всех) и опционально по почтовым индексам. Поддерживаются четыре формата: числовые диапазоны вида 1000...1999, префиксные шаблоны вида SW1*, полный шаблон * и точное совпадение. Если несколько зон подходят под один адрес, выбирается ровно одна. Приоритет отдается явной настройке zone priority, затем специфичности (совпадение по почтовому индексу важнее совпадения по стране, конкретная страна важнее шаблона *), затем меньшему zone id. Результат детерминирован для одних и тех же корзины и адреса. В каждой зоне может быть сколько угодно способов доставки с пятью типами. flat списывает фиксированную сумму, free_over не списывает ничего после превышения порога подытога, weight_bands и price_bands выбирают стоимость по диапазону для веса или подытога, local_pickup списывает фиксированную сумму, обычно ноль. Диапазоны используют включающую границу from и исключающую to без верхнего предела при отсутствии to, а перед расчетом они сортируются по from, так что порядок ввода не влияет на результат. Все суммы хранятся в целых минорных единицах, как и цены в официальном плагине ecommerce. Если способ нельзя рассчитать, он исключается с указанием причины (below_threshold, class_excluded, misconfigured, no_band, subtotal_unknown, weight_unknown) и никогда не отдается с нулевой стоимостью. Когда ни одна зона не подходит под адрес, endpoint возвращает available: false с reason: 'no_matching_zone'. У плагина нет runtime-зависимостей и админ-компонентов, что сохраняет стабильность при минорных обновлениях Payload. Требуется Payload 3.88 или новее и официальный плагин ecommerce той же версии. Параметр weightUnit (g, kg, lb, oz) определяет, в каких единицах интерпретируются границы диапазонов по весу.

О пакете

Имя пакета

payload-shipping-rates

Последняя версия

1.0.0

Размер

50 кБ

Лицензия

MIT

Загрузок в неделю

1

Последняя публикация

21 авг. 2026 г.