Расчёт доставки: МКАД, КАД и произвольные зоны

1. Установите модуль из Маркетплейса.

2. Зарегистрируйтесь в сервисе DaData и получите API-ключ и секретный ключ в личном кабинете.

3. Откройте Настройки → Настройки продукта → Настройки модулей → Расчёт доставки: МКАД, КАД и произвольные зоны. На вкладке «Интеграция с Dadata» укажите API-ключ и секретный ключ.

В свойствах заказа должно быть свойство с флагом «Является адресом», его поле нужно вывести на страницу оформления заказа.

Служба МКАД или КАД

1. Перейдите в Магазин → Настройки → Службы доставки, нажмите «Добавить» и выберите службу для МКАД или КАД.
   
2. На вкладке «Общие настройки» при необходимости измените название и описание.
   
3. На вкладке «Настройка обработчика» укажите цену доставки внутри кольца. Для расчёта за километр заполните цену за километр. Для таблицы дистанций отметьте чекбокс «Рассчитывать стоимость доставки на основе таблицы дистанций».
   
4. Если включена таблица дистанций, откройте Магазин → Настройки → МКАД — стоимость доставки или КАД — стоимость доставки и задайте цены по диапазонам (например, 0–20 км и 21–40 км).
   

Служба по зонам на карте

1. В настройках модуля на вкладке «Зоны доставки» включите расчёт по зонам и укажите ключ JavaScript API Яндекс.Карт (не ключ Геокодера и не ключ DaData). Ключ получают в кабинете разработчика Яндекса. При необходимости задайте центр карты.
   
2. Сохраните настройки. В меню появится пункт Магазин → Настройки → Зоны доставки. Нарисуйте полигоны, укажите название и цену каждой зоны.
   
3. В Магазин → Настройки → Службы доставки добавьте службу «Доставка по зонам на карте». На вкладке «Настройка обработчика» выберите, что делать, если адрес вне зон: фиксированная цена или сообщение (например, «по согласованию»).
   

Готово: модуль настроен.

Разработчикам

Можно изменить уже рассчитанную стоимость через события модуля tmg.kaddelivery:

• OnDeliveryInMkadCalculated — стоимость внутри МКАД;
  
• OnDeliveryOutMkadDistanceCalculated — за МКАД по таблице дистанций;
  
• OnDeliveryOutMkadForKmCalculated — за МКАД по цене за километр;
  
• OnDeliveryInKadCalculated — стоимость внутри КАД;
  
• OnDeliveryOutKadDistanceCalculated — за КАД по таблице дистанций;
  
• OnDeliveryOutKadForKmCalculated — за КАД по цене за километр;
  
• OnDeliveryZoneCalculated — стоимость по зоне на карте (в том числе если адрес вне зон).
  

События МКАД и КАД получают три аргумента:

• $order — экземпляр Bitrix\Sale\Order;
  
• $arAddress — ответ DaData по адресу, см. документацию clean/address;
  
• &$price — рассчитанная стоимость, её можно изменить.
  

OnDeliveryZoneCalculated получает четвёртый аргумент $zone — строка найденной зоны или null, если адрес вне зон. Порядок аргументов: $order, $arAddress, $zone, &$price.

Пример: внутри МКАД доставка бесплатна, если сумма заказа больше 3500 ₽. В файле /bitrix/php_interface/init.php или /local/php_interface/init.php:

\Bitrix\Main\EventManager::getInstance()->addEventHandler(
    'tmg.kaddelivery',
    'OnDeliveryInMkadCalculated',
    'OnDeliveryInMkadCalculatedHandler'
);
function OnDeliveryInMkadCalculatedHandler($order, $arAddress, &$amp;price)
{
    if ($order->getPrice() > 3500) {
        $price = 0;
    }
}