Для работы аддона необходима библиотека WT Cdek, которая автоматически устанавливается вместе с данным аддоном. После успешной установки вы увидите 2 сообщения: об установке библиотеки и установке способа доставки.

1. Настройка библиотеки WT CDEK

Для начала нужно указать API ключи CDEK из личного кабинета (раздел "Интеграция") в системном плагине WT Cdek. Подробнее в документации библиотеки.

2. Настройка расширения для расчета стоимости доставки JoomShopping

Пройдите в Компоненты - JoomShopping - Опции - Способ доставки. Нажмите кнопку "Создать".

Это необходимо для того, чтобы отображался виджет с картой для выбора пункта выдачи заказа CDEK. А так же информация о сроках доставки. Без этого будет работать только расчет стоимости (цена).

После заполнения всей необходимой информации нажмите "Сохранить и закрыть"

В списке расширений для расчета цены доставки Joomla JoomShopping выберите WT CDEK.

В его настройках важно в секции "Доставка" оставить галочки только для способов доставки CDEK. Все остальные (Почта России, Boxberry, Standart и Express и другие) нужно отключить. Это нужно для корректной работы расширений для расчета стоимости доставки, без конфликтов между расшрениями.

Укажите все остальные данные для расчета доставки: индекс отправителя, населенный пункт отправителя, тип доставки - физ.лицо (доставка) или интернет-магазин. Тарифы для физ.лиц и интернет-магазинов различаются.

Настройки веса

Единицы измерения веса - такие же, как в настройках JoomShopping. 

Коэффициенты поправки веса и общая наценка на способ доставки позволяют корректировать стоимость доставки в большую или меньшую сторону. По умолчанию коэффициент равен единице - 1. Если нужно увеличить стоимость - ставим коэффициент вида  1.1 (через точку, не запятую).

Коэффициент поправки веса - вес упаковки, тары. Умножает вес на этот коэффициент ДО расчета доставки.

Настройки виджета карты

Виджет для выбора пункта выдачи заказа или постамата CDEK представляет собой Яндекс.карту, которая может отображаться сразу на странице или в модальном (всплывающем) окне при клике на кнопку.

Для работы Яндекс.карты и отображения меток нужно сформировать API ключ на стороне Яндекса в Кабинете разработчика. При создании нового API ключа нужно выбрать тип JavaScript API и HTTP Геокодер. На момент написания этой документации бесплатный тариф API Яндекс.Карт позволял делать до 25000 запросов к API карт и до 1000 запросов к GEO-кодеру. Учитывайте эти лимиты для своего сайта. 

Настройки отладки и поведения при ошибках расчета цены доставки CDEK

Отладка нужна в тех случаях, когда "что-то пошло не так". В этом случае могут быть полезны технические данные, которые показывает отладка. Она отображается на шаге расчета доставки JoomShopping.

В этом же разделе находятся настройки поведения аддона при возникновении ошибок расчета доставки - когда возникает нулевая цена. 

При возникновении ошибок расчета доставки можно:

• оставить без изменений - способ доставки с нулевой ценой можно выбрать. По сути бесплатная доставка из-за технических ошибок.
• Сделать неактивным - способ доставки с нулевой ценой будет виден, но его нельзя будет выбрать.
• Скрыть - способ доставки с нулевой ценой будет сделан неактивным и скрыт от пользователя, его нельзя будет выбрать

Как правило нулевая цена возникает из-за того, что сервер CDEK не получает всю необходимую информацию, пользователем заполнены не все поля или возникли технические ошибки в процессе расчета стоимости.

3. Настройка других расширений для расчета цены доставки в JoomShopping

При настройке доставки в JoomShopping важно добиться того, чтобы действия расширений для расчета цены не пересекались и не мешали друг другу. Иначе могут быть ошибки в работе интернет-магазина и неправильно определяться стоимость доставки. Поэтому нужно зайти ВО ВСЕ расширения для расчета цены и убрать у них чекбоксы (галочки) со способа доставки CDEK.

4. Настройка цен доставки

Пройдите в Компоненты - JoomShopping - Опции - Цены на доставку. Нажмите кнопку "Создать".

Выберите способ доставки CDEK. Для разных стран цены на доставку могут быть разные. Если у ваших покупателей есть возможность указать страну на шаге заполнения адреса, то цены на способы доставки могут отличаться для разных стран. 

В полях "цена" и "стоимость упаковки" оставляем нули - 0, так как стоимость рассчитывается по API.

Ниже в поле "тариф" выберите нужный тариф, по которому будет производится расчет. Список тарифов зависит от выбранного типа в настройках расширения для расчета цены: тип "доставка" или "интернет-магазин".

5. Укажите лицензионный ключ в настройках сервера обновлений Joomla

Без этого вы не сможете получать новые версии с исправлением обнаруженных ошибок и новым функционалом. 

Подробнее: Как указать лицензионный ключ для расширения в Joomla 4, Joomla 5 и старше

6. Всё готово! Можно проверять.

Сделайте тестовый заказ сами у себя. Если все настройки были сделаны правильно - на шаге выбора способа доставки будет рассчитана цена доставки и показан виджет карты с выбором пункта выдачи заказа.

В тестовом заказе проверьте, что информация о выбранном пункте выдачи или постамате CDEK