Подключение Wildberries в DENCO Seller

Этап 2. Привязка кабинета и первая синхронизация

 

ℹ️  Что описано в этом документе Это вторая часть инструкции по подключению Wildberries к DENCO Seller. Если вы ещё не получили API-токен — начните с Этапа 1. Создание API-токена в кабинете WB Partners. Здесь шаг за шагом — что делать в кабинете DENCO Seller: куда зайти, какой способ подключения выбрать, как проверить, что всё работает, и что делать в нестандартных ситуациях.

 

⏱️  Сколько займёт 3–5 минут на само подключение + 5–15 минут на первую синхронизацию каталога. Конкретное время зависит от размера каталога и режима подключения (OAuth — быстрее).

 

Содержание

 

•       Перед началом — что вам понадобится

 

•       Шаг 1. Откройте раздел «Маркетплейсы»

 

•       Шаг 2. Откройте мастер подключения

 

•       Шаг 3. Выберите способ подключения

 

•       Вариант A. OAuth (рекомендуем)

 

•       Вариант B. API-ключ

 

•       Шаг 4. Завершение подключения и онбординг-визард

 

•       Шаг 5. Где видно подключённый кабинет

 

•       Шаг 6. Управление подключением

 

•       Шаг 7. Нестандартные ситуации

 

•       Часто задаваемые вопросы

 

•       Памятка по скриншотам

 

 

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

 

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

 

•       Активный аккаунт DENCO Seller — регистрация на seller.denco.store и заполненные реквизиты компании в разделе «Настройки → Компания». Без реквизитов кнопка подключения недоступна — DENCO не сможет формировать первичные документы.

 

•       Доступ к Wildberries — один из двух вариантов:

 

•           ◦ API-токен из Этапа 1 (вариант «API-ключ») — подходит, если подключает менеджер.

 

•           ◦ Логин и пароль от seller.wildberries.ru (вариант «OAuth») — рекомендуем, если у вас прямой доступ к учётной записи продавца.

 

•       5 минут свободного времени — столько обычно занимает подключение.

 

 

💡  Какой способ выбрать? OAuth (рекомендуем) — два клика, не нужно хранить и обновлять токен каждые 180 дней. DENCO сам управляет авторизацией через Wildberries. API-ключ — нужен, если подключает менеджер без доступа к личному кабинету владельца, или если вы уже создали токен на стороне WB и хотите его использовать. По итогу оба способа дают одинаковые возможности — синхронизация заказов, остатков, цен и аналитики.

 

Шаг 1. Откройте раздел «Маркетплейсы»

 

Подключение маркетплейса живёт в одном месте — Настройки → Маркетплейсы. Зайти туда можно тремя способами:

 

1	Из меню в шапке

 

Иконка-шестерёнка в правом верхнем углу → откроется страница «Настройки», переключитесь на вкладку «Маркетплейсы».

 

2	С главного дашборда

 

Если у вас ещё нет ни одного подключённого маркетплейса, на главной появится плитка «Гид по настройке» с кнопкой «Подключить маркетплейс» — она ведёт сразу в нужную вкладку.

 

3	По прямой ссылке

 

seller.denco.store/settings?tab=marketplaces

 

📷  СКРИНШОТ ID: ss_mwhoxpu Главный дашборд — виджет «Гид по настройке» с кнопкой «Подключить маркетплейс» на пустом аккаунте

 

📷  СКРИНШОТ ID: ss_ll4aye4 Раздел «Настройки → Маркетплейсы» до первого подключения — заголовок, счётчики (0 подключённых), три карточки в секции «Добавить маркетплейс»: Wildberries / Ozon / Яндекс Маркет

 

Шаг 2. Откройте мастер подключения

 

В разделе «Маркетплейсы» под списком уже подключённых кабинетов (или сразу, если их ещё нет) есть секция «Добавить маркетплейс» с карточками доступных площадок.

 

Нажмите на карточку Wildberries — откроется модальное окно «Подключение маркетплейса».

 

В верхней части модалки увидите три карточки маркетплейсов:

 

Маркетплейс	Подпись на карточке
Wildberries	100+ млн покупателей
Ozon	50+ млн покупателей
Яндекс Маркет	30+ млн покупателей

 

