Служба доставки СДЭК для интернет-магазина на DIAFAN.CMS 7: карта пунктов выдачи и постаматов, доставка курьером, точный расчёт по API СДЭК и оформление заказов в СДЭК в один клик.
Покупатель выбирает пункт выдачи на карте СДЭК или указывает адрес для курьера — стоимость и срок сразу появляются в корзине. Вы оформляете заказ в СДЭК кнопкой в карточке заказа (или автоматически при смене статуса), печатаете накладную и следите за статусом, не заходя в личный кабинет СДЭК. Работает на API СДЭК v2 и официальном виджете карты ПВЗ, код модуля открыт.
Что умеет
- Три варианта доставки: до пункта выдачи, до постамата, курьером до двери. Для каждого выбирается тариф («Посылка», «Экономичная посылка», «Экспресс», от склада или от двери) или вариант отключается.
- Официальная карта СДЭК в корзине: всплывающее окно по кнопке (на телефоне — на весь экран) или карта сразу на странице. Поиск, фильтры, часы работы пунктов.
- Стоимость считается на сервере через API СДЭК по весу и размерам товаров из корзины, вместе со страховкой (объявленной стоимостью). Для товаров без веса и размеров — значения по умолчанию из настроек, плюс вес упаковки.
- Наценка в процентах и рублях (или скидка), округление вверх, минимальная стоимость, дни на сборку к сроку. Бесплатная доставка от суммы заказа — штатным порогом DIAFAN. В карте покупатель видит ту же цену, что в корзине.
- Покупатель изменил корзину или вы поменяли тариф и наценку — стоимость доставки пересчитается сама.
- Выбранный пункт или адрес подставляется в поле «Адрес» формы заказа и попадает в заказ вместе со сроком доставки.
- Заказ в СДЭК — кнопкой «Создать заказ в СДЭК» в карточке заказа или автоматически при выбранных статусах (например, «В обработке»).
- Наложенный платёж для выбранных способов оплаты, объявленная стоимость товаров (страховка; можно отключить).
- Трек-номер СДЭК сохраняется в заказе и виден покупателю в личном кабинете; в карточке заказа в админке — статус посылки и ссылка на отслеживание.
- Статусы обновляются сами: уведомления СДЭК (webhook) подключаются при первом заказе. Посылка вручена или вернулась — заказ на сайте получает выбранный статус.
- Печать накладной и штрихкода места (PDF; A4, A5 или A6 для термопринтера), удаление заказа в СДЭК, пока посылка не передана.
- Тестовый режим на тестовой среде СДЭК: всё можно проверить до подписания договора.
- Устойчивость к сбоям СДЭК: при временной недоступности API запросы повторяются, а после сбоя при оформлении заказ ищется по номеру — дублей не будет.
- Журнал запросов к СДЭК для разбора спорных случаев.
Как устроено
Ядро и стандартные файлы не изменяются. Модуль ставится как тема и добавляет службу доставки «СДЭК» в «Магазин → Способы доставки» (штатный механизм бэкендов доставки DIAFAN), блок «СДЭК» в карточку заказа — частичной кастомизацией. Нужны договор со СДЭК (ключи API в личном кабинете) и бесплатный ключ Яндекс.Карт для карты пунктов выдачи. Токены, справочники и расчёты кэшируются — корзина не тормозит.
Поддержка и вопросы
Помогу с установкой и настройкой, исправлю найденные ошибки. Пишите:
- E-mail: dimuchio@yandex.ru, dima_d-84@mail.ru
- Telegram: t.me/dimuchio
- MAX: написать в MAX
Лицензия: один домен
Покупка даёт право использовать модуль на одном сайте (одном домене). Модуль работает с лицензионным ключом, привязанным к этому домену; ключ подходит и для всех его поддоменов (www и т. п.).
— После покупки напишите мне домен сайта (на e-mail или в Telegram) — в течение дня пришлю ключ вида CDK-XXXX-XXXX-XXXX.
— Ключ вводится в админке: «Магазин» → «Способы доставки» → «СДЭК» → «Лицензионный ключ». Там же видно, подходит ли ключ для домена и работает ли подключение к СДЭК.
— Без ключа на рабочем домене способ доставки СДЭК недоступен покупателям, заказы в СДЭК не создаются.
— На локальных и тестовых адресах (localhost, *.local, *.test, 127.0.0.1, 192.168.*) модуль работает без ключа — можно установить и всё настроить до запуска.
— Для второго сайта (другого домена) нужна ещё одна покупка.
Требования
DIAFAN.CMS 7 (проверено на 7.6.6), модуль «Интернет-магазин», PHP с расширением cURL. Договор со СДЭК и ключи API (Личный кабинет СДЭК → Интеграция). Ключ «JavaScript API и HTTP Геокодер» Яндекс.Карт (бесплатно: developer.tech.yandex.ru).
Установка
- Сделайте резервную копию файлов сайта и базы данных.
- «Темы и дизайн» → «Добавить вручную»: в поле «Тема» впишите cdek, в «Импорт темы» загрузите архив, отметьте «Применить» и нажмите «Сохранить».
- Сбросьте кэш: «Настройки» → «Сбросить кэш».
- «Магазин» → «Способы доставки» → «Добавить»: название «СДЭК», «Служба доставки» — СДЭК. Введите лицензионный ключ, ключи API СДЭК, ключ Яндекс.Карт, город отправки и код ПВЗ, куда сдаёте посылки (или адрес склада для забора курьером), выберите тарифы и наценку. Сохраните — в блоке «Подключение» появится «СДЭК: подключение работает».
- Поле «Стоимость» у способа СДЭК оставьте пустым; для бесплатной доставки от суммы добавьте строку «0 от суммы 5000».
- Проверьте вес и размеры товаров (Магазин → товар → «Вес», «Длина», «Ширина», «Высота») или задайте значения по умолчанию в настройках СДЭК.
- Пока не введены ключи API, модуль работает с тестовой средой СДЭК: оформите тестовый заказ и создайте его в СДЭК кнопкой в карточке заказа.
Удаление
Удалите способ доставки «СДЭК» и тему cdek в «Темы и дизайн». Таблицы в базе модуль не создаёт.