Инструкция по настройке интеграции Wildberries со СДЭК

Жанна Суворова
Жанна Суворова

15 мая, 2025

СДЭК запустил прямую интеграцию по модели DBS для Wildberries, которая существенно упрощает работу продавцов.

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

Следуя этим простым рекомендациям, вы сможете быстро запустить работу по схеме DBS и получить все преимущества новой системы.

Принцип работы интеграции

После настройки, система каждые 15 минут проверяет наличие новых заказов на Wildberries.

При обнаружении нового заказа, автоматически создается накладная в СДЭК.

Накладная появляется в личном кабинете, откуда ее можно распечатать и наклеить на посылку для передачи на доставку.

Установка и настройка

Для работы интеграции не требуется установка дополнительного ПО. Вся настройка происходит через личный кабинет СДЭК.

Для этого необходимо перейти на страницу настроек интеграции и выбрать режим DBS.

Генерация токена Wildberries

Для генерации токена, в Личном кабинет партнера Wildberries необходимо нажать на название магазина и перейти в раздел Настройки.

Если на главной страницы отображается предупреждение об отключении раздела маркетплейс.

Интеграция не сможет работать при отключенном разделе Маркетплейс. Необходимо выполнить предлагаемые действия для исправления настроек.

Со страницы профиля необходимо перейти в раздел Доступ к API.

Затем создать новый токен, нажав на кнопку Создать токен

Если кнопка создать новый токен не доступна

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

Для корректной работы, токен должен иметь сразу три категории доступа: Контент, Маркетплейс и Цены и скидки, а также отключенные настройки Тестовый контур и Только на чтение.

Для чего нужны права доступа:

  • Доступ к категории Контент необходим для получения информации о габаритах товаров для накладной.

  • Доступ к категории Маркетплейс необходим для получения информации о заказах.

  • Доступ к категории Цены и скидки необходим для загрузки объявленной стоимости товара в накладную.

  • Благодаря отключенному параметру Тестовый контур интеграция будет работать с реальными данными. Тестового режима для DBS API в настоящий момент не существует у Wildberries.

  • Благодаря отключенному параметру Только на чтение интеграция сможет изменять статус заказа при передаче его в доставку, а также вручению.

Необходимо скопировать сгенерированный токен и вставить его в настройки интеграции.

Внимание! Токен будет доступен только один раз после создания. При его утере, необходимо будет создать новый.

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

Проверка токена занимает от 1 минуты до нескольких часов, в зависимости от нагрузки на сервер интеграции.

Если проверка занимает более 24 часов, необходимо обратиться в техническую поддержку СДЭК.

Настройка интеграции

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

Данные о магазине​

Основные настройки задаются в разделе настроек магазина.

  1. Секция данных о магазине

Данные из поля названия будут использоваться в качестве продавца в накладной.

Примечание: В настоящий момент доступна только доставка до двери.

2. Секция тарифов

Данные из полей секции будут участвовать в алгоритме определения тарифа, с которым будет создана накладная.

При выборе тарифов рекомендуется выбирать как можно больше вариантов, включая тариф Посылочка и Экспресс. Это позволит сократить количество необработанных накладных.

Подробнее про алгоритм подбора тарифов можно прочитать в п.Работа с накладными.

Нельзя отключить Дополнительный сбор за объявленную стоимость

Данная услуга является обязательной для Интернет-Магазинов, поэтому отключить ее нельзя.

Подробнее можно прочитать в Регламенте возмездного оказания курьерских услуг.

3. Секция товаров

Данная секция не является обязательной к заполнению.

Если у карточки товара в Wildberries не указан параметр, то будет использоваться значение из поля в данной секции для вычисления стоимости доставки.

4. Секция уведомлений

Настройки в данной секции позволяют оперативно получать уведомления, связанные с интеграцией.

  • Об ошибках: каждый раз при попытке создания накладной, если возникла ошибка, будет отправлено сообщение.

  • О заказах: в соответствии с выбранными настройками, будет отправлен список обработанных заказов и созданных к ним накладных.

  • Новости: при добавлении новых функций или изменении работы интеграции, будет отправлено сообщение с описанием изменений.

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

Данные о складе​

Для каждого склада задаются условия отправки груза и данные для накладной.

Если вы не создавали склады в Wildberries, то сделайте это по инструкции.

