Docs

Wildberries: начало работы

Что вы получите после подключения

После того как кабинет Wildberries подключён, DENCO начинает работать с ним автоматически:

  • Цены. Платформа рассчитывает рекомендованные цены по вашим правилам и выгружает их на Wildberries — вручную пересчитывать ничего не нужно.
  • Остатки. Доступные к продаже остатки синхронизируются с вашими складами и поставщиками.
  • Заказы. Новые заказы и статусы продаж подтягиваются в DENCO для аналитики и обработки.

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

Перед началом

Убедитесь, что у вас есть всё необходимое — это сэкономит время на подключении:

  • Доступ владельца кабинета Wildberries (seller.wildberries.ru). Создавать и удалять API-токены может только владелец аккаунта.
  • Учётная запись в DENCO с правом подключать маркетплейсы (раздел Настройки → Маркетплейсы).
  • Пара минут, чтобы пройти визард подключения до конца — он короткий.

Выберите способ подключения

Подключить кабинет можно двумя способами. Оба ведут к одному результату — DENCO получает доступ к нужным разделам WB API. Выберите вкладку с удобным для вас способом.

Экран выбора способа подключения WB: OAuth (рекомендуется) или API-ключ
Выберите способ: OAuth подключается в один клик, API-ключ — ручной ввод токена

Подключение в обоих случаях начинается одинаково — в разделе Настройки → Маркетплейсы в DENCO:

Раздел «Настройки → Маркетплейсы» в DENCO с кнопкой «Подключить кабинет»
Настройки → Маркетплейсы → «Подключить кабинет»
Окно «Подключение маркетплейса» в DENCO с выбором Wildberries, Ozon, Яндекс Маркет
В окне подключения выберите Wildberries

Способ A. Подключение через OAuth (рекомендуется)

OAuth — это безопасное подключение по доверию между WB и DENCO: вы подтверждаете доступ один раз на стороне Wildberries, и токен не нужно создавать и копировать вручную.

  1. Выберите Wildberries и нажмите «Подключить через WB»

    В визарде подключения выберите Wildberries и способ OAuth. DENCO перенаправит вас на сайт seller.wildberries.ru для подтверждения.

  2. Подтвердите доступ на стороне Wildberries

    На странице Wildberries вы увидите запрос доступа DENCO к четырём разделам кабинета. Проверьте список и нажмите «Разрешить доступ».

    Экран подтверждения OAuth на seller.wildberries.ru: запрос доступа DENCO к 4 разделам, кнопка «Разрешить доступ»
    На стороне WB нажмите «Разрешить доступ» — кабинет подключится автоматически
  3. Вернитесь в DENCO — кабинет подключён

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

Способ B. Подключение по API-ключу

Если вы предпочитаете создать токен вручную — сгенерируйте его в кабинете Wildberries и вставьте в DENCO. Учтите: токен Wildberries действует 180 дней, после чего его нужно создать заново.

  1. Создайте токен в кабинете Wildberries

    В кабинете Wildberries откройте Профиль → Интеграции по API и нажмите «Создать токен». Задайте понятное имя (например, DENCO) и отметьте галочками четыре раздела доступа: Контент, Цены и скидки, Маркетплейс, Статистика. Не включайте режим «Только на чтение» — DENCO выгружает цены и остатки, поэтому нужен доступ на чтение и запись.

    Страница создания токена в кабинете Wildberries: имя токена «DENCO», отмечены 4 раздела (Контент, Цены и скидки, Маркетплейс, Статистика), кнопка «Создать токен» с пронумерованными подсказками
    В кабинете WB: ① назовите токен, ② отметьте 4 раздела, ③ создайте и скопируйте
  2. Вставьте токен в DENCO и проверьте ключ

    Вернитесь в визард подключения DENCO, выберите способ API-ключ, вставьте скопированный токен в поле и нажмите «Проверить ключ». Если не помните, где взять ключ — подсказка «Где найти ключ?» прямо в форме.

    Форма «Авторизация в Wildberries» в DENCO: подсказка где взять ключ, поле API-токена, кнопка «Проверить ключ»
    Вставьте токен и нажмите «Проверить ключ»
  3. Дождитесь успешной проверки

    Если токен валиден и содержит все нужные права, DENCO покажет зелёное уведомление и найдёт ваши склады. Кнопка «Подключить» станет активной.

    Зелёное уведомление «Ключ действителен» в DENCO, найдены склады, кнопка «Подключить» активна
    Ключ прошёл проверку — можно подключать

    Если проверка не прошла — DENCO подскажет, чего именно не хватает. Самая частая причина — не отмечен раздел «Контент» при создании токена.

    Красное уведомление «Ошибка проверки» в DENCO: токену не хватает доступа «Контент» (wb_no_content_scope)
    Если не хватает раздела «Контент» — создайте токен заново со всеми 4 правами

