FAQ

Ответы на часто задаваемые вопросы

350

Дата публикации: 29.08.2025

content

1. Введение в WB API

1.1. Что такое WB API и как он помогает работать на Wildberries?

API (от англ. Application Programming Interface) — это интерфейс, с помощью которого программы могут автоматически обмениваться данными с Wildberries.

Проще говоря, WB API позволяет интегрировать ваш интернет-магазин, склад, ERP/WMS/OMS/CRM или другую систему с Wildberries — чтобы автоматизировать работу и масштабировать бизнес.

Зачем использовать WB API:

  • Автоматизация процессов: продажи, остатки, цены и аналитика обновляются автоматически, без ручного ввода.
  • Быстрая интеграция: API позволяет внедрять решения быстрее и с меньшими затратами.
  • Совместимость с системами учёта: WB API работает как мост между маркетплейсом и вашей IT-инфраструктурой.

1.2. Какие есть способы интеграции?

Для работы с WB API есть два основных подхода:

  • Самостоятельная разработка: максимальная гибкость, контроль и адаптация под ваши процессы. Вы создаёте собственное приложение, скрипты или модуль для системы учёта, чтобы напрямую обмениваться данными с Wildberries через API. Такой способ подойдёт, если у вас есть IT-специалист и нужны уникальные решения.
  • Готовые решения из каталога: быстрый старт без разработки. Вы подключаете WB API с помощью проверенных сервисов из официального Каталога готовых решений для бизнеса. Это удобно, если не хотите тратить ресурсы на настройку и поддержку интеграции — всё работает «из коробки».
scheme_api_integration

Что выбрать?

Ориентируйтесь на задачи вашего бизнеса и технические ресурсы.

  • Если важна гибкость ➞ подойдёт самостоятельная интеграция
  • Если важна скорость и простота ➞ готовое решение из каталога

1.3. На какие составные части делится WB API и что такое endpoint?

Endpoint (эндпоинт) — это конкретный URL-адрес, через который вы взаимодействуете с определёнными функциями WB API. Эндпоинты сгруппированы по категориям, в зависимости от задач. Эти категории в совокупности образуют WB API.

endpoints_scheme

1.4. Какие есть категории WB API?

Основные категории WB API для продавцов:

  • Контент — управление карточками товаров, характеристиками, медиафайлами, категориями и создание новых товаров.
  • Маркетплейс — основные торговые операции: управление остатками на складах, получение информации о складах и офисах.
  • Заказы — получение и управление заказами по схемам FBS (со склада продавца) и FBW (со склада WB), статусы заказов, отгрузки.
  • Статистика — получение аналитических данных о продажах, заказах, остатках товаров, отчёты по товарообороту.
  • Финансы — финансовые отчёты, детализация по периодам, реестры транзакций, расчёты с WB.
  • Аналитика — расширенная аналитика: отчёты по скрытым товарам, самовыкупам, позиции товаров в поиске.
  • Продвижение — управление рекламными кампаниями, настройка ставок, получение статистики по рекламе, участие в акциях.
  • Вопросы и отзывы — работа с отзывами покупателей, ответы на вопросы, модерация обратной связи.
  • Цены и скидки — массовое обновление цен, управление скидками, загрузка прайс-листов.
  • Чат с покупателем — общение с покупателями через API, обработка сообщений и запросов.
  • Поставки — создание и управление поставками, получение списка складов WB, тарифы доставки.
  • Возвраты — обработка заявок на возврат товаров, принятие решений по возвратам, работа с претензиями.
  • Документы — получение различных документов: актов, накладных, отчётов в разных форматах.
  • Тарифы — получение актуальных комиссий по категориям, расчёт стоимости возвратов, складские коэффициенты.Каждая категория требует соответствующий токен авторизации и имеет свои лимиты запросов.

Отдельный API для Wildberries Цифровой

  • WB Digital API (WBD API) — специальный API для продавцов цифровых товаров (видео, аудио, электронные книги, ключи активации), управление цифровым контентом.

2. Авторизация и безопасность

2.1. Что такое токен и зачем он нужен?

Токен — это уникальный ключ доступа для работы с WB API. Он нужен для авторизации запросов, которые отправляет ваше приложение к сервисам Wildberries. Без токена доступ к данным вашего магазина невозможен, поэтому важно хранить его в безопасности и не передавать третьим лицам без необходимости.

2.2. Как создать токен?

Вы можете создать токен личном кабинете продавца Wildberries:

  • Перейдите в раздел «👤 Профиль → Интеграции по API»
  • Нажмите «➕ Создать токен», укажите необходимые права доступа
  • Сохраните созданный токен в надёжном месте — он показывается только один раз при создании

