Telegram
Будьте в курсе всех обновлений: подпишитесь на наш официальный Telegram-канал uCoz и задавайте вопросы в чате сообщества!

СДЭК

СДЭК
Материал добавлен: 15 Апреля 2021
Материал обновлен: 23 Апреля 2025

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

  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'
);

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

Примечание!

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

СДЭК