API Wildberries для продавца: какие данные даёт токен и как его создать

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

Зачем продавцу токен API Wildberries

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

На практике токен нужен для трёх задач: подключить внешнюю аналитику (включая бесплатный сервис wbtop.ru, который забирает продажи, остатки и финансы напрямую по API и строит отчёты без ручной выгрузки), выгружать данные в 1С или Excel по расписанию, и автоматизировать управление ценами и рекламой через сторонние скрипты.

Категории доступа: что выбрать при создании токена

При создании токена в личном кабинете WB продавец отмечает категории доступа — это фактически белый список разделов API, к которым будет обращаться конкретный ключ. Каждая категория соответствует своей группе методов и своему поддомену API.

Правило простое: выдавайте токену только те категории, которые реально нужны сервису. Если внешний инструмент только считает аналитику, категорий «Статистика» и «Финансы» достаточно — открывать «Цены» или «Маркетплейс» ему незачем.

Как создать API-токен Wildberries: пошаговая инструкция

1. Зайти в личный кабинет продавца на seller.wildberries.ru под учётной записью с правами администратора.
2. Открыть раздел «Настройки» → «Доступ к API».
3. Нажать «Создать новый токен» и указать название — например, «Аналитика wbtop» или «1С-обмен», чтобы через полгода не гадать, зачем он нужен.
4. Отметить нужные категории доступа из списка выше.
5. При необходимости включить режим «только чтение» — для аналитики этого достаточно, ключ на запись не даёт лишний риск.
6. Скопировать токен сразу после создания: WB показывает его один раз, повторно посмотреть значение нельзя, только перевыпустить.

Токен — длинная строка, которая уже содержит зашифрованную информацию о продавце и разрешённых категориях, поэтому его не нужно нигде дополнительно регистрировать — просто вставить в заголовок Authorization при запросе.

Что даёт statistics-api: продажи, заказы, остатки, финансы

Statistics-api — самая востребованная часть API Wildberries для аналитики, потому что именно она отдаёт цифры, из которых складывается управленческая и налоговая отчётность.

У большинства методов statistics-api жёсткий лимит запросов — как правило, не чаще одного обращения в минуту к одному и тому же методу с одного токена. При превышении WB отвечает ошибкой, а при систематическом нарушении может временно заблокировать токен, поэтому дёргать API «в лоб» каждую секунду не стоит — данные всё равно обновляются не мгновенно.

Именно отчёт о реализации закрывает главный практический вопрос продавца: сколько денег реально пришло за период. Это число нужно не только для управленческого учёта, но и для налоговых порогов.

Как данные API помогают не пропустить налоговые пороги

На УСН действует правило: если доход за календарный год превышает 60 млн ₽, продавец обязан платить НДС — 5% при доходе до 250 млн ₽ в год или 7% при доходе от 250 до 450 млн ₽ (обе ставки — без права на вычет входного НДС), либо перейти на общую ставку 20% (10% по льготным товарам) с правом вычета. Обязанность возникает с 1-го числа месяца, следующего за месяцем, в котором накопленный доход перешагнул порог.

Пример: продавец на УСН «доходы» получил через отчёт о реализации по API суммарную выручку 63 млн ₽ за год. Порог 60 млн ₽ пройден в октябре — значит с ноября вся выручка облагается НДС по ставке 5% (если продавец не выбрал общую ставку с вычетами). При обороте 5 млн ₽ в месяц это дополнительные 250 000 ₽ налога, которых не было бы при обороте до 60 млн ₽.

Второй порог касается фиксированных взносов ИП: 1% дополнительно уплачивается с дохода, превышающего 300 000 ₽ в год. Если по данным API годовой доход составил 5 200 000 ₽, дополнительный взнос считается так: (5 200 000 − 300 000) × 1% = 49 000 ₽ сверх фиксированной части.

Оба расчёта требуют точной суммы дохода нарастающим итогом, а её проще всего брать не из личного кабинета вручную, а из выгрузки по API — так исключается ошибка из-за ручного суммирования по неделям. Именно эту сверку — доход, пороги по НДС и по взносу 1% — можно автоматически считать в бесплатном сервисе wbtop.ru, который подключается по тому же токену statistics-api и сам показывает, сколько осталось до следующего порога.

Тестовый токен и безопасность боевого ключа

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

• Не хранить токен в открытом виде в чатах, таблицах общего доступа или репозиториях — это равноценно передаче пароля от кабинета.
• Выдавать отдельный токен под каждый сервис, а не один на всё: если один ключ скомпрометирован, отзыв не остановит остальные интеграции.
• Раз в несколько месяцев перевыпускать токены, особенно если к ним имел доступ сотрудник, который уже не работает с кабинетом.
• Для внешней аналитики всегда ограничиваться категориями «Статистика» и «Финансы» в режиме чтения — этого достаточно для любых отчётов и расчётов, включая налоговые.

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