Новый API Wildberries: что это и как получить к нему доступ

Если вы продавец на Wildberries и хотите автоматизировать работу с заказами, остатками или статистикой, без доступа к API платформы не обойтись. Новый API Wildberries — это обновлённый инструмент для интеграции вашего бизнеса с маркетплейсом, который позволяет в реальном времени управлять товарами, получать данные о продажах и синхронизировать информацию с вашей CRM или 1С. Но что именно изменилось в новой версии, как её подключить и какие подводные камни ждут новичков?

Старый API Wildberries (так называемый «API v1») уходит в прошлое — платформа активно переводит продавцов на обновлённую версию с расширенными возможностями и строгими правилами безопасности. Без перехода на новый API вы рискуете потерять доступ к автоматизации, а это значит — ручная обработка заказов, ошибки в остатках и задержки в логистике. В этой статье разберём, как получить доступ к новому API Wildberries с нуля, какие документы потребуются и как избежать типичных ошибок при настройке.

Что такое новый API Wildberries и зачем он нужен

API (Application Programming Interface) — это «мост» между вашей системой управления (например, 1С, CRM или самописным софтом) и платформой Wildberries. Через него вы можете:

• автоматически обновлять остатки товаров на складах;
• получать данные о новых заказах и статусах их обработки;
• управлять ценами, скидками и акциями;
• отслеживать возвраты, брак и финансовые операции;
• интегрировать аналитику продаж с внешними сервисами.

Новая версия API Wildberries отличается от старой:

Важный момент: Wildberries постепенно отключает поддержку старого API. Это означает, что если вы не перейдёте на новую версию, ваши интеграции перестанут работать. Например, с 1 января 2026 года старый API будет полностью заблокирован для новых подключений, а существующие интеграции начнут выдавать ошибки.

Кому обязательно нужен доступ к API

Без API можно обойтись, если вы:

• продаёте меньше 50 заказов в день;
• управляете ассортиментом вручную (до 100 SKU);
• не используете внешние системы аналитики.

Но API становится необходимостью, если:

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

Где и как получить доступ к новому API

Чтобы подключиться к новому API Wildberries, нужно пройти несколько обязательных шагов. Начните с проверки статуса вашего аккаунта:

Пошаговая инструкция по получению доступа

Вот что нужно сделать:

1. Авторизуйтесь в личном кабинете Wildberries по адресу seller.wildberries.ru и перейдите в раздел API и интеграции (находится в меню Настройки → Интеграции).
2. Создайте новое приложение:
   • Нажмите кнопку Добавить интеграцию.
   • Выберите тип интеграции: API для продавцов.
   • Заполните название приложения (например, «Интеграция с 1С»).
3. Заполните данные для проверки:
   • Укажите ИНН и ОГРН (для юрлиц) или данные паспорта (для ИП).
   • Прикрепите скан документа, подтверждающего право подписи (например, приказ о назначении директора или доверенность).
4. Подтвердите запрос:
   • Wildberries проверяет документы в течение 3–5 рабочих дней.
   • После одобрения вам придёт уведомление на email с ссылкой для генерации токена.
5. Сгенерируйте токен доступа:
   • В разделе API и интеграции нажмите Создать токен.
   • Скопируйте client_id и client_secret — они понадобятся для аутентификации.
   • Установите ограничения по IP (рекомендуется указать статический IP вашего сервера).

На практике самый долгий этап — это модерация документов. Если вы ИП, проверка может пройти быстрее (1–2 дня), а для ООО сроки часто затягиваются до недели. Не отправляйте запрос в пятницу — техническая поддержка не работает в выходные, и модерация начнётся только в понедельник.

Где найти документацию и примеры кода

Официальная документация нового API Wildberries размещена на GitHub:

• Описание методов: https://github.com/wildberries/api-docs (раздел wb-seller-api).
• Примеры запросов на Python, PHP и JavaScript.
• Список доступных эндпоинтов (например, для работы с заказами, остатками, отчётами).

Важный момент: документация обновляется раз в 1–2 месяца. Всегда сверяйтесь с последней версией, так как Wildberries может менять структуру ответов или добавлять новые обязательные параметры.

Пример запроса для получения списка заказов

Скрытый текст:

