Подключение СДЭК по идентификатору¶

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

¶Что такое ID в СДЭК

В экосистеме СДЭК под идентификатором (ID) понимается несколько разных значений в зависимости от контекста:

• ID клиента — числовой код, присваиваемый при регистрации в личном кабинете на сайте cdek.ru. Используется для авторизации, отслеживания заказов и обращения в поддержку.
• ID отправления (трек-номер) — 14-значный код вида CDEK123456789, по которому можно отследить посылку на сайте или в мобильном приложении.
• ID магазина / партнёра в API — идентификатор, выдаваемый при подключении к кабинете разработчика (документация на cdek.ru/development), необходимый для интеграции расчёта доставки и оформления заказов в интернет-магазине.
• ID пункта выдачи (ПВЗ) — код пункта самовывоза, используемый при выборе способа доставки.

¶Регистрация и получение ID клиента

Для получения клиентского ID необходимо:

1. Перейти на официальный сайт cdek.ru и открыть раздел «Личный кабинет».
2. Нажать «Регистрация» и заполнить форму: указать имя, адрес электронной почты, придумать пароль.
3. Подтвердить почту по ссылке из письма.
4. После активации аккаунта в профиле отображается клиентский ID — числовой код, уникальный для каждого пользователя.

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

¶Подключение к API СДЭК по ID магазина

Для интеграции доставки в интернет-магазин используется кабинет разработчика СДЭК. Порядок действий:

1. Зарегистрировать аккаунт в личном кабинете СДЭК (обычный клиентский аккаунт).
2. Перейти на страницу cdek.ru/development и войти под теми же учётными данными.
3. Создать нового клиента API — система присвоит Client ID (строковый идентификатор) и Client Secret (секретный ключ).
4. Указанные креды передаются в систему управления магазином (CMS) или в собственное ПО для вызова методов API.

Основные методы API, доступные после подключения:

API СДЭК работает по протоколу HTTPS, авторизация выполняется по OAuth 2.0: сначала получается токен по Client ID и Client Secret, затем токен передаётся в заголовке каждого запроса.

¶Подключение СДЭК в популярных CMS

Многие платформы содержат готовые модули доставки СДЭК:

• 1С-Битрикс — устанавливается модуль «Доставка СДЭК» из маркетплейса, в настройках указывается Client ID и Client Secret.
• WordPress / WooCommerce — доступны плагины (например, «СДЭК доставка для WooCommerce»), куда вводятся те же креды.
• OpenCart, InSales, Tilda — встроенные или сторонние модули с полями для ID и секретного ключа.

После заполнения полей и сохранения настроек в корзине магазина появляется опция доставки СДЭК с расчётом стоимости по адресу покупателя.

¶Отправление по идентификатору заказа

При передаче заказа в СДЭК (через API или личный кабинет) формируется электронный заказ, которому присваивается номер. Этот номер (чаще в формате CDEK-номера) указывается в упаковке и в уведомлении покупателю. По нему посылка отслеживается на сайте cdek.ru/track, в мобильном приложении или через интеграции с маркетплейсами.

¶Частые проблемы при подключении

• Некорректный Client ID или Secret — приводит к ошибке авторизации invalid_client. Требуется проверить значения в кабинете разработчика.
• Разные аккаунты — кабинет разработчика и личный кабинет должны быть созданы от одного логина, иначе API-креды не будут привязаны к нужному магазину.
• Ограничение по тарифу — некоторые методы доступны только при активном договоре и подключённом тарифе на приём грузов.
• Устаревшая версия API — СДЭК поддерживает две версии: v1 (legacy) и v2. Для новых интеграций рекомендуется v2.

¶Историческая справка

Компания СДЭК основана в 2000 году в Новосибирске (первоначальное название — «Служба Доставки Экспресс-Курьер»). К 2020-м годам сеть охватывает более 8000 пунктов выдачи в России и присутствует в странах СНГ, Европы и Азии. Публичный API для интеграции с интернет-магазинами развивается с начала 2010-х годов и является одним из самых распространённых решений для e-commerce в России.

¶Источники

• Официальный сайт СДЭК: cdek.ru
• Документация для разработчиков СДЭК: cdek.ru/development
• Личный кабинет клиента СДЭК
• Маркетплейс модулей 1С-Битрикс