2.3. Кто может создать токен?

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

2.4. Какие типы токенов существуют и в чём их отличия?

Существует несколько типов токенов:

  • Токен только на чтение (read) — позволяет только получать данные (например, статистику).
  • Токен на чтение и запись (write) — позволяет изменять данные (например, обновлять цены и остатки товаров).

2.5. Сколько токенов можно создать?

На один магазин можно создать не более 20 токенов.

2.6. Что такое OAuth 2.0 и когда его использовать?

OAuth 2.0 — это безопасный и удобный протокол авторизации, который позволяет сервисам получать доступ к вашему аккаунту без передачи пароля и API-ключа.

Мы рекомендуем использовать OAuth 2.0 для подключения партнёрских сервисов из каталога решений Wildberries. OAuth удобнее и безопаснее, чем обычный токен, так как даёт возможность отозвать доступ у конкретного приложения в любой момент без замены токена для других интеграций. Кроме того, с этим токеном сервис получает только необходимые для работы данные.

2.7. Какая категория токена нужна для работы с конкретным методом API?

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

Кроме того, вы можете изучить список с категориями токенов для всех методов в документации WB API.

Мы рекомендуется создавать отдельный токен для каждой группы задач или endpoint для безопасности ваших данных.

2.8. Как перевыпустить или отозвать токен?

Вы можете перевыпустить (создать новый) или отозвать (удалить) токен в разделе «👤 Профиль → Интеграции по API» в личном кабинете продавца.

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

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

2.9. Как долго действует токен и как отслеживать этот срок?

Обычный (не OAuth) токен имеет ограничения срока действия в 180 дней. OAuth-токены действуют с автоматической пролонгацией срока действия. Технически access-токен OAuth 2.0 действует 12 часов, refresh-токен — до 30 дней.

Срок действия и статус токенов можно проверять в личном кабинете в разделе «Настройки → Интеграции по API».

3. Каталог готовых решений

3.1. Что такое каталог готовых решений и как им пользоваться?

Каталог готовых решений — это официальный список проверенных сервисов и приложений от партнёров Wildberries, предназначенных для интеграции вашего бизнеса с маркетплейсом без необходимости разработки собственных решений. Для использования каталога:

  • Перейдите в раздел «Каталог готовых решений»
  • Выберите категорию или воспользуйтесь поиском для подбора подходящего сервиса
  • Перейдите на страницу сервиса и свяжитесь с поставщиком решения для подключения

3.2. Какие преимущества даёт каталог?

Каталог готовых решений даёт следующие преимущества:

  • Быстрая интеграция без разработки
  • Гарантия совместимости с Wildberries
  • Поддержка и консультации от поставщиков решений
  • Многие сервисы выпускают регулярные обновления и новые функции

3.3. Чем отличаются сервисы и как выбрать подходящий?

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

  • Определите свои задачи и необходимые функции (например, работа с заказами, аналитика, интеграция с 1С);
  • Используйте фильтры в каталоге для поиска подходящего решения;
  • Сравните отзывы, стоимость и возможности нескольких сервисов перед подключением.

3.4. Как подать заявку для добавления сервиса в каталог?

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

  • Заполните форму заявки на специальной странице
  • Предоставьте подробное описание, техническую документацию и контакты
  • После модерации и проверки ваш сервис будет опубликован

4. Полезные кейсы и практические рекомендации

4.1. Как настроить интеграцию с 1С через WB API?

Для настройки интеграции с 1С через WB API необходимо:

  • Создать токен с необходимыми правами (контент, заказы, аналитика) в личном кабинете продавца Wildberries
  • Использовать готовый модуль или расширение для 1С из каталога решений или разработать собственную интеграцию на основе документации WB API
  • Настроить соответствие полей и данных между вашей конфигурацией 1С и системой Wildberries (карточки товаров, остатки, цены, заказы)
  • Протестировать работу интеграции в тестовом контуре перед запуском в боевую среду

Читайте подробнее про интеграция 1С и Wildberries в отдельной статье

4.2. Как перенести карточки товаров на Wildberries с других маркетплейсов?

Чтобы перенести карточки товаров с других маркетплейсов:

  • Подготовьте экспортный файл с данными о товарах (например, в формате XLS, CSV или XML) с текущей платформы
  • Адаптируйте данные под требования Wildberries (описание товаров, характеристики, изображения)
  • Используйте WB API или готовое решение из каталога для автоматической загрузки карточек на Wildberries
  • Проверьте загруженные данные в тестовом контуре, затем запустите загрузку в боевое окружение