```python

import requests

url = "https://suppliers-api.wildberries.ru/api/v2/orders"

headers = {

"Authorization": "Bearer YOUR_ACCESS_TOKEN",

"Content-Type": "application/json"

}

params = {

"dateFrom": "2026-01-01",

"flag": 0 # 0 — новые заказы, 1 — архивные

}

response = requests.get(url, headers=headers, params=params)

print(response.json())

```

Замените `YOUR_ACCESS_TOKEN` на сгенерированный токен.

Нюансы и подводные камни при работе с API

Даже после успешного подключения к API вы можете столкнуться с проблемами. Вот самые распространённые:

Ограничения и лимиты

Wildberries устанавливает жёсткие лимиты на количество запросов:

Если вы превысите лимит, API вернёт ошибку 429 Too Many Requests. Чтобы этого избежать:

• используйте кэширование данных;
• настраивайте паузы между запросами (например, 6 секунд для стандартного аккаунта);
• объединяйте несколько операций в один запрос (где это возможно).

Проблемы с аутентификацией

Чаще всего ошибки связаны с:

• Неправильным токеном: убедитесь, что вы используете актуальный access_token (он действует 1 час, затем нужно обновлять).
• Ограничениями по IP: если вы указали в настройках IP-адрес, а запрос идёт с другого — API вернёт ошибку 403 Forbidden.
• Несоответствием заголовков: проверьте, что в запросе передаётся Content-Type: application/json.

Типичные ошибки при подключении и работе с API

Даже опытные разработчики сталкиваются с ошибками при интеграции с API Wildberries. Вот самые частые:

• Ошибка 401 Unauthorized: означает, что токен просрочен или неверный. Решение: обновите токен через раздел API и интеграции или проверьте правильность client_id и client_secret.
• Ошибка 400 Bad Request: обычно возникает из-за неверного формата данных. Например, вы отправили цену в формате "price": "1000" вместо "price": 1000 (без кавычек для числовых значений). Решение: сверьтесь с документацией по структуре JSON.
• Ошибка 500 Internal Server Error: проблема на стороне Wildberries. Решение: повторите запрос через 5–10 минут или обратитесь в поддержку с логами ошибки.
• Не обновляются остатки: проверьте, что вы отправляете данные на правильный склад (параметр warehouseId). Также убедитесь, что товар не заблокирован модератором Wildberries.

Ещё одна распространённая проблема — расхождение данных между API и личным кабинетом. Например, в API показано 10 заказов, а в личном кабинете — 12. Это связано с задержкой синхронизации (до 15 минут). Чтобы избежать путаницы, настройте в своей системе обновление данных раз в час, а не в реальном времени.

Как максимально эффективно использовать новый API

Доступ к API — это только первый шаг. Чтобы действительно оптимизировать работу, воспользуйтесь этими рекомендациями:

Автоматизируйте рутинные задачи:

• Настройте автоматическое обновление остатков 2–3 раза в день (например, в 9:00, 14:00 и 19:00).
• Интегрируйте API с вашей CRM, чтобы новые заказы сразу попадали в систему без ручного ввода.
• Используйте вебхуки (webhooks) для уведомлений о изменениях статусов заказов (например, когда товар отгружен со склада).

Анализируйте данные в реальном времени:

• Подключите API к Power BI или Google Data Studio для визуализации продаж.
• Настройте алерты на резкое падение продаж или рост возвратов.
• Сравнивайте динамику цен конкурентов (через метод /api/v2/prices) и автоматически корректируйте свои цены.

Важный момент: не храните токены доступа в открытом виде. Используйте переменные окружения или защищённые хранилища (например, AWS Secrets Manager). Если токен попадёт в руки мошенников, они смогут управлять вашими заказами и остатками.

Что делать, если доступ к API заблокирован

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

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

Если доступ заблокирован:

1. Проверьте email, связанный с аккаунтом Wildberries — обычно приходит письмо с причиной блокировки.
2. Обратитесь в поддержку через раздел Помощь → Техническая поддержка и укажите:
   • ID вашего приложения в API;
   • время, когда произошла блокировка;
   • описание действий, которые вы выполняли перед блокировкой.

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

Срок разблокировки зависит от причины: от нескольких часов (если это технический сбой) до 3–5 дней (если требуется повторная проверка документов).