Общая информация об интеграции
Компания
СДЭК предоставляет селлерам возможность полной автоматизации логистических процессов при работе по модели
DBS (Delivery by Seller). Данная интеграция доступна для всех ключевых маркетплейсов:
Wildberries, Ozon, Яндекс Маркет и Авито.
Интеграция позволяет:
- Автоматически создавать накладные на основе данных заказа (адрес, ФИО, товары) без ручного ввода.
- Подбирать оптимальный тариф на основе габаритов и веса отправления.
- Синхронизировать статусы доставки в режиме реального времени: покупатель на маркетплейсе видит актуальную информацию о передвижении посылки.
- Объединять заказы: Если несколько заказов от одного покупателя направлены на один адрес, система консолидирует их в одну накладную, экономя ваши средства.
Важное уведомление для селлеров: Отзыв API-токена или деактивация интеграции влечет за собой удаление всех созданных накладных. Если отправления находятся в пути, они будут возвращены отправителю с выставлением полной стоимости доставки. Отключайте интеграцию только после получения статуса «Доставлен» по всем отправлениям.
Раздел 1. Единый алгоритм подключения для всех маркетплейсов
Настройка интеграции происходит в два этапа: на стороне маркетплейса и в личном кабинете СДЭК.
Этап 1. Генерация API-токена в ЛК Маркетплейса
Для доступа к вашему магазину СДЭК необходим уникальный ключ (API-токен). Алгоритм действий на всех площадках идентичен:
- Перейдите в раздел «Настройки» → «API и модули» (или «Доступ к API»).
- Создайте новый токен.
- При выдаче прав доступа обязательно выберите уровень «Чтение и запись» (Полный доступ). В противном случае интеграция не сможет обновлять статусы заказов.
- Скопируйте сгенерированный токен. Внимание: Токен отображается только один раз. Сохраните его в надежном месте.
Этап 2. Настройка в личном кабинете СДЭК
- Авторизуйтесь в личном кабинете СДЭК (для юридических лиц).
- Перейдите в раздел «Интеграции».
- Выберите вкладку «DBS» и нужную вам торговую площадку.
- Вставьте скопированный API-токен и нажмите «Проверить ключ» (проверка может занимать от 1 минуты до нескольких часов).
- После успешной проверки заполните настройки магазина и склада:
- Данные о магазине: Наименование, которое будет отображаться в накладной.
- Тарифы: Выберите доступные тарифы СДЭК (рекомендуется выбрать все доступные, чтобы сократить количество необработанных заказов).
- Данные отправителя: ФИО, телефон, e-mail (подставляются в накладную).
- Нажмите «Сохранить» и «Активировать».
Сроки запуска: После активации магазина не производите действий со сборочными заданиями в течение
30 минут — это время необходимо для первичной синхронизации API маркетплейса.
Раздел 2. Особенности интеграции по площадкам2.1. Интеграция DBS с Wildberries (WB)
Модель: Витрина DBS.
Настройка склада в WB:- В ЛК Wildberries создайте склад «Доставка своими силами (DBS)».
- Категория товаров: Обратите внимание, что для МГТ (до 25 кг) и СГТ (свыше 25 кг) необходимо создавать отдельные склады. Категорию товара после создания изменить нельзя.
- Зона доставки: География доставки Wildberries должна строго соответствовать зонам обслуживания СДЭК. Каждый регион может принадлежать только одной зоне доставки.
Права доступа для токена WB:При создании токена предоставьте доступ к категориям:
Контент (для габаритов),
Маркетплейс (для заказов),
Цены и скидки (для объявленной стоимости).
2.2. Интеграция с Ozon (RealFBS)
Модель: realFBS (Standart).
Настройка склада в Ozon:- В разделе FBS → «Управление логистикой» создайте склад со скоростью доставки «Standart» (экспресс-доставка через интеграцию не поддерживается).
- При создании метода доставки выберите «СДЭК» и укажите схему работы «Уже есть договор».
Важное ограничение: Если вы выбираете тариф в ЛК Ozon, а в ЛК СДЭК указан другой тариф, приоритет отдается настройкам
СДЭК. Интеграция Ozon не поддерживает доставку в ПВЗ Ozon, используйте ПВЗ СДЭК или курьерскую доставку.
2.3. Интеграция с Яндекс Маркет (Yandex)
Модель: DBS.
Настройка склада в Яндексе:- Создайте склад в разделе «Остатки» и выберите модель DBS.
- Настройте тарифы доставки для покупателя. Если этого не сделать, Яндекс будет использовать дефолтные значения (0₽, 99₽, 599₽). Рекомендуется выгрузить тарифы из вашего личного кабинета СДЭК и перенести их в настройки Яндекса.
- Для подключения самовывоза через ПВЗ СДЭК необходимо заполнить специальную таблицу и отправить её в техподдержку Яндекс Маркета (таблица доступна на учебном портале СДЭК).
2.4. Интеграция с Авито (Avito)
Модель: DBS (Силами продавца).
Особенности генерации ключа:В отличие от других площадок, для Авито используются
Client_id и
Client_secret, которые генерируются в разделе «Собственная разработка» ЛК Авито.
Настройка доставки:- На странице способов доставки выберите «Силами продавца» → «Пункты выдачи».
- Отметьте галочкой СДЭК.
- Важно: В текущей версии интеграции поддерживается только доставка до ПВЗ СДЭК. Курьерская доставка через интеграцию недоступна.
Раздел 3. Работа с накладными и габаритами
СДЭК использует интеллектуальный алгоритм для расчета габаритов грузового места, если они не указаны в карточке товара маркетплейса.
Алгоритм расчета:- Суммируются объемы всех товаров (Длина × Ширина × Высота).
- Применяется коэффициент упаковки (например, 5%).
- Определяется наибольшая сторона и наименьшая сторона.
- Высота вычисляется как частное от деления итогового объема на произведение длины и ширины.
- Все значения округляются в большую сторону до целых чисел.
Пример:- Товар 1: 120см × 18см × 6см.
- Итоговый объем с упаковкой: 15 025,5 см³.
- Итоговые габариты: 120 см × 6 см × 21 см.
Если в товаре не указаны габариты, интеграция использует значения по умолчанию, заданные в секции «Товары» в настройках интеграции СДЭК.
Раздел 4. Техническая поддержка
Если у вас возникли проблемы с настройкой интеграции, заказы не создаются или API-ключ не проходит проверку, обратитесь в
техническую поддержку СДЭК.
Контакты:- Email для интеграций: d.khairullina@cdek.ru
- При обращении укажите:
- Номер вашего договора с СДЭК.
- Номер заказа (сборочного задания) на маркетплейсе, с которым возникла проблема.
Мы оперативно поможем решить проблему и настроить бесперебойную логистику для вашего бизнеса