API Wildberries из личного кабинета

Для подключения склада Wildberries используется токен API, который создаётся в личном кабинете продавца.

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

Как создать токен

В личном кабинете Wildberries перейдите в раздел Настройки → Доступ к API → «Создать токен».

1. В способе создания интеграции выберите «Вручную».
2. Выберите тип «Базовый токен».
3. Укажите любое удобное название токена.
4. Выберите необходимые категории доступа из списка ниже.
5. Установите уровень доступа «Только чтение».
6. Нажмите «Создать токен».
7. Скопируйте созданный токен и вставьте его в соответствующее поле Veloseller.

Для Veloseller необходимо использовать токен с уровнем доступа «Только чтение».

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

Какие категории выбрать

Набор категорий зависит от типа склада.

Для собственного склада (FBS) выберите:

• Контент
• Маркетплейс
• Цены и скидки

Cклады Wildberries (FBO) не поддерживаются.

Для чего нужны категории

• Контент — используется для получения информации о товарах: названий, артикулов, брендов, категорий и других данных карточек.
• Маркетплейс — используется для получения остатков на собственных складах продавца. Необходим для FBS.
• Аналитика — используется для получения данных об остатках на складах Wildberries. Необходим для FBO.
• Цены и скидки — используется для получения цен товаров. Эти данные необходимы для расчёта денежных показателей, включая стоимость излишков и упущенную выручку.
• Тарифы — дополнительная категория для получения данных о комиссии площадки.

Категорию «Статистика» при создании нового токена выбирать не требуется.

Ранее эта категория использовалась для получения части данных об остатках. Если существующий токен с категорией «Статистика» продолжает работать, создавать новый токен только по этой причине не требуется.

Частые ошибки

Ошибка 401 при получении карточек товаров.

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

Ошибка 403 при получении остатков.

Токен может быть действующим, но не иметь необходимой категории доступа. Проверьте, какие категории требуются для вашего типа склада. Поскольку категории существующего токена изменить нельзя, при необходимости создайте новый токен с правильным набором разрешений.

Veloseller различает ошибки токена и недостаточных прав доступа. Информация о выявленной проблеме отображается на странице «Склады» под названием соответствующего склада.

У части товаров отсутствуют цены.

Наиболее вероятная причина — отсутствие у токена категории «Цены и скидки». В этом случае данные об остатках могут загружаться, но денежные показатели будут рассчитываться по неполным данным. Veloseller показывает количество товаров, для которых не удалось получить цену.

Слишком много запросов.

Wildberries ограничивает частоту обращений к отдельным методам API. Veloseller учитывает эти ограничения и автоматически выполняет повторные запросы. Дополнительные действия со стороны пользователя обычно не требуются.