Главная
/
Блог
/
Подключение СДЭК к интернет-магазину: модули, интеграция и автоматизация

Интеграция доставки в интернет-магазин: программный интерфейс, готовые модули и автоматизация

Введение

«Хочу добавить СДЭК на сайт — с чего начать?» — один из самых частых вопросов от владельцев интернет-магазинов. Хорошая новость: в большинстве случаев это не требует программиста. Есть готовые модули почти для всех популярных платформ — от Битрикса до WooCommerce.

Но даже если вы идёте по пути готового решения, важно понимать, как устроена интеграция изнутри: какие данные передаются, как работает автоматическая передача заказов и что делать, когда что-то пошло не так.
В этой статье — весь путь от регистрации до первой автоматической отгрузки. Условия для интернет-магазинов и вход в личный кабинет — на cdek-reg.ru.

Базовое подключение за 1–2 дня

Регистрация

В личном кабинете СДЭК

Оферта

Подпишите договор

Модуль

Установите для вашей CMS

Тест

Протестируйте в sandbox

Заказ

Отправьте первый заказ

Договор и доступ: с чего всё начинается

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

Регистрация, тип договора и тестовая среда

Что подготовить для регистрации:

ИП: паспорт, ИНН, ОГРНИП, банковские реквизиты. Полный список — в разделе документов на cdek-reg.ru
ООО: ИНН, ОГРН, устав, приказ о назначении директора, банковские реквизиты
Самозанятые: паспорт, ИНН, справка о постановке на учёт как плательщика налога на профессиональный доход

Как проходит подключение — шаг за шагом:

Зайдите в личный кабинет СДЭК и заполните заявку на подключение.
Выберите тип договора. Публичная оферта — для старта без минимальных объёмов, подписывается онлайн за несколько часов. Индивидуальный договор — для магазинов с объёмом от 100 и более отправлений в месяц, даёт персональные тарифы.
Подпишите документы: электронно или через менеджера.
Дождитесь активации личного кабинета — обычно в течение одного рабочего дня.
Запросите доступ к тестовой среде (она здесь называется «песочница») через раздел «Интеграции» в личном кабинете или через тикет в поддержку.

Реальный пример: ИП, продающий одежду на WooCommerce, активировал аккаунт СДЭК за 4 часа через оферту, получил доступ к тестовой среде по тикету в тот же день и к вечеру отправил первый тестовый заказ.

Сроки и условия зависят от региона и статуса проверки документов.

Где взять ключи для подключения

После активации войдите в личный кабинет → Настройки → Интеграции → Программный интерфейс. Там вы найдёте свои учётные данные.

Как хранить ключи, чтобы не было проблем:

Никогда не добавляйте ключи в общий код репозитория — используйте файлы настроек окружения (.env) и исключайте их из системы контроля версий
На рабочем сервере храните ключи в переменных окружения или специальном хранилище секретов
Для каждой среды — тестовой и боевой — используйте отдельную пару ключей
Меняйте ключи раз в 6–12 месяцев или немедленно, если есть подозрение на утечку

Официальная документация по авторизации — на портале api-docs.cdek.ru.

Настройка способов и тарифов СДЭК в магазине

Выбор способов: ПВЗ, курьер, постаматы

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

Какие способы доставки включать и когда

У СДЭК несколько каналов доставки. Показывать их все сразу всем покупателям — плохая идея: это запутывает и снижает конверсию. Лучше настроить фильтры.

Простые правила фильтрации в корзине:

Пункты выдачи и постаматы — только для заказов до 30 кг
Постаматы — скрывать, если хотя бы один габарит превышает 36 см
Удалённые регионы — предлагать только эконом-тариф и пункты выдачи
Заказ дороже 10 000 ₽ — предлагать курьера со страхованием

По наблюдениям из практики, для товаров до 2 кг (одежда, аксессуары, косметика) выкуп через пункты выдачи в среднем выше: клиент сам приходит в удобное время и реже отказывается.

