API-интеграция СДЭК позволяет автоматически создавать заказы из вашего интернет-магазина или CRM без ручного оформления в ЛК. Нужны две вещи: Account (логин) и Secure Password (пароль) — они генерируются в разделе «Интеграции» личного кабинета. Дальше эти ключи вставляются в настройки Битрикс, 1С, МойСклад или вашей CMS — и заказы начинают лететь в СДЭК автоматически.
Настройка занимает 15-30 минут, если у вас типовая CMS. Для 1С и кастомных решений — зовите программиста, но данные из ЛК получите сами.
Что дает API-интеграция бизнесу
Ручное оформление заказов — тормоз, когда объем переваливает за 30-50 в день. API решает несколько задач разом.
- Заказ из интернет-магазина автоматически создается в СДЭК — без копирования данных
- Клиенту при оформлении сразу считается стоимость доставки в его город
- Статусы отправлений подтягиваются обратно в вашу CRM: «Принят», «В пути», «Доставлен»
- Клиент видит трекинг прямо в личном кабинете магазина
- При отмене или возврате — синхронизация автоматически
По моим наблюдениям, интернет-магазин с 30+ заказами в день окупает подключение API за первую же неделю. Логист перестает оформлять руками и переключается на упаковку.
Где получить API-ключи в ЛК СДЭК
Ключи выдаются бесплатно любому клиенту с активным договором.
- Войдите в личный кабинет на lk.cdek.ru под ролью «Владелец» или «Администратор»
- В левом меню откройте «Интеграции»
- Найдите блок «API» или «Ключи доступа»
- Нажмите «Создать ключ»
- Придумайте название интеграции (например, «Битрикс основной сайт»)
- Система выдаст два значения: Account и Secure Password
- Скопируйте оба и сохраните в защищенном месте — Secure Password больше не показывается
Если случайно потеряли Secure Password — придется удалить ключ и создать новый. Старая интеграция при этом отвалится, потребуется перенастройка.
Тестовая среда и продакшн
У СДЭК две среды: тестовая и боевая (продакшн). Не путайте их — это частая ошибка.
Тестовая среда
Нужна для отладки интеграции. Заказы создаются виртуальные, реально ничего не отгружается. Идеально для программиста, который пилит модуль.
- Адрес API: api.edu.cdek.ru
- Тестовые учетные данные раздает менеджер СДЭК по запросу
- Данные и заказы регулярно чистятся — не храните там ничего важного
Боевая среда
Реальные заказы, реальные деньги. Использовать только после успешного тестирования.
- Адрес API: api.cdek.ru
- Ключи генерируются в вашем ЛК (см. выше)
- Каждый созданный заказ — фактическая отгрузка
Готовые модули для популярных CMS
Для большинства платформ не нужно программировать с нуля — есть готовые модули.
| Платформа | Способ подключения | Сложность |
|---|---|---|
| 1C-Bitrix | Модуль в маркетплейсе Битрикс | Легко |
| 1С | Официальная обработка от СДЭК | Средне |
| МойСклад | Встроенная интеграция | Легко |
| WooCommerce | Плагин WordPress | Средне |
| OpenCart | Модуль в маркетплейсе | Средне |
| Wildberries FBS | Через кабинет партнера + СДЭК | Легко |
| Ozon Rocket | Через кабинет продавца | Легко |
| Кастомная CMS | Прямая работа с API | Требует программиста |
Все модули подключаются по одной схеме: устанавливаете модуль, открываете настройки, вставляете Account и Secure Password, выбираете нужные тарифы и сохраняете.
Пошаговый пример: подключение к Битрикс
Разберу самый частый сценарий у моих клиентов — интеграция с интернет-магазином на 1C-Bitrix.
- Получите Account и Secure Password в ЛК СДЭК (см. выше)
- В админке Битрикс откройте Marketplace → Каталог решений
- Найдите модуль «СДЭК: доставка и оформление заказов» (официальный от СДЭК)
- Установите модуль и активируйте
- Перейдите в Настройки → Настройки модулей → СДЭК
- Вставьте Account в поле «Логин» и Secure Password в поле «Пароль»
- Выберите тарифы доставки, которые хотите показывать клиентам (склад-дверь, дверь-дверь, самовывоз)
- Укажите ваш склад отправления по умолчанию
- Настройте расчет доставки в корзине: город определяется по IP или ручному выбору
- Нажмите «Сохранить» и «Проверить соединение»
Если тест прошел — можно оформлять первый пробный заказ через сайт и проверить, что он прилетел в ЛК СДЭК.
Ошибки при настройке и их решения
С чем ко мне чаще всего приходят:
- «Ошибка авторизации» — неверно скопирован Account или Secure Password. Часто добавляется пробел в конце. Перепроверьте, вставьте в блокнот, убедитесь, что нет невидимых символов
- «Тариф недоступен» — выбранный тариф не подключен по вашему договору. Проверьте в ЛК «Настройки» → «Тарифы», какие тарифы доступны, и настройте эти же в модуле
- «Город не определяется» — проверьте, что в справочнике городов Битрикс используется классификатор СДЭК. Обновите справочник через модуль
- «Заказы не создаются автоматически» — в настройках модуля должен стоять флажок «Создавать заказ в СДЭК при переходе в статус „Оплачен»» или аналогичный
- «Тест-заказ ушел в боевую среду» — проверьте, что в настройках указан правильный API-адрес (api.cdek.ru для продакшн, api.edu.cdek.ru для теста)
Безопасность API-ключей
Secure Password — это ключ ко всем вашим заказам и данным клиентов. Обращайтесь как с паролем от онлайн-банка.
- Не пересылайте ключ в мессенджерах или обычных письмах
- Не храните в открытых Google-документах или таблицах
- При смене программиста или подрядчика — обязательно перегенерируйте ключ
- Заведите отдельные ключи для разных сервисов (сайт, 1С, склад) — при утечке одного вы отзовете только его, остальные продолжат работать
- Раз в год обновляйте ключи планово
Частые вопросы
Сколько стоит API-интеграция СДЭК
Сам API бесплатный для всех клиентов с договором. Платите только за услуги доставки по действующим тарифам. Затраты возможны на стороне интегратора — программист или подключение модуля в маркетплейсе платформы.
Можно ли использовать один API-ключ для нескольких сайтов
Технически можно, но не советую. Если один сайт скомпрометируют — придется менять ключ и перенастраивать все остальные. Заведите отдельный API-аккаунт под каждый проект.
Как долго действует Secure Password
Пароль без ограничения по сроку — действует, пока вы сами его не отзовете. Но по правилам безопасности СДЭК рекомендует обновлять раз в 6-12 месяцев.
Что делать, если модуль перестал работать после обновления
Проверьте совместимость версии модуля с версией CMS. Часто СДЭК выпускает обновление модуля вслед за обновлением API. Скачайте актуальную версию в маркетплейсе. Если проблема сохраняется — напишите в поддержку СДЭК с логами ошибок.
Работает ли API с самозанятыми
Да, но с ограничениями. Функциональность урезана: часть тарифов и опций (например, наложенный платеж выше определенной суммы) недоступны. Полный API — для юрлиц и ИП с договором.
Есть ли лимит на количество запросов к API
Стандартный лимит — около 100 запросов в минуту с одного ключа. Для интернет-магазина с потоком 500 заказов в день этого хватает с запасом. Если превысите — получите временную блокировку на несколько минут.
Можно ли протестировать интеграцию без реальных отгрузок
Да, для этого и есть тестовая среда api.edu.cdek.ru. Все заказы там виртуальные, курьер не приезжает. После успешного теста переключаете модуль на боевые ключи.
Что делать дальше
Сгенерируйте Account и Secure Password прямо сейчас, если еще не сделали. Проведите тестовое подключение на тестовой среде. При переходе в бой оформите пару пробных заказов и проверьте всю цепочку: сайт → СДЭК → накладная → курьер. Если что-то пошло не так — разберемся вместе, напишите в чат поддержки.
