Подключение СДЭК к Битрикс

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

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

1С-Битрикс не содержит встроенной службы СДЭК «из коробки» — доставка подключается через обработчик службы доставки (класс, наследующий Bitrix\Sale\Delivery\Services\Base). На практике его не пишут с нуля, а ставят готовый модуль из Маркетплейса.

• Официальный модуль СДЭК (cdek.integration) — поддерживается самой службой, работает с API v2.0, умеет расчёт тарифов, виджет ПВЗ и выгрузку заказов.
• Модули интеграторов (например, ipol.sdelivery) — часто гибче в настройке ограничений, наценок и правил округления.
• Свой обработчик — оправдан только при нестандартной логике: мультискладовость, собственные тарифные сетки, объединение с другими перевозчиками.

Договор и ключи API

Для расчёта и выгрузки заказов нужен договор с СДЭК и доступ к API интеграции. В личном кабинете СДЭК (раздел для интеграторов) создаётся пара Account (идентификатор клиента) и Secure password (секретный ключ). По ним модуль получает OAuth-токен на боевом контуре https://api.cdek.ru/v2/.

Пока договор не подписан, тестируйте на демо-контуре https://api.edu.cdek.ru/v2/ с публичными тестовыми ключами — расчёт работает, но реальные заказы туда не уходят.

1. Получите Account и Secure password у менеджера СДЭК.
2. Впишите их в настройки модуля и выберите контур (боевой/тестовый).
3. Нажмите «Проверить соединение» — модуль должен вернуть валидный токен.

Склад отправления и тарифы

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

Ключевой параметр — набор разрешённых тарифов. Каждый тариф имеет числовой код и определяет схему «откуда-куда»:

В магазине удобно завести два профиля: один с «складскими» тарифами для выдачи в ПВЗ, второй с «дверными» для курьера. Так покупатель в корзине видит понятный выбор, а не десяток похожих строк.

Вес, габариты и местоположения

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

• Задайте вес по умолчанию для товаров без заполненного веса — иначе API вернёт ошибку и доставка «пропадёт» из корзины.
• Настройте габариты по умолчанию (типовую коробку), если размеры не ведёте в каталоге.
• Проверьте, что включён и загружен модуль sale.location — СДЭК сопоставляет местоположение покупателя со своим справочником городов по коду или названию.

Виджет пунктов выдачи на оформлении

Для тарифов «склад-склад» и «склад-дверь» покупатель должен выбрать пункт выдачи (ПВЗ). СДЭК предоставляет готовый виджет карты, который встраивается в шаг оформления заказа компонента sale.order.ajax.

Для работы карты понадобится API-ключ Яндекс.Карт (JavaScript API) — виджет рендерит на нём точки ПВЗ и постаматов. Выбранный пункт сохраняется в свойство заказа (код ПВЗ), которое затем уходит в накладную.

1. Получите ключ Яндекс.Карт в кабинете разработчика и пропишите его в настройках виджета.
2. Убедитесь, что домен магазина добавлен в ограничения ключа, иначе карта не загрузится.
3. Проверьте на мобильной вёрстке — виджет должен корректно открываться в модальном окне.

Выгрузка заказов и накладные

После оплаты или подтверждения заказ можно передавать в СДЭК автоматически — модуль создаёт заказ через метод API /v2/orders и возвращает трек-номер. Часть модулей делает это по смене статуса заказа, часть — по кнопке в детальной карточке заказа.

• Статусы. Через вебхуки (/v2/webhooks) СДЭК присылает изменения статуса посылки, и модуль обновляет заказ — покупатель видит актуальный трекинг.
• Печать. Из выгруженного заказа доступна печать квитанции и ШК-этикетки прямо из админки.
• Наложенный платёж. Если используете, передавайте сумму к оплате и признак предмета расчёта корректно — это влияет на возврат средств.

Перед боевым запуском обязательно прогоните полный цикл на тестовом контуре: расчёт в корзине → выбор ПВЗ → оформление → выгрузка → смена статуса.

Итог

Подключение СДЭК к 1С-Битрикс складывается из четырёх слагаемых: правильный модуль, интеграционные ключи API v2.0, заполненные вес и габариты и виджет ПВЗ с ключом Яндекс.Карт. Когда всё это на месте, магазин считает доставку в реальном времени, а заказы уходят в СДЭК без ручного переноса.

Если расчёт «отваливается» на части городов, не проходит выгрузка или нужен нестандартный сценарий с несколькими складами и наценками — мы в B2Bsite настраиваем интеграции доставки под ключ, тестируем полный цикл и берём магазин на поддержку, чтобы обновления модулей и API не ломали оформление заказа.