Страхование и наложенный платёж: как настроить

Две опции, которые напрямую влияют на стоимость для магазина и доверие покупателей — особенно в регионах, где многие до сих пор предпочитают платить при получении.

Как работает наложенный платёж в расчёте — на примере:

Заказ на 3 500 ₽. Тариф доставки — 320 ₽. Комиссия за наложенный платёж 2% — 70 ₽. Страхование 0,7% — 30 ₽.

Итого расходов магазина: 420 ₽. Покупатель оплачивает 3 500 ₽ при получении.
Комиссии и минимальные суммы зависят от вашего договора — уточняйте у менеджера СДЭК.

Сроки доставки в корзине: как показывать честно

Хорошо прописанные сроки снижают тревожность покупателя и количество звонков в поддержку. Главное правило — не обещайте минимум, показывайте диапазон.

Простой способ рассчитать срок для отображения:
Срок из системы СДЭК + 1 день (для направлений 1–2 зоны) или + 2 дня (для зон 3–5).

Показывайте диапазон дат: «Доставим 24–26 марта» — это честнее и снижает ожидания
В ноябре–декабре добавьте плашку: «Сроки могут быть увеличены на 1–2 дня из-за высокой загрузки»
Для курьера по Москве — предлагайте выбор временного интервала, если тариф это поддерживает

Сроки ориентировочные — зависят от сезона, нагрузки на сеть и региона получателя.

Готовые модули для платформ и собственная интеграция

Хорошая новость: для большинства популярных платформ у СДЭК есть готовые модули. Они экономят дни работы и не требуют знания программирования.

Установка модуля: 1С-Битрикс, WooCommerce, OpenCart

Порядок установки — одинаков для большинства платформ:

Скачайте модуль из официального репозитория или каталога дополнений вашей платформы.
Установите через панель администратора.
Введите учётные данные из личного кабинета: логин + пароль или токен авторизации.
Задайте единицы измерения: вес в килограммах, размеры в сантиметрах. Частая ошибка — перепутать граммы с килограммами, и система считает 1 500 кг вместо 1,5.
Включите карту пунктов выдачи в корзине — покупатель сможет выбрать удобную точку визуально.
Настройте кэш (временное сохранение) списка пунктов выдачи: обновляйте его раз в 4–12 часов. Они меняются редко, но бывают закрытия.
Проверьте тестовый расчёт в песочнице.
Переключитесь на боевые ключи и сделайте один тестовый заказ на небольшую сумму.

Перед каждым обновлением модуля СДЭК сверяйтесь с changelog на совместимость с вашей версией PHP и платформы. Зафиксируйте рабочую версию в своей документации.

Собственная интеграция через программный интерфейс

Если у вас кастомный сайт или нужна нестандартная логика — подключайтесь напрямую через интерфейс СДЭК версии 2. Это даёт полный контроль над поведением системы.

Последовательность запросов при оформлении заказа:

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

Что обязательно проверять перед отправкой запроса:

Вес больше нуля килограммов и не превышает лимит выбранного тарифа
Все три размера указаны и больше нуля сантиметров
Код города или пункта выдачи — только из справочника СДЭК, не набранный вручную
Телефон получателя в формате +7XXXXXXXXXX

Как сделать интеграцию устойчивой к сбоям:

Таймаут запроса к системе СДЭК — не более 3–5 секунд; при превышении показывайте резервный вариант (последний сохранённый тариф или скрывайте СДЭК)
При ошибке сервера (код 5xx) — повторите запрос до 3 раз с нарастающей паузой: через 1 секунду, затем через 2, затем через 4
При ошибке данных (код 4xx) — не повторяйте, сохраните лог и уведомите администратора
При создании отправления передавайте уникальный идентификатор вашего заказа — это защищает от дублей при повторном запросе

