Установка и настройка плагина CDEK для Opencart
Ссылки и ресурсы
- Ссылка на плагин: https://shop.opencart-russia.ru/cdek_delivery
- Кабинет API Яндекс Карты: https://yandex.ru/maps-api/console
Перед установкой необходимо
- Скачать архив с плагином (не распаковывать)
- Получить ключи интеграции СДЭК
- Получить ключ для API Яндекс.Карт
Минимальные требования
- PHP 7.4 или новее
- Opencart 3.x (версии старше или новее 3 не поддерживаются)
- Разрешена загрузка файлов до 4 МБ
- Разрешены исходящие запросы к серверам
- Установленный cURL на сервере
Получение API-ключей СДЭК
Договор со СДЭК должен находиться в статусе «Подписан» и иметь тип «Договор с ИМ».
Ключи API автоматически отправляются на e-mail клиента, указанный в карточке контрагента (поле «E-mail для ЛК»), сразу после перевода договора в статус «Подписан».
Также ключи можно получить в личном кабинете СДЭК в разделе «Интеграция»:
Если ключей в ЛК нет
Если в разделе «Интеграция» ключи отсутствуют, но есть кнопка «Создать ключ» — нажмите её для подгрузки данных.
Установка плагина
-
Установите плагин через панель администратора: Расширения → Установка расширений → Загрузить. Выберите скачанный архив с плагином.
-
Обновите кэш модификаций: Расширения → Модификации → Обновить.
-
Перейдите в раздел: Расширения → Расширения. В фильтре по типу выберите «Доставка».
-
Найдите метод доставки «Метод доставки CDEK» и активируйте его, если он деактивирован. Затем перейдите в настройки расширения.
Настройка плагина
Шаг 1. Подключение к API
Введите Ключи интеграции СДЭК и ключ API Яндекс.Карт, затем нажмите кнопку «Подключить».
Где получить ключ Яндекс.Карты
Инструкцию можно найти на странице Яндекс.Карты.
Шаг 2. Тестовый режим
Для проверки работы плагина без риска создания реальных заказов доступен Тестовый режим.
Как активировать:
- Введите только Ключ Яндекс.Карты (ключи СДЭК можно оставить пустыми)
- Отметьте чек-бокс «Включить тестовый режим»
- Нажмите «Подключить»
Важно: в тестовом режиме заказы не создаются и не отображаются в ЛК СДЭК, доставка не выполняется. Список ПВЗ и расчёт стоимости — демонстрационные, не для реального использования.
Шаг 3. Основные блоки настроек
Настройки разбиты на 4 блока: «Продавец», «Доставка», «Габариты», «Цена».
Блок «Продавец»
Укажите:
- ФИО
- Номер телефона в международном формате
Блок «Доставка»
Настраиваются:
- Тарифы доставки
- Дополнительные дни — прибавляются к расчётному сроку
- Валюта расчёта
- Пункт отправки — для тарифа «от склада» (от ПВЗ СДЭК)
- Адрес отправки — для тарифа «от двери»
Как выбрать пункт отправки или адрес:
- Введите город в поле поиска (левый верхний угол карты).
- Переключите режим в правом верхнем углу карты:
- «От ПВЗ» — кликните по иконке ПВЗ → нажмите «Выбрать»
- «От двери» — кликните по карте → нажмите «Выбрать»
Выбор ПВЗ:
Выбор адреса:
Блок «Габариты»
Задаются габариты по умолчанию (длина × ширина × высота в см и вес в граммах). Они используются для товаров, у которых не заполнены свои габариты.
Как рассчитываются итоговые габариты заказа
Алгоритм:
- У каждого товара стороны сортируются по возрастанию.
- Если товаров > 1 — минимальная сторона умножается на количество, затем сортировка повторяется.
- Из всех товаров и настроек выбираются максимальные значения для каждой из трёх сторон (меньшее с меньшим, среднее со средним, большее с бо́льшим).
Пример расчёта
Заказ:
| Товар | Кол-во | Исходные габариты |
|---|---|---|
| Товар 1 | 1 | 10 × 12 × 15 |
| Товар 2 | 3 | 5 × 20 × 10 |
| Товар 3 | 1 | 7 × 3 × 25 |
Настройки по умолчанию: 12 × 12 × 12
Сравниваемые значения:
| Источник | Габариты (после сортировки) |
|---|---|
| Настройки | 12 × 12 × 12 |
| Товар 1 | 10 × 12 × 15 |
| Товар 2 (3 шт) | 10 × 15 × 20 |
| Товар 3 | 3 × 7 × 25 |
Итоговые габариты заказа: 12 × 15 × 25
Если в результате расчёта один из габаритов оказался равен 0, вместо него принудительно используется значение из настроек плагина.
Блок «Цена»
Позволяет настроить модификации стоимости доставки:
- «Дополнительная стоимость» — прибавляет заданное значение к стоимости доставки.
- «Увеличение в процентах» — добавляет процент от стоимости доставки к расчётной стоимости.
- «Фиксированная цена» — заменяет расчётную стоимость доставки на фиксированное значение.
- «Бесплатная доставка» — задаётся сумма заказа, от которой доставка становится бесплатной.
Модификации применяются последовательно в указанном порядке.
Пример: если заданы одновременно «Дополнительная стоимость» и «Фиксированная цена», то фиксированная цена заменит собой значение, которое было рассчитано с учётом дополнительной стоимости.
Сохранение настроек
После заполнения всех блоков нажмите кнопку «Сохранить» внизу страницы.
При корректном заполнении всех полей появится уведомление об успешном сохранении. Плагин готов к работе.
Логирование
В плагине предусмотрена возможность включения/отключения логирования.
Если посещаемость вашего сайта высокая, рекомендуется отключить логирование (снять чек-бокс в настройках) для экономии места в журнале ошибок.
