Как подключить СДЭК к интернет-магазину: калькулятор доставки, ПВЗ на карте и трекинг

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

Чтобы подключить СДЭК к сайту, сначала заключите договор с компанией. Для интернет-магазина обычно доступен интеграционный аккаунт — уточните условия у менеджера СДЭК. После подписания вы получите доступ в личный кабинет, где можно создать API-ключи (account и secure password). Эти ключи понадобятся для расчёта доставки, создания накладных и отслеживания.

Параллельно проверьте, как в вашем каталоге хранятся вес и габариты товаров. Без этих данных калькулятор не сможет корректно посчитать стоимость. Если у товаров не заполнены масса и объём, интеграция будет выдавать ошибки или заниженные цены — это частая причина споров с покупателями.

Определитесь, какие способы доставки вы предложите: до ПВЗ, курьером до двери, экспресс. Для каждого способа в API есть свои коды. Заранее решите, будет ли доступен наложенный платёж, и если да, то для каких городов и сумм заказа.

Без веса и габаритов товаров калькулятор доставки будет врать.

02 / Как работает расчёт доставки в корзине

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

Важно учитывать порог бесплатной доставки, если он у вас есть. Логику можно зашить в код: например, при сумме заказа выше определённой стоимости доставка до ПВЗ становится бесплатной. Но не забудьте, что СДЭК всё равно выставит вам счёт — просто вы берёте расходы на себя.

Для B2B-заказов с крупногабаритным грузом расчёт лучше вынести в отдельную форму или калькулятор на сайте. Пример — Глобал-Альянс: там калькулятор считает стоимость по весу, объёму и типу груза. Для СДЭК аналогичный подход работает, если у вас много негабаритных товаров.

04 / Создание накладной и отслеживание заказа

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

Трекинг настраивается через вебхуки или периодический опрос API. Сайт получает статусы заказа и показывает их в личном кабинете покупателя. Можно отправлять уведомления на почту или в мессенджер при смене статуса. Главное — не показывать сырые коды статусов, переведите их на понятный язык.

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

06 / Готовый плагин или кастомная интеграция

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

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

Если сайт на самописной CMS или нестандартной платформе, готового плагина может не быть. Тогда вариант один — кастом. Оцените, насколько ваши процессы уникальны, и посчитайте стоимость владения: плагин может требовать обновлений и не всегда успевает за изменениями API.