Официальная документация — на портале api-docs.cdek.ru. Зафиксируйте используемую версию и следите за журналом изменений.

Калькулятор доставки на сайте: подключение и диагностика

Калькулятор стоимости — это не просто удобство. Покупатель, который видит точную сумму и срок ещё на этапе выбора товара, реже бросает корзину и реже отказывается от выкупа.

Как настроить онлайн-расчёт стоимости

У СДЭК есть два варианта: встраиваемый виджет-калькулятор (простой, для тех, кто не хочет писать код) и запросы через программный интерфейс (гибкий, для кастомных решений).

Что обязательно передавать для корректного расчёта:

Как правильно кэшировать (сохранять) тарифы:

Сохраняйте результат расчёта на 15–30 минут — тарифы меняются редко, повторные запросы впустую нагружают систему
Ключ для кэша: откуда + куда + вес + размеры + список услуг
При устаревшем кэше — обновляйте в фоне, покупателю показывайте последнее сохранённое значение
Резервный вариант при недоступности системы: показывайте последний известный тариф с пометкой «Стоимость уточняется»

Что делать, если расчёт возвращает ноль или ошибку

Нулевая стоимость или ошибка калькулятора — самая частая жалоба при первом подключении. Причин всего несколько, и все они решаются за 5–10 минут, если знать порядок проверки.

Быстрая проверка при любой ошибке — по порядку:

Вес передан в граммах, а не в килограммах?
Все три размера заполнены и больше нуля?
Код города взят из справочника СДЭК, а не написан вручную?
Используются правильные ключи: для тестовой среды — тестовые, для боевой — боевые?
Выбранный тариф существует между этими точками?
Не превышен лимит веса или габаритов для этого тарифа?

Форматы ошибок и коды могут отличаться в зависимости от версии программного интерфейса. Сверяйтесь с актуальной документацией.

Передача заказов, ярлыки и вызов курьера

Это операционное сердце интеграции. Чем лучше автоматизирована передача заказов, тем меньше ручной работы — и тем меньше ошибок.

Автопередача заказов и статусы

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

Правильные моменты для передачи заказа в СДЭК:

Статус «Оплачен» — для заказов с предоплатой
Статус «Подтверждён» — для заказов с оплатой при получении
Контактные данные покупателя заполнены и корректны
Адрес доставки или выбранный пункт выдачи указаны
Не передавать заказы в статусе «В обработке» или «Ожидает оплаты»

Что делать при ошибке передачи:

Ошибка со стороны сервера СДЭК (код 5xx) — повторите до 3 раз с паузами 1 / 2 / 4 минуты
Ошибка в данных (код 4xx) — не повторяйте автоматически, исправьте данные и передайте вручную
Передавайте уникальный номер заказа из вашей системы — это защищает от дублей при повторных попытках
Ведите журнал всех запросов и ответов — пригодится при разборе инцидентов

Печать ярлыков и бронирование пунктов выдачи

После создания отправления нужно напечатать ярлык для наклейки на посылку. И убедиться, что выбранный покупателем пункт выдачи всё ещё работает.

Как получить ярлык:

Запросите документ через систему СДЭК — в формате PDF или в формате для термопринтеров (ZPL)
Формат А6 (термоэтикетка) — стандарт для большинства складов и курьерских служб
Формат для термопринтеров — удобен при больших объёмах, от 50 отправлений в день
Пакетная печать: передайте несколько номеров в одном запросе — получите один файл со всеми ярлыками

Как не попасть впросак с пунктом выдачи:

Всегда проверяйте актуальность пункта выдачи перед бронированием — точки иногда закрываются без предупреждения
Убедитесь, что ПВЗ принимает посылки нужного веса и габаритов
Проверяйте часы работы — особенно при отправке в пятницу вечером

Практика: при отправке 20 посылок за один раз пакетная печать ярлыков занимает 1–2 минуты вместо 30+. Проверьте ПВЗ за 1–2 часа до сдачи — это снимет половину возможных проблем.

