Расчет стоимости доставки относительно МКАД (г. Москва) и КАД (г. Санкт-Петербург)

1. Установите модуль из Маркетплейс.
   
2. Зарегистрируйтесь в сервисе Dadata.
   
3. В настройках модуля Настройки->Настройки продукта->Настройки модулей->Расчет стоимости доставки относительно МКАД (г. Москва) и КАД (г. Санкт-Петербург) на вкладке «Интеграция с Dadata» укажите ключ API и секретный ключ, которые Вы можете взять в личном кабинете сервиса Dadata.
   
4. В меню Магазин->Настройки->Службы доставки нажмите кнопку «Добавить» и выберите необходимую службу доставки для МКАД или КАД.
   
5. В открывшемся окне на вкладке «Общие настройки» при необходимости измените название и описание службы доставки. На вкладке «Настройка обработчика» укажите цену доставки внутри МКАД (КАД). Если планируется простой расчет с ценой за километр, то укажите цену за километр. Если планируется тарификация по дистанциям, то отметьте соответствующий чекбокс.
   
6. Если на предыдущем шаге при добавлении службы доставки был отмечен чекбокс «Рассчитывать стоимость доставки на основе таблицы дистанций от МКАД (КАД)», то перейдите в настройки дистанций доставки Магазин->Настройки->МКАД (КАД) — стоимость доставки и добавьте цены для дистанций от МКАД (КАД)
   
7. Готово! Модуль настроен.
   

• OnDeliveryInMkadCalculated – сработает, когда стоимость доставки внутри МКАД рассчитана

• OnDeliveryOutMkadDistanceCalculated — сработает, когда стоимость доставки за МКАД на основе таблицы дистанций рассчитана

• OnDeliveryOutMkadForKmCalculated — сработает, когда стоимость доставки за МКАД на основе цены за километр рассчитана

• OnDeliveryInKadCalculated – сработает, когда стоимость доставки внутри КАД рассчитана

• OnDeliveryOutKadDistanceCalculated — сработает, когда стоимость доставки за КАД на основе таблицы дистанций рассчитана

• OnDeliveryOutKadForKmCalculated – сработает, когда стоимость доставки внутри КАД рассчитана

Все события принимают на вход 3 параметра:

• $order – экземпляр класса Bitrix\Sale\Order для текущего заказа

• $arAddress – массив с параметрами адреса, полученными от сервиса dadata.ru. Подробнее https://dadata.ru/api/clean/address/#response

• &$price – рассчитанная стоимость

Приведем пример, как повлиять на рассчитанную стоимость доставки. Допустим, при стоимости заказа более 3500 руб. доставка внутри МКАД должна быть бесплатной. Для решения задачи в файле /bitrix(local)/php_interface/init.php напишем следующий код:

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