ℹ️  Несколько кабинетов Если какой-то маркетплейс уже подключён, на его карточке будет серый бейдж «Подключен». Повторно подключить тот же маркетплейс можно — DENCO поддерживает несколько кабинетов на одной площадке (например, два юрлица на Wildberries).

 

Выберите Wildberries.

 

📷  СКРИНШОТ ID: ss_nnhoo79 Модалка «Подключение маркетплейса» — экран выбора маркетплейса. Три карточки, фокус на Wildberries

 

Шаг 3. Выберите способ подключения

 

После выбора Wildberries появится экран «Способ подключения Wildberries» с двумя вариантами — OAuth и API-ключ.

 

📷  СКРИНШОТ ID: ss_zs5gjr9 Экран выбора способа подключения — две карточки: «OAuth (рекомендуется)» и «API-ключ»

 

Вариант A. OAuth (рекомендуем)

 

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

 

1	Нажмите карточку «OAuth (рекомендуется)»

 

Под карточкой увидите подпись «Авторизуйтесь через WB напрямую — быстро и безопасно».

 

2	Подтвердите переход в Wildberries

 

DENCO покажет промежуточный экран «Сейчас вы перейдёте в Wildberries» с кнопкой «Перейти в Wildberries». Нажмите — откроется страница входа на seller.wildberries.ru.

 

3	Войдите в Wildberries и подтвердите доступ

 

На стороне WB вы увидите экран авторизации (если ещё не залогинены) и затем экран разрешений: «Сервис DENCO запрашивает доступ к…». Подтвердите.

 

4	Вернитесь обратно в DENCO

 

После подтверждения Wildberries автоматически вернёт вас в DENCO. В URL появится параметр ?oauth_marketplace=N — это значит, что подключение создано. Дальше — Шаг 4.

 

📷  СКРИНШОТ ID: ss_gf5n3r6 Промежуточный экран «Сейчас вы перейдёте в Wildberries» с кнопкой подтверждения

 

✅  Чем хорош OAuth Не нужно хранить и обновлять токен каждые 180 дней — Wildberries сам обновляет авторизацию, DENCO получает свежие ключи без вашего участия. Это надёжнее и безопаснее, чем хранить API-ключ.

 

Вариант B. API-ключ

 

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

 

1	Нажмите карточку «API-ключ»

 

Откроется форма ввода токена.

 

2	Вставьте API-токен

 

В форме увидите поле «API-токен» (тип password — символы скрыты звёздочками, placeholder «Вставьте API-токен»). Под полем — подсказка: «Ключ действует для всего аккаунта — он будет использоваться для всех ваших складов».

 

Вставьте токен, полученный в Этапе 1. Если открыли мастер без прочтения первой части — там же, прямо в форме, есть разворачиваемый блок «Где найти API-ключ?» с сокращённой инструкцией.

 

📷  СКРИНШОТ ID: ss_w1z5epc Форма ввода API-ключа, пустая. Раскрыт popover «Где найти API-ключ?»

 

3	Нажмите «Проверить ключ»

 

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

 

Результат	Что значит	Что делать
🟢 «Ключ действителен»	Токен принят. Если в ответе есть число складов — увидите «Найдено N складов».	Жмите «Подключить» внизу.
🔴 «API-ключ неверный»	Скопировали не тот символ или токен был отозван в кабинете WB.	Создайте новый токен в Этапе 1.
🔴 «API-ключ истёк»	WB-токены живут 180 дней.	Создайте новый.
🔴 «Недостаточно прав»	В Этапе 1 не отмечена нужная категория разрешений.	Создайте новый токен со всеми категориями (Контент / Цены / Маркетплейс / Аналитика / Поставки / FBS-заказы / Финансы).
🟡 «Не удалось проверить»	WB API временно недоступен.	Можно продолжить — DENCO перепроверит ключ при первом sync'е.

 

📷  СКРИНШОТ ID: ss_3fc3dkq Форма ввода API-ключа после клика «Проверить ключ» — зелёная плашка «Ключ действителен» + «Найдено N складов»

 

⚠️  Защита от «подключилось, но молча не работает» Кнопка «Подключить» активна только после успешной проверки. Это намеренно: мы предпочитаем дать вам понятную ошибку сейчас, чем создать «битый» кабинет, который потом тихо не синхронизируется.

 

4	Нажмите «Подключить»

 