Как вызвать курьера и что делать при изменении заказа

Создание отправления в системе и вызов курьера для его забора — это два разных действия. Многие об этом забывают и потом ждут курьера, которого никто не вызвал.

Создайте заявку на забор: укажите адрес склада, удобный временной интервал, количество посылок и общий вес.
Дождитесь подтверждения от СДЭК — придёт номер заявки и примерное время прибытия курьера.
Подготовьте посылки с наклеенными ярлыками до приезда курьера.
Если нужно изменить заявку — сделайте это не позднее чем за 2 часа до указанного интервала.

Важные детали, которые лучше знать заранее:

Минимальный срок подачи заявки: за 2–4 часа до желаемого интервала (уточняйте по вашему региону)
Изменили вес или количество мест — обязательно обновите заявку, иначе возможна доплата
Отмена позже чем за 2 часа до забора — возможен штраф за выезд курьера

Шаблон уведомления для склада:

Сегодня с [время начала] до [время конца] ожидаем курьера СДЭК.
Подготовьте [N] посылок. Номер заявки на забор: [номер].

Условия отмены и штрафные сборы зависят от вашего договора и региона.

Трекинг и уведомления для покупателя

Правильно настроенный трекинг — это не просто ссылка «узнайте, где ваш заказ». Это способ снизить нагрузку на поддержку и повысить доверие покупателя.

Номер отслеживания и как его показывать

Номер для отслеживания (в документах СДЭК — cdek_number) появляется в ответ на запрос информации по отправлению — обычно в течение нескольких минут после создания. Найти его можно и в личном кабинете.

Что делать с номером отслеживания:

Сохраните внутренний идентификатор отправления и номер для трекинга в базу данных магазина
Покажите покупателю кликабельную ссылку в личном кабинете: https://www.cdek.ru/ru/tracking?order_id={номер}
В письме продублируйте ссылку и краткое описание текущего статуса
Не показывайте персональные данные других людей — только город доставки и инициалы получателя

Уведомления о событиях: как настроить

Уведомления о статусах можно получать двумя способами: через подписку на события (система СДЭК сама присылает данные при каждом изменении) или через периодический опрос (вы сами спрашиваете «что нового?» раз в полчаса). Первый способ быстрее и надёжнее.

Как настроить подписку на события — пошагово:

В личном кабинете перейдите в Настройки → Интеграции → Уведомления о событиях.
Укажите адрес вашего сервера для приёма уведомлений — он должен работать по защищённому протоколу HTTPS.
Выберите события: «Смена статуса заказа» — обязательно.
Настройте проверку подписи входящих запросов — это защитит от поддельных уведомлений.
Ведите журнал всех входящих событий для диагностики.
Учтите, что одно событие может прийти дважды — обрабатывайте по уникальному идентификатору события, а не просто по факту получения.

Резервный периодический опрос на случай сбоя:

Запрашивайте статусы активных отправлений раз в 30–60 минут
Когда заказ достиг финального статуса (вручен, не вручен, отменён) — исключите его из опроса

Когда отправлять уведомления покупателю:

СМС-уведомления тарифицируются отдельно — через вашего оператора рассылок. Согласие покупателя на получение сообщений нужно получить при оформлении заказа (требование закона о персональных данных).

Документация и тестовая среда

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

Где найти документацию и как в ней ориентироваться

Официальный портал для разработчиков — api-docs.cdek.ru. Там описаны все запросы, примеры и форматы данных.

Используйте версию 2 программного интерфейса — это актуальная стабильная версия для новых проектов
Следите за журналом изменений: при обновлениях СДЭК анонсирует их заранее
Зафиксируйте используемую версию в своей документации

Тестирование и типовые ошибки

Тестовая среда — это полная копия боевой системы, только без реальных денег и посылок. Там можно проверить весь сценарий от регистрации до смены статуса.