Подсказка: Вы можете самостоятельно настроить плату за доставку, которую Wildberries будет взимать с покупателя, по инструкции.

  1. Основная секция

В данной секции можно активировать/деактивировать интеграцию для склада, а также задать город, в котором склад находится.

Заказы, созданные покупателями для деактивированного склада, не будут загружаться из Wildberries.

2. Секция данных в накладной

Данные из полей будут подставляться в блок отправителя в накладную. Обязательными к заполнению являются поля: ФИО, Телефон и Email.

После нажатия на кнопку Сохранить, настройки склада будут применены в течение 5 минут.

Активация магазина​

Для активации магазина, необходимо нажать на кнопку Активировать.

С момента активации магазина должно пройти не менее 30 минут для корректной работы интеграции. Это связано с особенностями работы API Wildberries.

Любые действия со сборочными заданиями до этого времени могут привести к некорректной работе интеграции и накладные по таким заданиям созданы не будут.

После активация магазина, интеграция начнет загружать сборочные задания из Wildberries и можно будет работать с накладными.

Деактивация магазина

Для деактивации магазина, необходимо нажать на кнопку Деактивировать.

Магазин деактивируется в течение 5 минут.

Работа с накладными

Сервис интеграции автоматически проверяет наличие сборочных заданий в статусе Новое на Wildberries каждые 15 минут. Информация о новых заданиях сохраняется в системе и ожидает дальнейшего перевода задания в статус На сборке.

Внимание! Для корректности работы, необходимо не изменять статусы сборочного задания первые 30 минут после его появления на Wildberries.

Это связано с техническим особенностями API интеграции с DBS.

Создание накладной

После перехода статуса задания в На сборке, в течение 20 минут, интеграция создает накладную в СДЭК

При этом происходит консолидация заказов: если несколько сборочных заданий доставляются одному покупателю по одному адресу, то они будут автоматически объединены в одну накладную.

Созданная накладная отобразиться в Личном кабинете СДЭК и будет доступна для редактирования.

При создании накладной используется один из тарифов, который выбран при настройке интеграции в секции тарифов, следующим образом:

  1. Рассчитывается стоимость и сроки доставки по всем тарифам из секции

  2. Если ни один из тарифов не доступен, то накладная не создается и направляется уведомление на почту

  3. Если доступен только один тариф, то он используется для создания накладной

  4. Если доступно несколько тарифов, то, в зависимости от настройки, выбирается один из них:

  • Если выбрана настройка Дешевые, но медленные, то используется тариф с наименьшей стоимостью

  • Если выбрана настройка Быстрые, но дорогие, то используется тариф с наименьшим сроком доставки

Редактирование накладной

Созданную накладную можно редактировать в Личном кабинете СДЭК. При этом необходимо учитывать, что менять в ней можно любые параметры (например: тариф, имя получателя и т.д.), кроме поля № отправления ИМ.

При редактировании распределения товара по упаковкам (создания новой упаковки с товарами или объединения двух упаковок в одну) необходимо сохранять артикулы и количество, в противном случае автоматизация данного заказа может перестать работать корректно

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

Поскольку Wildberries использует подменные номера телефонов, автоматическое уведомление покупателей от СДЭК работать не будет.

На данном этапе рекомендуется самостоятельно связаться с покупателем и сообщить трек-номер накладной, чтобы он мог отслеживать доставку своего заказа.

Вручение накладной

За час до вручения заказа, курьер СДЭК свяжется с покупателем по телефону, а при вручении запросит код подтверждения, отображаемый в приложении Wildberries.

В зависимости от вручения или не вручения заказа, система передаст информацию об этом в Wildberries с кодом подтверждения и сборочное задание автоматически перейдет в архив.

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

Вас также могут заинтересовать услуги

Оценка статьи
4.7/5
По договору со СДЭК
отправки дешевле до 40% *
при заполнении анкеты на сайте

* по сравнению с тарифами для физ. лиц

Экономьте на доставке от 100 000 рублей

Уже в 1 месяц. Оставьте контакты, мы перезвоним и все расскажем

Нажимая на кнопку, вы даете согласие на обработку персональных данных и соглашаетесь c политикой конфиденциальности и договором оферты

Благодарим за обращение!
Ожидайте звонка от нашего менеджера и согласуйте условия сотрудничества

Присоединяйтесь к нашему телеграмм каналу с новостями