Мы — официальный франчайзи СДЭК
Ваш логистический партнёр 24/7 с персональным менеджером и поддержкой по всему миру
Интеграция СДЭК с Wildberries DBS
По России и миру
Интеграция СДЭК с Wildberries DBS.
Интеграция СДЭК с Wildberries DBS.
Как настроить и как это работает?
Интеграция СДЭК с Wildberries DBS: как настроить и как это работает. Если вы продаёте на Wildberries по модели DBS (доставка своими силами) и отправляете заказы через СДЭК - интеграция между личными кабинетами избавляет от ручного переноса данных. Разбираем, как она устроена, что нужно настроить и на что обратить внимание, чтобы всё заработало с первого раза.
Что такое DBS и зачем нужна интеграцияDBS - модель продаж на Wildberries, при которой продавец сам организует доставку до покупателя или до пункта выдачи, минуя склады маркетплейса. Интеграция с СДЭК берёт на себя техническую часть этого процесса:
Важно. Wildberries принимает к перевозке не все категории товаров - список ограничений стоит уточнять на стороне площадки.
Настройка склада в личном кабинете Wildberries Создание складаВ разделе «Поставки и заказы» → «Мои склады и пропуска» нужно создать склад с типом «Витрина (DBS)», а затем на вкладке «Склады» - добавить новый склад с моделью «Доставка своими силами (DBS)».
Если ранее вы не работали по другим моделям продаж, система попросит выбрать пять ПВЗ для возврата товаров - это обязательный шаг, но при работе по DBS эти ПВЗ фактически не используются.
Категория товаровПри заполнении карточки склада нужно выбрать категорию товаров - и сделать это можно только один раз, после сохранения изменить нельзя. Категории делятся так:
График, сборка и контакты складаДальше указываются:
Ключевое правило: география доставки в Wildberries должна совпадать с зоной обслуживания подразделений СДЭК. Каждый регион может входить только в одну зону доставки - если нужно перенести регион в другую зону, сначала удалите его из текущей.
Здесь же настраиваются:
Обратите внимание: удаление интеграции или отзыв токена в кабинете Wildberries означает согласие на удаление всех связанных данных, включая уже созданные накладные. Если часть накладных на тот момент будет в пути - они вернутся отправителю с выставлением счёта за полную стоимость доставки.
Генерация токена WildberriesТокен создаётся в личном кабинете партнёра Wildberries: раздел настроек магазина → «Доступ к API» → «Создать токен». Важно выбрать вкладку «Для сервиса из каталога» и указать компанию СДЭК.
Токену нужны сразу три категории доступа:
Токен показывается только один раз после создания - если потеряли, придётся выпускать новый. Скопированный токен вставляется в настройки интеграции СДЭК, дальше нужно подтвердить согласие на передачу данных и отправить его на проверку. Проверка занимает от минуты до нескольких часов в зависимости от нагрузки; если прошло больше суток - стоит обратиться в техподдержку СДЭК.
Настройка магазина в кабинете СДЭКПосле проверки токена настраиваются:
Данные о складе и активацияДля каждого склада отдельно указываются город и данные для накладной - ФИО, телефон и email отправителя обязательны к заполнению. Склад можно активировать или деактивировать - заказы деактивированного склада из Wildberries не загружаются.
После активации магазина должно пройти не менее 30 минут, прежде чем интеграция начнёт стабильно работать - это особенность API Wildberries. Любые действия со сборочными заданиями раньше этого времени могут привести к тому, что накладные не создадутся.
Как формируются накладныеИнтеграция проверяет сборочные задания в статусе «Новое» каждые 15 минут. Первые 30 минут после появления задания статусы менять не рекомендуется - это тоже связано с техническими особенностями API.
После перехода задания в статус «На сборке» накладная создаётся в течение 20 минут. Если несколько заданий идут одному покупателю по одному адресу - они объединяются в одну накладную.
Габариты грузового места система считает по алгоритму: для каждого товара вычисляется объём, суммируется по всем товарам в месте, умножается на коэффициент упаковки из настроек, а итоговые длина, ширина и высота определяются через сопоставление наибольших и наименьших габаритов товаров. Результат округляется в большую сторону.
Тариф для накладной подбирается автоматически:
После передачи груза в СДЭК статус сборочного задания меняется на «В доставке на Wildberries». Учтите: Wildberries использует подменные номера телефонов, поэтому автоматические уведомления покупателей от СДЭК не сработают - трек-номер лучше сообщить покупателю самостоятельно.
При вручении курьер связывается с покупателем за час и запрашивает код подтверждения из приложения Wildberries. Если заказ отменён со стороны площадки - накладной присваивается статус «Не вручен», и дальше она обрабатывается по правилам возврата.
Что такое DBS и зачем нужна интеграцияDBS - модель продаж на Wildberries, при которой продавец сам организует доставку до покупателя или до пункта выдачи, минуя склады маркетплейса. Интеграция с СДЭК берёт на себя техническую часть этого процесса:
- автоматически создаёт накладные СДЭК по заказам с Wildberries - без ручного переноса данных;
- синхронизирует статусы доставки между площадками;
- сама прогнозирует размер упаковки по товарам в заказе и подбирает подходящий тариф.
Важно. Wildberries принимает к перевозке не все категории товаров - список ограничений стоит уточнять на стороне площадки.
Настройка склада в личном кабинете Wildberries Создание складаВ разделе «Поставки и заказы» → «Мои склады и пропуска» нужно создать склад с типом «Витрина (DBS)», а затем на вкладке «Склады» - добавить новый склад с моделью «Доставка своими силами (DBS)».
Если ранее вы не работали по другим моделям продаж, система попросит выбрать пять ПВЗ для возврата товаров - это обязательный шаг, но при работе по DBS эти ПВЗ фактически не используются.
Категория товаровПри заполнении карточки склада нужно выбрать категорию товаров - и сделать это можно только один раз, после сохранения изменить нельзя. Категории делятся так:
- МГТ (малогабаритные) - вес до 25 кг, ни одна сторона упаковки не превышает 120 см, сумма трёх сторон - не более 200 см;
- КГТ+ (крупногабаритные) - вес до 25 кг, но хотя бы одна сторона больше 120 см или сумма сторон больше 200 см;
- СГТ (сверхгабаритные) - вес от 25 кг и более, при этом превышены те же габаритные пороги.
График, сборка и контакты складаДальше указываются:
- рабочие дни склада (если работаете без выходных - поля можно оставить пустыми);
- праздничные дни - настраиваются не более чем на 45 дней вперёд, на основе производственного календаря РФ;
- время сборки заказов - если заказ поступил вне графика, к сроку доставки автоматически добавится время до начала следующего рабочего периода;
- телефон склада для связи с курьером - обязателен минимум один номер.
Ключевое правило: география доставки в Wildberries должна совпадать с зоной обслуживания подразделений СДЭК. Каждый регион может входить только в одну зону доставки - если нужно перенести регион в другую зону, сначала удалите его из текущей.
Здесь же настраиваются:
- время доставки - от 5 часов до 35 дней, с учётом времени сборки;
- график и интервалы доставки (интервалы доступны только при доставке по адресу, для ПВЗ - нет);
- условия: порог бесплатной доставки, минимальная сумма заказа, стоимость доставки (максимум 100 000 ₽);
- стоимость подъёма на этаж - отдельно с лифтом и без.
Обратите внимание: удаление интеграции или отзыв токена в кабинете Wildberries означает согласие на удаление всех связанных данных, включая уже созданные накладные. Если часть накладных на тот момент будет в пути - они вернутся отправителю с выставлением счёта за полную стоимость доставки.
Генерация токена WildberriesТокен создаётся в личном кабинете партнёра Wildberries: раздел настроек магазина → «Доступ к API» → «Создать токен». Важно выбрать вкладку «Для сервиса из каталога» и указать компанию СДЭК.
Токену нужны сразу три категории доступа:
- Контент - для получения габаритов товаров под накладную;
- Маркетплейс - для получения данных о заказах;
- Цены и скидки - для загрузки объявленной стоимости товара в накладную.
Токен показывается только один раз после создания - если потеряли, придётся выпускать новый. Скопированный токен вставляется в настройки интеграции СДЭК, дальше нужно подтвердить согласие на передачу данных и отправить его на проверку. Проверка занимает от минуты до нескольких часов в зависимости от нагрузки; если прошло больше суток - стоит обратиться в техподдержку СДЭК.
Настройка магазина в кабинете СДЭКПосле проверки токена настраиваются:
- Данные о магазине - название используется как продавец в накладной. Пока доступна только доставка до двери.
- Тарифы - чем больше вариантов выбрано (включая «Посылочку» и «Экспресс»), тем меньше накладных останется необработанными. Дополнительный сбор за объявленную стоимость отключить нельзя - для интернет-магазинов эта услуга обязательна.
- Товары - необязательная секция: если у товара на Wildberries не указан какой-то параметр, система возьмёт значение отсюда.
- Уведомления - можно включить оповещения об ошибках создания накладных, о обработанных заказах и о новостях интеграции.
Данные о складе и активацияДля каждого склада отдельно указываются город и данные для накладной - ФИО, телефон и email отправителя обязательны к заполнению. Склад можно активировать или деактивировать - заказы деактивированного склада из Wildberries не загружаются.
После активации магазина должно пройти не менее 30 минут, прежде чем интеграция начнёт стабильно работать - это особенность API Wildberries. Любые действия со сборочными заданиями раньше этого времени могут привести к тому, что накладные не создадутся.
Как формируются накладныеИнтеграция проверяет сборочные задания в статусе «Новое» каждые 15 минут. Первые 30 минут после появления задания статусы менять не рекомендуется - это тоже связано с техническими особенностями API.
После перехода задания в статус «На сборке» накладная создаётся в течение 20 минут. Если несколько заданий идут одному покупателю по одному адресу - они объединяются в одну накладную.
Габариты грузового места система считает по алгоритму: для каждого товара вычисляется объём, суммируется по всем товарам в месте, умножается на коэффициент упаковки из настроек, а итоговые длина, ширина и высота определяются через сопоставление наибольших и наименьших габаритов товаров. Результат округляется в большую сторону.
Тариф для накладной подбирается автоматически:
- если доступен только один тариф из выбранных при настройке - используется он;
- если доступно несколько - выбор зависит от настройки: «Дешёвые, но медленные» (минимальная стоимость) или «Быстрые, но дорогие» (минимальный срок);
- если ни один тариф не подошёл - накладная не создаётся, а на почту приходит уведомление.
После передачи груза в СДЭК статус сборочного задания меняется на «В доставке на Wildberries». Учтите: Wildberries использует подменные номера телефонов, поэтому автоматические уведомления покупателей от СДЭК не сработают - трек-номер лучше сообщить покупателю самостоятельно.
При вручении курьер связывается с покупателем за час и запрашивает код подтверждения из приложения Wildberries. Если заказ отменён со стороны площадки - накладной присваивается статус «Не вручен», и дальше она обрабатывается по правилам возврата.
Поможем настроить интеграцию под вашу географию продаж.