Финальный шаг: выберите склады

После того как кабинет подключён любым из способов, визард предложит выбрать склады Wildberries для синхронизации остатков. Отметьте нужные склады и нажмите «Продолжить». Этот шаг можно пропустить и настроить склады позже в разделе складов.

Шаг визарда «Выберите склады для синхронизации» в DENCO: чекбоксы складов WB, кнопка «Продолжить»
Отметьте склады для синхронизации (можно пропустить)

Что происходит после подключения

Сразу после подключения DENCO начинает первичную загрузку и обработку данных кабинета. Это происходит асинхронно — в фоне, без вашего участия:

  1. Загрузка карточек

    Платформа подтягивает карточки товаров из вашего кабинета Wildberries.

  2. Сопоставление категорий

    Товары привязываются к категориям, чтобы корректно работали правила ценообразования.

  3. Расчёт цен

    DENCO рассчитывает рекомендованные цены по вашим правилам с учётом закупочных цен поставщиков.

  4. Выгрузка цен и остатков

    Рассчитанные цены и доступные остатки выгружаются обратно на Wildberries.

Права токена и зачем они нужны

DENCO запрашивает ровно четыре раздела доступа — каждый нужен для конкретной части автоматизации. Меньший набор прав приведёт к ошибке проверки.

Раздел доступа WB Зачем DENCO
Контент Загрузка карточек товаров — без него подключение не пройдёт проверку.
Цены и скидки Выгрузка рассчитанных цен на Wildberries.
Маркетплейс Синхронизация складов и остатков.
Статистика Загрузка заказов и данных о продажах для аналитики.

Решение проблем

Если проверка ключа не прошла или данные не появились — найдите свой случай ниже.

Ключ недействителен или не проходит проверку (wb_token_invalid)

Токен скопирован не полностью, содержит лишние пробелы или был удалён в кабинете WB. Создайте новый токен в разделе Профиль → Интеграции по API, скопируйте его целиком и вставьте заново.

Токену не хватает прав (wb_insufficient_scopes)

При создании токена отмечены не все нужные разделы. DENCO требует четыре: Контент, Цены и скидки, Маркетплейс, Статистика. Изменить набор прав у существующего токена нельзя — создайте новый со всеми четырьмя разделами.

Не хватает доступа «Контент» (wb_no_content_scope)

Это частный случай предыдущей ошибки: без раздела Контент DENCO не сможет загрузить карточки товаров. Создайте токен заново и обязательно отметьте «Контент».

Используется устаревший токен (wb_legacy_token)

Токен создан в старом формате, который Wildberries больше не поддерживает для нужных операций. Создайте новый токен по актуальной инструкции выше — старые токены формата прежних лет нужно перевыпустить.

Слишком много запросов / ошибка частоты (rate limit)

Wildberries ограничивает частоту обращений к API. Это временное состояние — DENCO автоматически повторит операцию позже. Специальных действий от вас не требуется; просто подождите.

Цены и остатки не появились на Wildberries

Чаще всего причина не в подключении, а в настройке после него. Проверьте по порядку:

  • Склады. Выбраны ли склады WB для синхронизации? Без выбранных складов остатки не выгружаются.
  • Связки с поставщиками. Привязаны ли товары к поставщикам? Расчёт цен опирается на закупочные цены — без связки цена не рассчитается.
  • Время обработки. Первичная выгрузка идёт в фоне и на больших каталогах занимает время.

Что дальше

Кабинет подключён — теперь настройте автоматизацию под себя:

  • Настройте склады — укажите, какие склады WB участвуют в синхронизации остатков.
  • Свяжите поставщиков — привяжите товары к поставщикам, чтобы DENCO рассчитывал цены по закупке.
  • Проверьте цены — убедитесь, что правила ценообразования дают нужный результат перед выгрузкой.

Хотите разобраться глубже в том, как DENCO работает с Wildberries на своей стороне — карточки, расчёт цен, выгрузка? Читайте Wildberries: подробно о стороне DENCO.

Подключаете другие маркетплейсы? См. подключение Ozon и подключение Яндекс Маркета.

Нужна помощь?

Если подключение не удаётся или возникли вопросы — напишите в поддержку DENCO. Укажите способ подключения (OAuth или API-ключ) и код ошибки из уведомления, если он есть, — это ускорит решение.