После успешной проверки кнопка «Подключить» становится активной — жмите.

 

Шаг 4. Завершение подключения и онбординг-визард

 

После клика «Подключить» (API-key) или возврата из OAuth-окна происходит следующее:

 

1	Тост подтверждения

 

В правом верхнем углу появится зелёный тост: «Подключено — Wildberries подключён».

 

2	Экран выбора складов

 

Мастер перейдёт на экран «Выберите склады для синхронизации». DENCO автоматически загрузит список ваших складов WB. Отметьте чекбоксами те склады, по которым вы хотите получать остатки и заказы.

 

ℹ️  Можно пропустить Если сейчас не хотите разбираться — нажмите «Пропустить». Склады можно будет привязать позже в настройках кабинета. Подключение уже работает — пропуск онбординга не блокирует синхронизацию.

 

📷  СКРИНШОТ ID: ss_qzd3sb9 Экран «Выберите склады для синхронизации» — список чекбоксов со складами, кнопки «Продолжить (N)» / «Пропустить»

 

3	Онбординг-визард — три шага

 

После выбора складов откроется визард настройки кабинета — три простых экрана с тумблерами:

 

•       Шаг 1 — Склады. Подтверждение выбранных складов.

 

•       Шаг 2 — Режим работы. Тумблеры: продавать ли FBO (со склада WB), миксы, блоки; автоматически отправлять цены; отправлять остатки; включать DENCO-фулфилмент.

 

•       Шаг 3 — Итог. Сводка по выбранным параметрам и кнопка «Завершить настройку».

 

 

📷  СКРИНШОТ ID: ss_ufoc5qs Онбординг — шаг «Режим работы». Тумблеры: FBO / миксы / блоки / авто-цены / отправка остатков / фулфилмент

 

4	Готово!

 

После «Завершить настройку» появится тост «Настройка завершена — Wildberries готов к работе» и произойдёт переход на карточку подключённого кабинета (/settings?tab=marketplaces&focus=N).

 

📷  СКРИНШОТ ID: ss_3ro1hcf Онбординг — шаг «Итог» + тост «Wildberries готов к работе» в правом верхнем углу

 

✅  Что произойдёт дальше В течение 5–15 минут (зависит от размера каталога) DENCO загрузит ваши товары, остатки и историю заказов за последние 30 дней. Прогресс виден в карточке кабинета — статус сменится с «Синхронизируется…» на «Активен».

 

Шаг 5. Где видно подключённый кабинет

 

Вернувшись на Настройки → Маркетплейсы, увидите свой WB-кабинет в списке как строку-карточку. На карточке отображается:

 

•       Логотип Wildberries и название кабинета (по умолчанию «Wildberries», можно переименовать).

 

•       Метод подключения: бейдж «OAuth» или «API-ключ».

 

•       Статус синхронизации: «Синхронизируется…», «Активен», «Требует действия», «На паузе», «Ошибка».

 

•       Дата последней синхронизации.

 

•       Меню действий (иконка-шестерёнка) с пунктами: Редактировать, Переподключить, Сменить метод подключения, Поставить на паузу / Возобновить, Отключить.

 

 

В верхней панели — счётчики: сколько кабинетов «Требуют действия», сколько «Подключённых», сколько «Синхронизируются», сколько складов «Не привязано». Над списком — переключатель «Все / Требуют действия», чтобы быстро видеть проблемные кабинеты.

 

📷  СКРИНШОТ ID: ss_pqsalyi Раздел «Маркетплейсы» после подключения — одна карточка Wildberries в статусе «Активен», счётчики сверху, переключатель «Все / Требуют действия»

 

Шаг 6. Управление подключением

 

Несколько кабинетов одного маркетплейса

 

DENCO поддерживает несколько кабинетов на одной площадке — например, два юрлица на Wildberries. Просто нажмите карточку Wildberries в секции «Добавить маркетплейс» ещё раз — мастер откроется снова, и вы создадите второй кабинет независимо от первого. У каждого кабинета свой набор складов и свои настройки.

 

Что означают статусы

 

