СДЭК
Инструкция состоит из нескольких частей:
- Подключение способа доставки «СДЭК»
- Добавление способа доставки в интернет-магазин
- Подключение виджета ПВЗ в виде карты
- Обновление виджета СДЭК с версии 2.0 на 3.0
Подключение способа доставки «СДЭК»
После подписания договора вы сможете получить ключи на странице: https://lk.cdek.ru/integration/index.
Скопируйте полученные ключи и переходите к добавлению способа доставки в интернет-магазин.
Добавление способа доставки в интернет-магазин
Перейдите в панель управления сайтом, откройте модуль «Интернет-магазин» и перейдите к способам оплаты и доставки.
Добавьте новый способ и активируйте модуль «СДЭК» для расчёта стоимости доставки. Затем нажмите на ссылку «Настройки модуля»:
Откроется окно с настройками:
- В поля «Идентификатор аккаунта» и «Пароль» введите свои данные для подключения.
- Нажмите «Проверить связь с сервисом», чтобы убедиться в корректности введённых данных.
- В разделе «Склад, с которого будут отправляться заказы» выберите нужный город и отделение.
- В пункте «Инфо-поле заказа» выберите поле, куда будет подставляться адрес доставки. Тип поля —
textarea
. - Выберите валюту договора с СДЭК, в которой ведётся расчёт.
- Укажите тип предоставляемых дополнительных услуг.
- Для передачи размеров укажите поля высота, ширина, длина — данные берутся из «Типичных габаритов упаковки».
- Выберите единицу измерения размера товара (мм, см, дм, м).
- Укажите вес посылки по умолчанию — используется, если у товаров не указан вес.
- Выберите единицу измерения веса (граммы или килограммы).
-
В разделе «Рассчитывать сумму доставки» настройте:
- расчёт стоимости доставки;
- сумму заказа, при которой доставка будет бесплатной.
- Коэффициент стоимости доставки — умножается на цену доставки (можно использовать как наценку).
- Наценка — добавляется к каждому отправлению.
- Стоимость по умолчанию — применяется, если не удалось получить расчёт от СДЭК.
-
Включите регистрацию доставки в СДЭК при смене статуса:
Передача заказа произойдёт при переходе статусов с Оплачен → Готов → Доставляется.Важно! Убедитесь в корректности контактных данных клиента — иначе накладная не сформируется. - Отображать выбор ПВЗ в виде карты — активируйте для отображения карты отделений доставки.
Подключение виджета ПВЗ в виде карты
Для подключения виджета пунктов выдачи заказов (ПВЗ) СДЭК необходимо получить 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, выполнив следующие действия:
-
Подключитесь к вашему серверу через FTP.
Подробнее — инструкция по подключению к PHP FTP. - Перейдите в корневую папку scripts и загрузите туда файл: cdek_service.php.
-
Откройте файл cdek_service.php в любом редакторе.
Найдите строки:'cdek-login'
— замените на ваш идентификатор аккаунта'cdek-pass'
— замените на ваш пароль
$service = new service( /** * Вставьте свой аккаунт\идентификатор для интеграции */ 'cdek-login', /** * Вставьте свой пароль для интеграции */ 'cdek-pass' );
Используйте те же данные, которые указаны у вас в настройках способа доставки СДЭК. После редактирования — сохраните файл и перезагрузите его на сервер, заменив исходный.
Примечание!
«Прошу вернуть бесплатный тариф для моего ключа (пример ключа). Сценарий — JavaScript API и HTTP Геокодер. Ключ нужен для конструктора карт».
TEXTAREA
в Списке полей заказа:
/panel/?a=shop&l=order.В него будет записываться информация о выбранном пункте выдачи при оформлении заказа.
После выполнения всех шагов и подключения всех компонентов, на странице оформления заказа появится ваш способ доставки СДЭК. Покупатель сможет выбрать город и отделение для доставки, а стоимость будет рассчитана автоматически.