Инструкция состоит из нескольких частей:

1. Подключение способа доставки «СДЭК»
2. Добавление способа доставки в интернет-магазин
3. Подключение виджета ПВЗ в виде карты
4. Обновление виджета СДЭК с версии 2.0 на 3.0

Подключение способа доставки «СДЭК»

После подписания договора вы сможете получить ключи на странице: https://lk.cdek.ru/integration/index.

Скопируйте полученные ключи и переходите к добавлению способа доставки в интернет-магазин.

Добавление способа доставки в интернет-магазин

Перейдите в панель управления сайтом, откройте модуль «Интернет-магазин» и перейдите к способам оплаты и доставки.

Добавьте новый способ и активируйте модуль «СДЭК» для расчёта стоимости доставки. Затем нажмите на ссылку «Настройки модуля»:

Откроется окно с настройками:

1. В поля «Идентификатор аккаунта» и «Пароль» введите свои данные для подключения.
2. Нажмите «Проверить связь с сервисом», чтобы убедиться в корректности введённых данных.
3. В разделе «Склад, с которого будут отправляться заказы» выберите нужный город и отделение.
4. В пункте «Инфо-поле заказа» выберите поле, куда будет подставляться адрес доставки. Тип поля — textarea.
5. Выберите валюту договора с СДЭК, в которой ведётся расчёт.
6. Укажите тип предоставляемых дополнительных услуг.
7. Для передачи размеров укажите поля высота, ширина, длина — данные берутся из «Типичных габаритов упаковки».
8. Выберите единицу измерения размера товара (мм, см, дм, м).
9. Укажите вес посылки по умолчанию — используется, если у товаров не указан вес.
10. Выберите единицу измерения веса (граммы или килограммы).
11. В разделе «Рассчитывать сумму доставки» настройте:
    • расчёт стоимости доставки;
    • сумму заказа, при которой доставка будет бесплатной.
12. Коэффициент стоимости доставки — умножается на цену доставки (можно использовать как наценку).
13. Наценка — добавляется к каждому отправлению.
14. Стоимость по умолчанию — применяется, если не удалось получить расчёт от СДЭК.
15. Включите регистрацию доставки в СДЭК при смене статуса:
    Передача заказа произойдёт при переходе статусов с Оплачен → Готов → Доставляется.
    Важно! Убедитесь в корректности контактных данных клиента — иначе накладная не сформируется.
16. Отображать выбор ПВЗ в виде карты — активируйте для отображения карты отделений доставки.

Подключение виджета ПВЗ в виде карты

Для подключения виджета пунктов выдачи заказов (ПВЗ) СДЭК необходимо получить API-ключ от Яндекс.Карт.

Перейдите на сайт https://developer.tech.yandex.ru/ и нажмите кнопку «Подключить API»:

Отметьте пункты JavaScript API и HTTP Геокодер:

Нажмите «Продолжить».

Далее заполните форму: укажите почту, номер телефона, выберите — физическое или юридическое лицо и т.д.

В поле «Цель использования» выберите пункт «Нужен API ключ для конструктора карт»:

После заполнения всех полей нажмите «Продолжить».

После создания ключа вы попадёте на страницу https://developer.tech.yandex.ru/services/3, где можно скопировать ключ:

Скопированный ключ вставьте в настройки способа доставки СДЭК:

Не забудьте сохранить изменения.

Дополнительная настройка API-ключа

На странице управления ключом нажмите кнопку «Изменить»:

В поле «Ограничение по HTTP Referer» укажите два домена:

• widget.cdek.ru
• ваш-домен.ru — замените на адрес своего сайта

После указания доменов нажмите «Сохранить». Подождите около 15 минут — после этого виджет ПВЗ должен заработать на вашем сайте:

Обновление виджета СДЭК с версии 2.0 на 3.0

С недавнего времени компания СДЭК прекратила поддержку виджета версии 2.0, что нарушило работу карты выбора отделения и кнопки «Выбрать адрес».

Чтобы восстановить функциональность, необходимо перейти на версию 3.0, выполнив следующие действия:

1. Подключитесь к вашему серверу через FTP.
   Подробнее — инструкция по подключению к PHP FTP.
2. Перейдите в корневую папку scripts и загрузите туда файл: cdek_service.php.
3. Откройте файл cdek_service.php в любом редакторе.
   Найдите строки:
   • 'cdek-login' — замените на ваш идентификатор аккаунта
   • 'cdek-pass' — замените на ваш пароль

$service = new service(
 /**
 * Вставьте свой аккаунт\идентификатор для интеграции
 */
 'cdek-login',
 
 /**
 * Вставьте свой пароль для интеграции
 */
 'cdek-pass'
);

Используйте те же данные, которые указаны у вас в настройках способа доставки СДЭК. После редактирования — сохраните файл и перезагрузите его на сервер, заменив исходный.

Примечание!

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