Статус	Что значит
🟢 Активен	Синхронизация идёт штатно.
🔵 Синхронизируется	DENCO сейчас тянет данные. Первичный sync может занять до 15 минут.
🔴 Требует действия	Токен истёк, отозван или у него недостаточно прав. Под карточкой появится плашка с конкретной причиной и кнопкой решения.
⏸️ На паузе	Вы вручную приостановили sync. Данные не теряются, можно возобновить.
⚠️ Ошибка	Техническая проблема — обычно временная (WB API недоступен). DENCO автоматически повторит попытку.

 

Обновить или перевыпустить токен

 

ℹ️  WB-токены живут 180 дней DENCO заранее напомнит об истечении: за 14 дней — жёлтая плашка, за 3 дня — оранжевая, после истечения — красная «Требует действия», и DENCO остановит push-операции (отправку цен и остатков), чтобы не отправлять команды с битым ключом.

 

Как обновить:

 

1	Откройте карточку кабинета

 

Настройки → Маркетплейсы → нажмите на карточку Wildberries.

 

2	Найдите кнопку обновления

 

В выпавшем drawer'е (на десктопе — справа, на мобильном — снизу) — кнопка «Переподключить» (для OAuth) или «Обновить ключ» (для API-key).

 

3	Введите новый токен или подтвердите OAuth

 

Дальше — тот же мастер, что в Шаге 3, но в режиме reconnect. Кабинет, его настройки и история не сбрасываются — обновляется только пара авторизационных полей. Синхронизация возобновится автоматически.

 

Сменить метод подключения (OAuth ↔ API-ключ)

 

В том же drawer'е — пункт «Сменить метод подключения». Откроется мастер с подтверждением (текущая авторизация сбросится) и предложит ввести новые credentials.

 

Поставить на паузу

 

В drawer'е — пункт «Поставить на паузу». Sync остановится, все данные и настройки сохранятся. Возобновить — пункт «Возобновить».

 

Отключить кабинет

 

В drawer'е — пункт «Отключить» с подтверждением: «Отключить магазин „Wildberries“? Синхронизация остановится. Данные и настройки сохранятся. Вы сможете подключить магазин снова в любой момент.» Это мягкое отключение — все исторические данные (заказы, продажи, отчёты) остаются. Чтобы удалить кабинет полностью — обратитесь в поддержку.

 

📷  СКРИНШОТ ID: ss_l8pmsku Drawer редактирования кабинета — статус, метод подключения, кнопки Переподключить / Сменить метод / Поставить на паузу / Отключить, ниже секции настроек

 

Шаг 7. Нестандартные ситуации

 

Я вставил неверный токен

 

Проверка ключа поймает это до подключения. Увидите красный alert «Ошибка проверки» с одним из сообщений:

 

•       «API-ключ неверный. Проверьте, что скопировали правильно.»

 

•       «API-ключ отклонён маркетплейсом (401/403). Проверьте корректность.»

 

 

Кнопка «Подключить» останется неактивной. Создайте новый токен в кабинете WB по Этапу 1 и повторите.

 

Токен принят, но не хватает прав

 

При проверке увидите: «Недостаточно прав. Создайте токен с нужными разрешениями.» Это значит, что в WB при создании токена не отметили все необходимые категории. Минимальный набор для полноценной работы DENCO:

 

•       Контент — карточки товаров

 

•       Цены и скидки — управление ценами

 

•       Маркетплейс — заказы, сборка, отгрузки

 

•       Аналитика — отчёты

 

•       Поставки — поставки на склады WB

 

•       FBS-заказы — заказы с вашего склада

 

•       Финансы — выплаты, отчёты

 

 

Создайте новый токен со всеми этими галочками — старый можно сразу удалить в кабинете WB.

 

Синхронизация зависла

 

Если статус кабинета больше 30 минут показывает «Синхронизируется…»:

 

1	Запустите синхронизацию вручную

 

Откройте drawer кабинета → пункт «Синхронизировать вручную» (доступен, когда нет активного запроса).

 

2	Если кнопка серая — ждём

 

Sync уже в очереди — DENCO сам подхватит, как только освободится воркер.

 

3	Если не помогает — поддержка

 

Если после ручного запуска статус не меняется в течение часа — напишите в поддержку с номером кабинета (виден в URL: /settings/marketplaces/123/edit).

 

Я подключил, но не вижу товаров и заказов

 

Первичная синхронизация занимает 5–15 минут (зависит от объёма каталога). Если через 30 минут карточки товаров не подтянулись — проверьте:

 

