Коротко
Интеграция СДЭК на сайт — это подключение модуля или плагина, который рассчитывает стоимость и срок доставки прямо в корзине, показывает карту пунктов выдачи и передаёт заказы в СДЭК без ручного ввода. Для 1С-Битрикс и WooCommerce есть готовые модули, поэтому писать интеграцию с нуля обычно не нужно. Нужны договор со СДЭК, ключи доступа к API из личного кабинета и корректные вес и габариты товаров.
Базовое подключение на типовом магазине занимает от 3 рабочих дней. Время уходит не на установку модуля, а на подготовку данных: вес и размеры товаров, правила упаковки, выбор тарифов, связку статусов заказа и проверку на тестовых заказах. Если магазин сильно доработан или обменивается заказами с 1С, работа растягивается.
| Что нужно | Где взять | Зачем |
|---|---|---|
| Договор со СДЭК | Заключается с компанией напрямую | Без него нет доступа к API и тарифам по договору |
| Ключи API (идентификатор и пароль) | Личный кабинет СДЭК, раздел интеграции | Модуль авторизуется и получает расчёт |
| Вес и габариты товаров | Карточки товаров на сайте | Без них расчёт будет неверным |
| Адрес отправки или пункт приёма | Настройки модуля | Отправная точка расчёта |
| Ключ API Яндекс Карт (часто) | Кабинет разработчика Яндекса | Для отображения карты пунктов выдачи |
| Список тарифов | Условия договора | Какие варианты доставки показывать покупателю |
Основная мысль
Модуль СДЭК считает доставку ровно так точно, насколько точны данные о товарах, поэтому качество интеграции определяется не модулем, а весом, габаритами и настройками упаковки. Если у товаров пустые поля веса, покупатель увидит заниженную стоимость, а разницу заплатит магазин.
Вторая часть успеха — сценарий оформления заказа. Покупатель должен видеть цену и срок доставки до ввода всех данных, выбирать пункт выдачи на карте без перезагрузки страницы и получать трек-номер после отправки. Если хотя бы одно звено неудобно, часть покупателей бросит корзину.
Третья часть — работа менеджера. Хорошая интеграция позволяет создать заказ в СДЭК из админки сайта в один клик, распечатать накладную и видеть статус доставки. Плохая превращает каждую отправку в ручное копирование данных между системами.
Как работает интеграция СДЭК на сайт
Модуль общается с сервером СДЭК по API. На каждом этапе заказа он отправляет запрос и получает ответ.
Что происходит при оформлении заказа
- Покупатель добавляет товары в корзину и указывает город.
- Модуль суммирует вес и объём товаров, прибавляет упаковку и отправляет запрос на расчёт.
- СДЭК возвращает стоимость и срок для подходящих тарифов: до пункта выдачи, до постамата, курьером до двери.
- Покупатель выбирает вариант. Для пункта выдачи открывается карта.
- После оплаты или подтверждения заказ уходит в СДЭК автоматически или по кнопке менеджера.
- СДЭК присваивает номер отправления, модуль сохраняет его в заказе, и покупатель получает трек-номер.
Тарифы и режимы доставки
У СДЭК тарифы различаются по режиму: откуда забирают (склад или дверь отправителя) и куда доставляют (склад, пункт выдачи, постамат или дверь получателя). В модуле обычно выбирают несколько тарифов, которые показываются покупателю как отдельные способы доставки. Какие тарифы доступны, зависит от договора, поэтому список лучше согласовать с менеджером СДЭК до настройки.
Тестовая среда
У СДЭК есть тестовый контур API с отдельными ключами. В нём можно проверить расчёт и создание заказов, не создавая реальных отправлений. Хорошие модули умеют переключаться между тестовым и рабочим режимом в настройках. Все проверки лучше делать в тестовом режиме и только потом переходить на рабочие ключи.
Модуль СДЭК Битрикс: установка и настройка
Для 1С-Битрикс интеграцию ставят из Маркетплейса. Там есть официальный модуль СДЭК и модули сторонних разработчиков. Выбор зависит от редакции, версии ядра и нужных функций.
Требования со стороны Битрикса
Службы доставки с расчётом по API работают в модуле «Интернет-магазин», который есть с редакции «Малый бизнес» (47 000 ₽). На «Старте» и «Стандарте» полноценного интернет-магазина нет. Если сайт на младшей редакции, сначала нужно решить вопрос с лицензией, о выборе редакции подробно рассказано в статье Интернет-магазин на 1С-Битрикс: этапы запуска.
Также проверьте, что лицензия активна. Установка и обновление модулей из Маркетплейса на сайте с истёкшей лицензией может быть ограничена, а модули доставки часто обновляются вслед за изменениями API.
Установка
- Сделайте резервную копию сайта и базы.
- В административном разделе откройте Маркетплейс, найдите модуль СДЭК и установите его.
- Пройдите мастер установки модуля: он попросит ключи API, город отправки и базовые настройки.
- Модуль создаст службы доставки. Их список находится в разделе «Магазин» → «Настройки» → «Службы доставки».
Как безопасно ставить и обновлять модули, чтобы не сломать сайт, описано в статье Модули 1С-Битрикс: как установить и обновить.
Модуль доставки Битрикс: что настроить после установки
- Тарифы. Включите только те, что прописаны в договоре и нужны покупателям.
- Габариты по умолчанию. Задайте вес и размеры, которые модуль подставит, если у товара поля пустые. Это страховка, а не замена реальным данным.
- Ограничения. Службу доставки можно ограничить по сумме заказа, весу, местоположению и платёжным системам.
- Наценка. Если магазин закладывает упаковку в стоимость доставки, её задают фиксированной суммой или процентом в настройках службы.
- Статусы. Свяжите статусы заказа на сайте со статусами отправления в СДЭК, чтобы менеджер видел, где посылка.
- Местоположения. Модуль сопоставляет города Битрикса с кодами городов СДЭК. Если справочник местоположений на сайте устарел, расчёт по части городов не сработает.
Шаблон оформления заказа
Стандартный компонент оформления заказа поддерживает службы доставки и выбор пункта выдачи. Если на сайте сильно доработанный шаблон или готовое решение со своим оформлением, виджет выбора пункта выдачи может отображаться некорректно. Это самый частый источник доработок после установки модуля.
СДЭК: подключить на сайт WooCommerce
Для WooCommerce интеграцию ставят как плагин. В каталоге WordPress есть официальный плагин СДЭК, есть и сторонние решения.
Установка плагина
- Сделайте резервную копию сайта.
- В админке WordPress откройте «Плагины» и нажмите кнопку добавления плагина, найдите плагин СДЭК и установите его.
- Активируйте плагин и перейдите к его настройкам: укажите ключи API, адрес отправки, тарифы и габариты по умолчанию.
- Откройте «WooCommerce» → «Настройки» → «Доставка» и добавьте метод доставки СДЭК в нужные зоны доставки.
Зоны доставки в WooCommerce — отдельная тема: от них зависит, какие способы увидит покупатель из конкретного региона. Общая логика настройки описана в статье Оплата и доставка в WooCommerce.
Что проверить в карточках товаров
В WooCommerce вес и габариты задаются на вкладке «Доставка» в данных товара, у вариативных товаров — у каждой вариации. Единицы измерения веса и размеров задаются в общих настройках WooCommerce на вкладке «Товары». Если там указаны граммы, а в карточках вес введён в килограммах, расчёт будет ошибочным в тысячу раз.
Для каталога из сотен товаров вес и габариты удобнее заполнить импортом из таблицы. Как устроены карточки, вариации и импорт, разобрано в материале Товары в WooCommerce.
Страница оформления заказа
С версии 8.3 WooCommerce для новых магазинов по умолчанию использует блочное оформление заказа. Не все плагины доставки одинаково хорошо работают с блочным и классическим шаблоном. Перед запуском проверьте, что выбор пункта выдачи отображается и сохраняется в заказе именно на том варианте оформления, который используется на сайте.
Карта СДЭК на сайт: виджет пунктов выдачи
Выбор пункта выдачи на карте — то, что покупатель видит и оценивает. От его удобства зависит, дойдёт ли человек до оплаты.
Как работает виджет
СДЭК предоставляет виджет выбора пунктов выдачи. Модули для Битрикса и WooCommerce встраивают его в оформление заказа. Покупатель видит карту с точками, фильтрует пункты выдачи и постаматы, выбирает удобный, и адрес пункта сохраняется в заказе.
Для отображения карты виджет использует Яндекс Карты, поэтому в настройках обычно нужен ключ API Яндекс Карт. Ключ получают в кабинете разработчика Яндекса. Условия использования ключа зависят от тарифа Яндекса, их стоит проверить заранее для коммерческого сайта.
Если нужна карта вне корзины
Иногда карту пунктов выдачи ставят на страницу «Доставка», чтобы покупатель заранее видел ближайшие пункты. Это отдельная задача: виджет встраивается в страницу через шаблон, и выбор пункта там ни на что не влияет. Полезно, но не обязательно.
Мобильная версия
Большинство заказов оформляют со смартфона. Проверьте, что карта открывается во весь экран, точки нажимаются пальцем, а кнопка выбора пункта не перекрывается другими элементами. Проблемы с отображением виджета на мобильных — частая причина брошенных корзин.
Создание заказов и документы
Расчёт доставки — половина интеграции. Вторая половина — передача заказов в СДЭК и работа с отправлениями.
Автоматически или по кнопке
Модули позволяют отправлять заказ в СДЭК автоматически при смене статуса (например, после оплаты) или вручную из карточки заказа. Для небольшого магазина удобнее ручной режим: менеджер проверяет заказ, комплектует его и только потом создаёт отправление. Для потока в десятки заказов в день выгоднее автоматическая передача.
Накладные и этикетки
После создания отправления модуль позволяет получить накладную и штрихкод-этикетку для печати. Если в магазине есть термопринтер, проверьте формат этикетки заранее. Без этого на складе будут переписывать данные вручную.
Наложенный платёж
Если покупатель платит при получении, сумма наложенного платежа передаётся в СДЭК вместе с заказом. Здесь важно правильно связать платёжную систему на сайте с признаком оплаты в модуле. Ошибка приводит к тому, что оплаченный на сайте заказ отправляется с наложенным платежом или наоборот.
Обмен с 1С
Если заказы выгружаются в 1С, а трек-номер и статус доставки должны возвращаться обратно, нужно проверить, какие поля участвуют в обмене. Номер отправления СДЭК хранится в свойствах заказа или отгрузки на сайте, и его нужно явно включить в обмен. Базовая настройка обмена разобрана в статье Обмен 1С-Битрикс с 1С.
Вес, габариты и упаковка
Модуль не знает, как вы упаковываете заказ. Он получает только цифры из карточек товаров и настроек, поэтому правила упаковки нужно продумать до запуска.
Как считать габариты заказа
Большинство модулей складывают вес товаров, а габариты посылки считают по одному из правил: по объёму всех товаров, по самому крупному товару или по заданной коробке. Проверьте, какое правило использует ваш модуль, и сравните результат с реальными коробками на складе. Если расчётный объём сильно меньше реального, стоимость могут пересчитать при приёме посылки.
Объёмный вес
Для лёгких, но крупных товаров (подушки, абажуры, пластиковые ящики) стоимость считается не по фактическому, а по объёмному весу. Если в карточках указаны только килограммы без размеров, такие товары будут стоить в доставке дешевле, чем на самом деле. Для них габариты особенно важны.
Упаковка и наценка
Коробка, наполнитель и плёнка тоже весят и стоят денег. Добавьте вес упаковки в настройках модуля, а стоимость упаковки — как наценку к службе доставки, если не хотите закладывать её в цену товара.
Три сценария подключения
Небольшой магазин одежды на WooCommerce
Каталог из сотни товаров, вес почти одинаковый, заказы уходят в пункты выдачи. Достаточно официального плагина, заполненного веса и габаритов у вариаций, одного-двух тарифов до пункта выдачи и курьерской доставки для крупных городов. Основное время уходит на проверку оформления заказа на смартфоне.
Магазин запчастей на 1С-Битрикс с обменом 1С
Тысячи позиций, вес и размеры приходят из 1С. Сначала нужно убедиться, что эти поля заполнены в учётной системе и выгружаются на сайт. Затем — поставить модуль, настроить габариты по умолчанию для товаров без данных и включить трек-номер в обратный обмен заказами.
B2B-поставщик с доставкой до двери
Покупатели — компании, заказы крупные, нужна доставка до склада клиента. Здесь важны тарифы «до двери», ограничения по весу, несколько мест в одном заказе и безналичная оплата по счёту. Готовый модуль справляется с базовой частью, а нестандартные правила часто требуют доработки.
Сравнение подходов к интеграции
| Подход | Когда подходит | Плюсы | Минусы |
|---|---|---|---|
| Официальный модуль или плагин СДЭК | Типовой магазин, стандартное оформление | Быстро, обновляется вслед за API | Ограниченная гибкость интерфейса |
| Сторонний модуль | Нужны доп. функции: несколько служб, печать, аналитика | Больше возможностей | Зависимость от разработчика модуля |
| Доработка модуля под шаблон | Сильно изменённое оформление заказа | Интерфейс под ваш дизайн | Нужна поддержка при обновлениях |
| Своя интеграция через API | Нестандартная логистика, склады, маркетплейсы | Полный контроль | Дольше и дороже, нужна поддержка |
Для большинства магазинов разумно начать с готового модуля и дорабатывать только то, что реально мешает продажам.
Типичные проблемы и на чём опасно экономить
Большинство жалоб «СДЭК считает неправильно» или «модуль не работает» сводятся к нескольким причинам.
Частые проблемы
- Доставка не отображается в корзине. Нет веса у товаров, город покупателя не сопоставлен с городом СДЭК, служба ограничена по сумме или региону, либо ключи API неверные.
- Стоимость сильно ниже реальной. Пустые габариты, неверные единицы измерения, не учтена упаковка.
- Карта не открывается. Не указан или ограничен ключ Яндекс Карт, конфликт скриптов с темой или шаблоном, блокировка скриптов на сайте.
- Выбранный пункт выдачи не сохраняется в заказе. Модуль несовместим с доработанным шаблоном оформления заказа.
- Заказ не создаётся в СДЭК. Не заполнены обязательные данные получателя (телефон, ФИО), превышены ограничения тарифа, истёк срок действия ключей.
- Модуль перестал работать после обновления. Обновили CMS, а модуль доставки — нет, или наоборот.
На чём не стоит экономить
- На данных товаров. Вес и габариты — основа расчёта. Их заполнение — рутинная, но обязательная работа.
- На тестировании. Нужно проверить несколько городов, пункт выдачи и курьерскую доставку, заказ с одним товаром и с десятком, оплату онлайн и при получении.
- На резервной копии перед установкой. Модуль вносит изменения в базу, и откат без копии займёт больше времени, чем сама установка.
- На поддержке. API службы доставки меняется, и модуль нужно обновлять. Сайт, который никто не обслуживает, однажды перестанет считать доставку.
Чек-лист запуска доставки СДЭК
- Договор со СДЭК заключён, тарифы согласованы.
- Ключи API получены, сначала проверен тестовый режим.
- У всех товаров заполнены вес и габариты в правильных единицах.
- Заданы габариты по умолчанию и правила упаковки.
- Службы доставки добавлены и ограничены по нужным условиям.
- Карта пунктов выдачи работает на компьютере и смартфоне.
- Выбранный пункт выдачи сохраняется в заказе.
- Заказ создаётся в СДЭК, печатается накладная, трек-номер приходит покупателю.
- Наложенный платёж передаётся только для заказов без онлайн-оплаты.
- Если есть обмен с 1С, трек-номер и статус участвуют в обмене.
Частые вопросы
Сколько времени занимает интеграция СДЭК на сайт?
Установка и базовая настройка готового модуля на типовом магазине — от 3 рабочих дней вместе с тестированием. Больше времени уйдёт, если нужно заполнить вес и габариты у большого каталога, адаптировать доработанный шаблон оформления заказа или настроить обмен с 1С.
Можно ли подключить СДЭК без договора?
Для полноценной интеграции с расчётом по тарифам договора и созданием заказов через API нужен договор и ключи из личного кабинета. Без договора можно отправлять посылки как частное лицо через отделения, но это не автоматизируется на сайте.
Какой модуль СДЭК для Битрикса выбрать?
Начните с официального модуля: он поддерживается СДЭК и обновляется вслед за API. Сторонние модули выбирают, если нужны функции, которых нет в официальном. В любом случае смотрите на дату последнего обновления, совместимость с вашей версией ядра и отзывы.
Какой модуль доставки Битрикс нужен, если служб доставки несколько?
Можно поставить отдельные модули для каждой службы или агрегатор, который собирает несколько служб в одном модуле. Второй вариант удобнее для покупателя, но добавляет ещё одного посредника и его тарифы.
Как сделать карту СДЭК на сайте?
Карта пунктов выдачи встраивается в оформление заказа модулем или плагином СДЭК. Для её работы обычно нужен ключ API Яндекс Карт. Если карта нужна на отдельной странице, виджет встраивается в шаблон этой страницы.
Почему доставка СДЭК не появляется в корзине?
Чаще всего у товаров не заполнен вес, город покупателя не найден в справочнике СДЭК, служба доставки ограничена по условиям или указаны неверные ключи API. Проверьте журнал модуля: большинство модулей записывают ответы СДЭК с текстом ошибки.
Работает ли модуль СДЭК на редакции «Старт»?
Службы доставки с расчётом входят в модуль «Интернет-магазин», который доступен с редакции «Малый бизнес». На младших редакциях магазина нет, поэтому сначала нужно перейти на подходящую редакцию.
Можно ли передавать заказы в СДЭК из 1С, а не с сайта?
Можно, для 1С существуют свои решения интеграции со службами доставки. В этом случае сайт отвечает только за расчёт и выбор пункта, а отправления создаются в учётной системе. Схему выбирают исходя из того, где работают менеджеры.
Итог
Доставку СДЭК на сайте на 1С-Битрикс или WooCommerce подключают готовым модулем: он рассчитывает стоимость, показывает карту пунктов выдачи и передаёт заказы по API. Главная работа — подготовка данных о товарах, выбор тарифов, настройка оформления заказа и тестирование на реальных сценариях.
Экономить на весе и габаритах, резервной копии и тестах нельзя: ошибки в расчёте доставки напрямую стоят денег, а неработающая карта уводит покупателей. После запуска модуль нужно обновлять вместе с сайтом, потому что API службы доставки меняется.
Если нужно подключить СДЭК к магазину или доработать оформление заказа, я как частный разработчик установлю и настрою модуль доставки на 1С-Битрикс или WooCommerce, свяжу его со статусами заказов и обменом с 1С. Работаю напрямую, без посредников. Подробнее — на странице интернет-магазин на 1С-Битрикс.
