Wiki · Интеграции

СДЭК

5 мин чтенияАвтор: Дмитрий КолесниковСоавторы: Евгений Баев

Интеграция с СДЭК – это связь интернет-магазина с системой службы доставки СДЭК: сайт сам получает стоимость и срок доставки, показывает покупателю пункты выдачи и передаёт оформленный заказ в СДЭК без ручного ввода.

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

Что сайт получает от СДЭК после подключения

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

Схема: как заказ интернет-магазина попадает в СДЭК вручную и через интеграцию с расчётом в корзине и выбором пункта выдачи — Путь заказа от корзины до СДЭК

Модуль, API или интеграция на заказ

На странице интеграции СДЭК описывает четыре пути. Какой выбрать, зависит от того, на чём сделан сайт.

Способ	Кому подходит	Что учесть
Готовый модуль	Сайт на популярной CMS, конструкторе или в CRM	Модули бывают платные и бесплатные, многие ставятся без разработчика
Прямая интеграция через API	Самописный сайт или нестандартная логика корзины	Нужен разработчик и поддержка кода при изменениях API
Ссылка на клиентский возврат	Магазину важно упростить возвраты	Не считает доставку и не создаёт заказы
Интеграция на заказ	Нет модуля и нет своих разработчиков	Делают под задачу, условия обсуждают со СДЭК

Каталог готовых решений на сайте СДЭК большой: модули для 1С-Битрикс, Tilda, WordPress с WooCommerce, OpenCart, InSales, решения для Битрикс24, RetailCRM, amoCRM и МойСклада, для Ozon и сообществ VK. Для 1С есть «1С:Доставка», её разрабатывает и поддерживает фирма «1С». Список меняется, поэтому перед выбором смотрите актуальный каталог (на октябрь 2026 года набор именно такой).

Модуль от стороннего разработчика живёт, пока его обновляют. Перед покупкой посмотрите дату последней версии и совместимость с вашей версией CMS.

Как устроено подключение через API СДЭК

Интеграцию строят на API версии 2.0, документация лежит на портале apidoc.cdek.ru. Общий принцип API: сайт отправляет запрос на сервер СДЭК и получает ответ в виде данных. Порядок работ такой:

Магазин подписывает договор со СДЭК. После этого в личном кабинете, в разделе интеграции, появляются идентификатор аккаунта и пароль для API.
Разработчик пишет и проверяет обмен на общих тестовых ключах из документации. Они работают только с тестовыми адресами, заказы там создаются по тем же правилам, что и в бою.
В корзину подключают расчёт тарифа и выбор пункта выдачи.
Настраивают отправку заказа в СДЭК и получение трек-номера и статусов.
Меняют тестовые ключи на боевые и проверяют на реальных заказах.

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

Схема способов интеграции интернет-магазина со СДЭК: готовые модули для CMS и CRM, API версии 2.0, интеграция на заказ — Как подключить СДЭК к сайту

Почему стоимость на сайте расходится с накладной

Самая частая жалоба после запуска. Причин обычно три.

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

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

Как связать СДЭК с 1С, CRM и маркетплейсами

Если заказы обрабатывают в учётной системе, интеграцию часто удобнее строить не на сайте, а там: сайт отдаёт заказ в 1С или CRM, а уже оттуда он уходит в СДЭК. Так менеджер видит доставку рядом с оплатой и остатками. Как сайт обменивается заказами с учётом, рассказываем в статье Интеграция сайта с 1С, про CRM в статье Интеграция сайта с CRM.

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

API СДЭК, ключи и выбор модуля для интернет-магазина

Где взять API-ключ СДЭК для сайта?

API-ключ СДЭК для сайта появляется только после подписания договора: это пара из идентификатора аккаунта и пароля, её видно в личном кабинете. До договора разработчик может собрать и отладить обмен на общих тестовых ключах из документации СДЭК. Они не подходят для боевых адресов API, поэтому перед запуском ключи меняют на свои, а затем проверяют расчёт и создание заказа на паре реальных отправок.

Чем модуль СДЭК для CMS отличается от интеграции через API?

Модуль СДЭК для CMS – это готовое решение под конкретную платформу, его ставят и настраивают, часто без программиста. Прямая интеграция через API пишется под ваш сайт: дольше и дороже, зато логику расчёта и оформления можно сделать любой.

Как подключить СДЭК к сайту на Tilda?

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

Почему СДЭК в корзине показывает другую цену, чем в личном кабинете?

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

Сколько стоит интеграция со СДЭК?

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

Что показывает виджет пунктов выдачи СДЭК?

Виджет СДЭК показывает пункты выдачи и постаматы на карте города и считает доставку для заданных габаритов. Работает на PHP-сервере магазина.

Как связать СДЭК с 1С?

Для 1С есть решение «1С:Доставка» от фирмы «1С», оно указано в каталоге модулей СДЭК. Если сайт уже обменивается заказами с 1С, отправку в СДЭК часто удобнее вести из учётной системы, а не с сайта.

Что такое сервис интеграции СДЭК?

Так обычно называют готовые решения и посредников, которые связывают магазин со СДЭК без программиста: модули для CMS, приложения для CRM, агрегаторы доставок. В каталоге СДЭК они собраны в разделе готовых модулей.

Подключаем СДЭК при разработке интернет-магазина и на работающих сайтах при доработке: расчёт в корзине, выбор пункта выдачи, передача заказов в 1С или CRM.

Источники