•       Статус кабинета = «Активен» (не «Требует действия»).

 

•       В Этапе 1 был отмечен раздел «Контент» при создании токена.

 

•       В разделе «Склады» на странице кабинета отмечены те склады, на которых лежит ваш товар. Если ничего не отмечено — DENCO не знает, откуда тянуть остатки.

 

 

📷  СКРИНШОТ ID: ss_69w1gr4 Карточка кабинета с истёкшим токеном — красная плашка «Требует действия», текст-объяснение, кнопка «Обновить ключ» / «Переподключить»

 

Часто задаваемые вопросы

 

Можно ли подключить несколько кабинетов Wildberries?

Да — DENCO поддерживает несколько кабинетов на одной площадке. Просто нажмите карточку Wildberries в секции «Добавить маркетплейс» ещё раз. У каждого кабинета свой набор складов и свои настройки.

 

OAuth и API-ключ — это разные подключения?

Нет, это два способа авторизации одного и того же кабинета. Можно подключить через OAuth, а потом сменить на API-ключ (и наоборот) — история и данные кабинета сохранятся.

 

Что DENCO видит после подключения?

DENCO автоматически загружает ваш каталог товаров, остатки на складах и историю заказов за последние 30 дней. Дальше — синхронизация в реальном времени (каждые несколько минут для заказов, по расписанию для цен и остатков).

 

Безопасно ли передавать токен или OAuth-доступ?

Да. DENCO — проверенный сервис в каталоге Wildberries. API-ключи хранятся в зашифрованном виде (Fernet, ротация ключей), OAuth-токены обновляются автоматически — мы их не видим в открытом виде. Никогда не передавайте токен третьим лицам и не публикуйте его.

 

Можно ли отключиться и подключиться снова?

Да. «Отключить» — это мягкое отключение: синхронизация останавливается, но все исторические данные (заказы, продажи, отчёты) остаются. Можно подключить кабинет заново в любой момент.

 

Где смотреть детали ошибки?

В карточке кабинета — рядом со статусом «Требует действия» или «Ошибка» — будет плашка с причиной и кнопкой решения. Полный лог последних попыток sync'а — в разделе «История синхронизаций» внутри drawer'а кабинета.

 

✅  Готово! Wildberries подключён Теперь DENCO синхронизирует ваш каталог, остатки, цены и заказы. Все ключевые действия — управление складами, ценами, выгрузка отчётов — доступны в карточке кабинета и в разделах «Товары», «Цены», «Заказы». Что дальше: •  Привяжите склады к товарам — раздел «Склады» в drawer'е кабинета. •  Настройте автоматическую отправку цен — в «Настройки → Цены». •  Подключите другие маркетплейсы — Ozon и Яндекс Маркет работают по тому же сценарию.

 

Памятка по скриншотам

 

Для оформления статьи нужны скриншоты с тестового аккаунта DENCO Seller. Ниже — порядок и состав кадров.

 

№	Кадр	Где сделать
1	Дашборд + стрелка на «Подключить маркетплейс»	/dashboard пустого аккаунта
2	Раздел Маркетплейсы до подключения	/settings?tab=marketplaces
3	Шаг выбора маркетплейса в модалке	Модалка после клика на пустую карточку WB
4	Экран выбора способа (OAuth / API-ключ)	Следующий экран мастера
5	Промежуточный экран «Перейти в Wildberries» (OAuth)	После клика «OAuth»
6	Форма ввода API-ключа, заполненная + проверка	После клика «Проверить ключ»
7	Выбор складов после подключения	Сразу после «Подключить»
8	Онбординг — Шаг 2 «Режим работы»	Тумблеры FBO / миксы / блоки / цены / остатки
9	Онбординг — Шаг 3 «Итог» + тост готовности	Финальный экран wizard'а
10	Список маркетплейсов после подключения	/settings?tab=marketplaces с активным WB
11	Drawer редактирования кабинета	Клик на карточку WB
12	Состояние ошибки (истёкший токен)	Кабинет с просроченным WB-токеном

 

📷  Технические требования Ширина 1440px (Retina × 2 = 2880), формат PNG, без рамок ОС. На маке: Cmd+Shift+5 → область → разметка → blur tool для замазывания токенов и имён. Для мобильной версии — Chrome DevTools → device toolbar → iPhone 14 Pro.