Как работать с тестовой средой:

Адрес тестовой системы: https://api.edu.cdek.ru/v2/
Тестовые ключи запрашиваются через личный кабинет или тикет в поддержку
Используйте только тестовые коды городов из документации — реальные коды могут не работать в песочнице
Обязательные сценарии для проверки: расчёт тарифа, создание заказа, получение номера отслеживания, смена статусов, скачивание ярлыка

Тестовая среда может немного отличаться от боевой по поведению. Перед запуском обязательно проведите финальный тест на реальных данных с небольшой партией заказов.

Стоимость подключения и условия работы

Плата за подключение и скидки по объёму

Сразу хорошая новость: подключение бесплатно, абонентской платы нет. Вы платите только за реальные отправления — по тарифу.

Когда переходить на индивидуальный договор:

Стабильный объём от 300 и более отправлений в месяц в течение 2–3 месяцев подряд
Высокая доля пунктов выдачи (более 60%) — это аргумент для снижения ставки
Предсказуемая география заказов и низкий уровень возвратов

Актуальные условия для интернет-магазинов — на cdek-reg.ru. Там же можно оставить заявку на консультацию.

Цифры ориентировочные — зависят от региона, направлений и оборота.

Наложенный платёж: комиссия и сверка

Оплата при получении — популярная опция для региональных покупателей и тех, кто впервые заказывает в вашем магазине. Но важно правильно настроить сверку, чтобы деньги не «терялись».

Как принимается оплата при получении:

Курьер до двери: принимает наличные или оплату по карте через мобильный терминал, выдаёт кассовый чек
Выдача в пункте выдачи: оператор принимает оплату, выдаёт чек
Постамат: только банковская карта при получении

Как не запутаться в деньгах — сверка реестров:

Выгружайте реестры перечислений из личного кабинета СДЭК каждую неделю
Сверяйте с заказами в вашей системе по номеру отслеживания и сумме
Для автоматической сверки используйте запрос к отчётам по платежам
При расхождениях обращайтесь в поддержку СДЭК с актом сверки в течение 30 дней

Документы для оформления работы с наложенным платежом — в разделе документов на cdek-reg.ru.

Сроки перечисления и размер комиссии зависят от условий вашего договора.

Поддержка и диагностика: что делать, когда что-то пошло не так

Куда обращаться и как составить запрос

По вопросам интеграции — не звоните на общую горячую линию. Там помогут с посылками, но не с кодом. Для технических вопросов есть специальные каналы.

Шаблон обращения в техподдержку (скопируйте и заполните):

Номер договора / Account
Среда: sandbox или production
Эндпоинт и метод запроса
Тело запроса (без персональных данных)
Полный ответ API: код, тело
Дата и время запроса с часовым поясом
Что ожидали и что получили

Шаблон обращения в техподдержку (скопируйте и заполните):

Номер договора / Account
Среда: sandbox или production
Эндпоинт и метод запроса
Тело запроса (без персональных данных)
Полный ответ API: код, тело
Дата и время запроса с часовым поясом
Что ожидали и что получили

Типовые проблемы и как их решать

Большинство проблем решаются за 5–15 минут, если знать, куда смотреть. Вот самые частые:

Универсальный порядок диагностики:

Воспроизвести проблему в тестовой среде на минимальном примере.
Собрать полный лог: запрос, ответ, время, код ответа.
Сверить с документацией — всё ли правильно в данных?
Пройти по чек-листу из раздела о калькуляторе.
Если воспроизводится на чистых данных — создать тикет с заполненным шаблоном выше.

Часть проблем может быть на стороне вашей сети, платформы или хостинга. Убедитесь, что сервер доступен из интернета и может отправлять исходящие запросы по защищённому протоколу.

Заключение

