База знанийИнтеграции Woove Site → СДЭК и Woove Site: расчёт доставки в корзине и отправления

СДЭК и Woove Site: расчёт доставки в корзине и отправления

Интеграция СДЭК с магазином на Woove Site — это стоимость и срок доставки, которые покупатель видит в корзине сразу после ввода города, и заказ на доставку, который уходит в СДЭК сам, как только заказ оплачен. Трек-номер и ссылка на отслеживание появляются в карточке заказа.

В статье: Что даёт интеграция · Где взять доступ в СДЭК · Настройка в Woove Site · Что попадает в СДЭК

Раздел в кабинете: Интеграции сайта · Документация сервиса ↗ · Про Woove Site

Что даёт интеграция

Работает через API СДЭК v2 с вашим аккаунтом интеграции. Есть тестовый контур, чтобы проверить всё без реальных отправлений.

Расчёт доставки в корзинеПокупатель вводит город или индекс — в корзине появляются тарифы СДЭК с ценой и сроком; для тарифов «до склада» он выбирает пункт выдачи или постамат на карте.
Оплаченный заказПосле оплаты в СДЭК создаётся заказ на доставку на выбранный пункт или адрес; номер и ссылка на отслеживание — в заказе, статус обновляется сам.
Понадобится: client_id и client_secret интеграции СДЭК, город отправителя.

Где взять доступ в СДЭК

  1. Личный кабинет СДЭК → «Интеграция» → «API»: запросите доступ и скопируйте Account (client_id) и Secure password (client_secret)

  2. Для проверки без реальных отправлений выберите тестовый контур и укажите тестовые доступы из документации СДЭК

  3. Город и индекс отправителя — откуда отправляете; для тарифов «от двери» ещё адрес склада

  4. Коды тарифов: 136 склад-дверь, 137 дверь-дверь, 138 склад-склад, 139 дверь-склад — перечислите те, что предлагаете

Настройка в Woove Site

Раздел «Доставка» в настройках сайта
  1. Откройте сайт → «Настройки» → «Интеграции» → «Доставка» и найдите карточку «СДЭК».

  2. Включите переключатель и заполните поля из таблицы ниже.

  3. Отметьте, какие события отправлять, и нажмите «Проверить доступ» — сервис должен ответить, что ключ подходит.

  4. Нажмите «Тестовая заявка» и убедитесь, что в сервисе появилась проверочная запись.

  5. Готово: с этого момента события сайта уходят сами, отправки видны в «Журнале» карточки.

Аккаунт (client_id)ЛК СДЭК → Интеграция → API.
Пароль (client_secret)Secure password из раздела «Интеграция → API» кабинета СДЭК. Хранится скрыто, после сохранения показывается точками.
КонтурВарианты: боевой / тестовый. По умолчанию: тестовый.
Город отправителяНапример Москва.
Индекс отправителяИндекс склада или магазина, откуда отправляете.
Адрес складаДля тарифов «от двери».
ОтправительНазвание магазина или имя отправителя в накладной.
Телефон отправителяТелефон отправителя для курьера, в формате 79001234567.
Коды тарифов136 склад-дверь, 137 дверь-дверь, 138 склад-склад, 139 дверь-склад; через запятую. По умолчанию: 136,137.
Пункты выдачи на картеЧто показывать покупателю для тарифов «до склада». Варианты: пункты выдачи и постаматы / только пункты выдачи / только постаматы. По умолчанию: пункты выдачи и постаматы.
Вес одной единицы, гЕсли у товара не задан. По умолчанию: 500.
Наценка к тарифу, ₽Упаковка и обработка; можно 0. По умолчанию: 0.

Что попадает в СДЭК

В корзине покупатель заполняет город, индекс и адрес и нажимает «Рассчитать доставку»: варианты «СДЭК: <тариф>» с ценой (тариф плюс наценка из настройки) и сроком. Для тарифов «до склада» появляется кнопка «Выбрать пункт выдачи»: список пунктов и постаматов города с поиском по адресу, часы работы и карта; без выбранного пункта заказ не оформится. Цена пересчитывается сервером при оформлении, подделать её из браузера нельзя. После оплаты создаётся заказ СДЭК на выбранный пункт (delivery_point) или на адрес: получатель, состав с артикулами, вес по настройке; номер СДЭК и ссылка на отслеживание сохраняются в заказ, а статус («Принят», «Выдан на доставку», «Вручён») мы спрашиваем у СДЭК сами и двигаем заказ в «Отправлен» и «Выполнен», покупателю уходит письмо с треком.

«Проверить доступ» получает токен и находит город отправителя — в ответе будет его код. Для расчёта откройте свой сайт, положите товар в корзину и рассчитайте доставку до другого города.

Если что-то не так

Частые случаи

В корзине нет вариантов СДЭК

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

Отправление не создалось

В журнале карточки — ответ СДЭК. Частые причины: нет телефона отправителя, тариф не работает для этого направления, тестовый контур с боевыми ключами.

Какие пункты показывать

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

Заказ оплачен не через сайт

Откройте заказ в «Каталог → Заказы» и нажмите «Оформить отправление» — отправление создастся так же, как после онлайн-оплаты.

СДЭК отвечает «город не найден»

Город определяется по справочнику СДЭК. Надёжнее собирать в форме индекс или полный адрес — по ним город находится точнее.

Заказы создаются, но в кабинете их нет

Похоже, доступ остался тестовым. У СДЭК тестовый и боевой контуры разные, заказы в них не пересекаются.

Не нашли ответ?

Нажмите кнопку с вопросом в правом нижнем углу — напишем ответ, скриншот тоже можно приложить.

Все статьи →