Зачем продавцам нужен API Wildberries
Если вы продаёте на Wildberries и хотите автоматизировать рутинные задачи — от загрузки товаров до управления заказами, API станет вашим главным инструментом. Без него придётся вручную обновлять цены, следить за остатками и обрабатывать сотни заказов в день. Это не только отнимает время, но и увеличивает риск ошибок: опоздания с отправкой, неверные данные в карточках, потерянные заказы.
API Wildberries позволяет интегрировать вашу систему учета (1С, МойСклад, Bitrix24) с площадкой. Вы сможете:
- массово загружать и обновлять товары;
- получать данные о заказах в реальном времени;
- управлять ценами и скидками автоматически;
- отслеживать логистику и статусы доставки;
- обрабатывать возвраты и претензии быстрее.
На практике это означает, что вы тратите меньше времени на администрирование и больше — на развитие бизнеса. Например, при росте ассортимента до 1000+ позиций ручная загрузка становится невозможной. API решает эту проблему.
Где найти и как получить доступ к API
Функционал API доступен только для официальных продавцов Wildberries. Если у вас ещё нет личного кабинета, сначала зарегистрируйтесь как поставщик на сайте платформы. После подтверждения аккаунта выполните следующие шаги:
📋 Получение доступа к API
API (в меню слева)Важный момент: токен — это ваш «ключ» к API. Его нельзя передавать третьим лицам или хранить в открытом доступе. Если токен скомпрометирован, немедленно отозовите его в настройках и сгенерируйте новый.
Типы токенов и их назначение
Wildberries выдаёт два типа токенов:
| Тип токена | Назначение | Срок действия |
|---|---|---|
| Постоянный | Для долговременной интеграции (1С, CRM, скрипты) | Действует до отзыва |
| Временный | Для тестирования или разовых задач | 30 дней |
Где взять документацию по API
Официальная документация содержит:
- список доступных методов (запросы к товарам, заказам, отчётам);
- описание параметров и форматов ответов;
- примеры запросов на разных языках (Python, PHP, JavaScript);
- ограничения по количеству запросов в минуту.
Найти её можно в личном кабинете в разделе API → Документация. Если раздел отсутствует, проверьте, подтверждён ли ваш статус продавца. Для новых аккаунтов доступ может открываться не сразу.
Пошаговая инструкция по подключению API
Вот что нужно сделать для первой интеграции:
-
Получите токен (как описано выше). Убедитесь, что у него есть права на нужные методы (например,
GET /api/v1/ordersдля работы с заказами). -
Выберите способ интеграции:
- Готовые модули для 1С, МойСклад, Bitrix24 (настройка занимает 1–2 дня).
- Самостоятельная разработка скриптов (требует знания программирования).
- Использование сервисов-посредников (например, API2Cart, Shopolog).
Протестируйте запросы. Начните с простых методов, например, получения списка товаров:
GET https://suppliers-api.wildberries.ru/api/v1/cards
Headers: { "Authorization": "Ваш_токен" }
Ответ должен вернуть JSON с данными ваших карточек.
Настройте автоматическое обновление. Например, раз в час отправляйте запрос на обновление остатков:
POST https://suppliers-api.wildberries.ru/api/v1/stocks
Body: { "stocks": [{ "sku": 12345, "amount": 10 }] }
Примеры популярных запросов
Ниже — базовые запросы, которые пригодятся большинству продавцов:
| Задача | Метод | Пример запроса |
|---|---|---|
| Получить список заказов | GET /api/v1/orders | https://suppliers-api.wildberries.ru/api/v1/orders?dateFrom=2026-01-01 |
| Обновить цену товара | POST /api/v1/prices | Body: { "prices": [{ "nmId": 12345, "price": 999 }] } |
| Получить отчёт по продажам | GET /api/v1/sales | https://suppliers-api.wildberries.ru/api/v1/sales?dateFrom=2026-01-01&dateTo=2026-01-31 |
Ограничения и подводные камни
Даже с API не всё так гладко. Вот на что стоит обратить внимание:
-
Лимиты на запросы. Wildberries ограничивает количество запросов в минуту (обычно 60 запросов/минуту). При превышении лимита сервер вернёт ошибку
429 Too Many Requests. Решение: распределяйте запросы во времени или используйте кэширование. -
Задержки обновлений. Данные в API не всегда синхронизируются с площадкой в реальном времени. Например, информация о заказах может обновляться с задержкой до 15 минут.
-
Ошибки валидации. Если вы отправляете некорректные данные (например, отрицательный остаток товара), API вернёт ошибку. Всегда проверяйте формат запросов.
-
Ограничения по товарам. Не все категории товаров поддерживают массовое обновление через API. Например, для некоторых групп (например, Аптечные товары) требуется ручная модерация.
Что делать, если API не работает
Проверьте:
- Актуальность токена (не истёк ли он?).
- Правильность URL (частая ошибка — опечатки в endpoints).
- Формат данных (JSON должен быть валидным).
- Лимиты запросов (возможно, вы превысили квоту).
Если проблема остаётся, обратитесь в поддержку Wildberries с логами ошибок.
Типичные ошибки при работе с API
Ошибки делятся на две группы: технические (неверные запросы) и логические (непонимание процессов). Вот самые распространённые:
-
Использование неверного токена. Если вы скопировали токен с пробелом или символом переноса, API вернёт
401 Unauthorized. Всегда проверяйте токен на наличие лишних символов. -
Неучтённые таймзоны. Wildberries работает по московскому времени (UTC+3). Если вы отправляете запрос с датой в другом формате, данные могут не совпасть. Например,
dateFrom=2026-01-01без указания времени приведёт к пропуску заказов. -
Игнорирование пагинации. API возвращает данные порциями (обычно по 100 записей). Если не использовать параметр
page, вы получите неполные данные. Пример правильного запроса:GET https://suppliers-api.wildberries.ru/api/v1/orders?page=1 -
Отсутствие обработки ошибок. Многие продавцы не проверяют статус ответа (например,
200 OKили500 Server Error). Это приводит к тому, что скрипт «молча» пропускает сбои, а вы узнаёте о проблеме слишком поздно.
☑️ Проверка перед отправкой запроса
Как API упрощает работу с Wildberries
Подключение API — это не просто техническая фича, а инструмент, который меняет подход к продажам. Вот что даёт автоматизация:
Вы экономите до 20–30 часов в месяц на рутинных операциях. Например, обновление цен на 500 товаров вручную займёт 2–3 дня, а через API — несколько минут. Это особенно критично в периоды распродаж, когда цены меняются ежедневно.
Кроме того, API снижает риск человеческих ошибок. Допустим, менеджер забыл обновить остатки, и клиент оплатил товар, которого нет на складе. Автоматическая синхронизация исключает такие ситуации. А ещё вы получаете данные для аналитики: какие товары продаются лучше, в какое время суток пик заказов, как часто происходят возвраты. Эти инсайты помогают оптимизировать ассортимент и рекламные кампании.
На практике продавцы, подключившие API, увеличивают оборот на 15–40% за счёт оперативности и точности данных. Главное — правильно настроить интеграцию и следить за обновлениями документации.