Подключить СДЭК к интернет-магазину — реальная задача, которая решается за 1–2 дня при наличии готового модуля или за 3–5 дней при разработке собственной интеграции. Главное — идти по порядку и не пропускать тестирование.

Вот финальный чек-лист запуска:

Зарегистрируйтесь и подпишите договор — оферта или индивидуальный.
Получите учётные данные и запросите доступ к тестовой среде.
Установите готовый модуль или разработайте собственную интеграцию.
Настройте способы доставки, тарифы, страхование и наложенный платёж.
Проверьте онлайн-калькулятор и обработку ошибок в тестовой среде.
Настройте автопередачу заказов, скачивание ярлыков и вызов курьера.
Подключите уведомления о событиях и цепочку сообщений для покупателя.
Сделайте 3–5 тестовых отгрузок на небольших реальных заказах.
Зафиксируйте порядок работы с поддержкой на случай сбоев.

Начните прямо сейчас!
Войдите в личный кабинет СДЭК — это займёт несколько минут. Базовое подключение через готовый модуль — 1–2 часа. Условия для интернет-магазинов — на cdek-reg.ru.

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

Часто задаваемые вопросы

1

Что делать, если система СДЭК недоступна и статусы не обновляются?

Настройте резервный периодический опрос статусов раз в 30–60 минут — в дополнение к основным уведомлениям о событиях. Сохраняйте рассчитанные тарифы в кэш — корзина продолжит работать при кратких сбоях. В панели администратора держите кнопку ручного обновления статуса. Следите за страницей статуса системы СДЭК.

2

Как не запутаться с наложенным платежом и не потерять деньги?

Включайте оплату при получении только как явную опцию, а комиссию закладывайте в правила ценообразования магазина. Настройте автоматическую еженедельную сверку реестров выплат с заказами в вашей системе. При расхождениях обращайтесь в поддержку в течение 30 дней.

3

Расчёт стоимости выдаёт ноль или ошибку — с чего начать?

Последовательно проверьте: коды городов из справочника СДЭК (не вручную), ненулевые размеры, вес в граммах, а не килограммах, доступность выбранного тарифа между этими двумя точками, актуальность учётных данных. Если в тестовой среде работает, а в боевой нет — сравните ключи и адрес системы.

4

Статусы не приходят в магазин — как настроить трекинг?

Проверьте настройку уведомлений о событиях: адрес вашего сервера должен быть доступен из интернета по защищённому протоколу. Добавьте адреса серверов СДЭК в список разрешённых на вашем хостинге. Ведите журнал входящих уведомлений. Добавьте резервный периодический опрос.

5

Подключение СДЭК — это сложно и долго, правда?

Нет. Готовый модуль для популярной платформы настраивается за 1–2 часа. Тестовая среда бесплатна и доступна сразу после регистрации. Абонентской платы нет — платите только за реальные отправления. Разработку через программный интерфейс можно делать постепенно, не останавливая продажи.

6

У меня мало заказов — есть ли смысл подключать СДЭК?

Да. Минимального объёма нет — платите за каждое отправление по тарифу. Пункты выдачи и постаматы помогают предложить покупателям удобную доставку даже при небольших оборотах. По мере роста переходите на индивидуальный договор. Подробности — для интернет-магазинов на cdek-reg.ru.

7

Где взять ключи для программного интерфейса и как включить тестовую среду?

Зарегистрируйтесь, подпишите оферту, войдите в личный кабинет → Настройки → Интеграции → Программный интерфейс. Для тестовой среды — тикет в поддержку или тот же раздел. Для каждой среды — отдельная пара ключей.

8

Как добавить варианты доставки СДЭК в корзину на сайте?

Активируйте нужные тарифы в настройках модуля или через запрос к системе расчёта. Включите карту пунктов выдачи с фильтрами по размеру. Задайте правила показа тарифов по весу, региону и сумме корзины. Добавьте дополнительные опции — страховку, наложенный платёж — с влиянием на итоговую стоимость.