5. Документация, примеры и поддержка

5.1. Где искать официальную информацию по WB API?

Официальная документация, примеры запросов, описание методов и другая важная информация по WB API доступны на сайте dev.wildberries.ru. Здесь вы найдёте всё необходимое для быстрой интеграции и эффективного использования API.

5.2. Какие SDK и библиотеки доступны и где их взять?

На текущий момент официальных SDK и библиотек от Wildberries нет. Однако сообщество разработчиков активно создает неофициальные библиотеки на популярных языках (например, Python, PHP, JavaScript), которые можно найти на GitHub или через поиск в интернете. Перед использованием сторонних решений убедитесь в их актуальности и надежности.

5.3. Где посмотреть примеры интеграций и готовые кейсы?

Примеры интеграций и реальные кейсы размещены на dev.wildberries.ru в разделе «Кейсы». Здесь представлены наглядные сценарии и подробные инструкции по внедрению и настройке API для различных бизнес-задач.

5.4. Как обратиться в техническую поддержку: создание тикета, какие данные предоставить?

Для обращения в техническую поддержку:

  1. Войдите в личный кабинет продавца Wildberries.
  2. Перейдите в раздел «Техническая поддержка».
  3. Создайте новый тикет, указав:
  • Описание проблемы;
  • Примеры запросов и ответов API (желательно в формате JSON);
  • Дату и время возникновения проблемы;
  • Используемые endpoint’ы и токены;
  • Скриншоты или другие материалы, помогающие понять проблему.

Чем подробнее описание, тем быстрее будет оказана помощь.

5.5. Проводите ли вы вебинары по работе с WB API?

Информацию о мероприятиях и записи предыдущих вебинаров можно найти в разделе «Мероприятия» на dev.wildberries.ru.

6. Инструменты WB API и дополнительные ресурсы

6.1. Что такое гайды и какие задачи они помогают решить?

Гайды — это подробные пошаговые инструкции, которые помогают быстро освоить новые функции и избежать распространённых ошибок, а также решить конкретные задачи при работе с WB API. Например:

  • настройка интеграции с ERP-системами (1С);
  • создание и обновление карточек товаров;
  • автоматизация обработки заказов.

Список инструкций по разделам документации:

📖 Ссылки на инструкции также указаны в документации WB API — в блоках с иконкой книги

6.2. Что такое Личный кабинет разработчика и зачем он нужен?

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

6.3. Что такое Сообщество WB API?

Сообщество — это площадка для общения и обмена опытом среди разработчиков и продавцов, использующих WB API. Здесь вы можете задать вопросы, получить советы от экспертов, узнать об актуальных проблемах и решениях от сообщества.

Читайте подробнее о сообществе в отдельной статье.

6.4. Что такое Статус API и как им пользоваться?

Статус API — это инструмент мониторинга статуса работы сервисов и состояния WB API. Он позволяет оперативно проверить:

  • текущий статус доступности API и сервисов;
  • наличие технических проблем и время их устранения;
  • плановые технические работы.

Вы можете воспользоваться Статусом API по ссылке.

6.5. Что такое JWT и как декодировать токен?

Токены WB API создаются по стандарту JWT (JSON Web Token) — это международный стандарт для безопасной передачи информации. Внутри токена зашифрована информация о его типе, сроке действия, правах доступа и других параметрах.

Декодирование токена — процесс извлечения информации из токена для проверки его параметров. 

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

Декодировать токен WB API можно по ссылке.

6.7. Что такое тестовый контур и для чего он нужен?

Тестовый контур (sandbox) — это отдельная тестовая среда, которая позволяет проверять работу вашего приложения или интеграции с WB API без риска воздействия на реальные данные вашего бизнеса. Он используется для отладки и тестирования функционала перед запуском на боевой среде.

6.8. Как работать с тестовым контуром?

Для работы с тестовым контуром:

  • Создайте отдельный токен для тестового контура в личном кабинете;
  • Используйте специальные тестовые endpoint’ы (указаны в документации API);
  • Отличия от боевого окружения включают фиктивные данные и возможность без риска проводить операции, такие как создание заказов или изменение цен.

Примеры запросов и endpoint’ов можно найти в официальной документации WB API на dev.wildberries.ru

6.9. Какие ограничения действуют на тестовом контуре?

На тестовом контуре действуют следующие ограничения:

  • Лимиты на количество запросов в единицу времени;
  • Использование только фиктивных (нереальных) данных, чтобы исключить возможность реального взаимодействия с вашими клиентами или данными магазина;
  • Отсутствие возможности осуществлять реальные финансовые или товарные операции.