API Wildberries: как подключиться и использовать для автоматизации продаж

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

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

Важный момент: Wildberries регулярно обновляет API, поэтому перед работой всегда проверяйте актуальность методов в официальной документации. Некоторые endpoints могут менять структуру ответов или ограничения по количеству запросов.

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

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

Официальные источники документации

Wildberries публикует описание API в трёх местах:

• Публичная документация — базовые методы для работы с заказами, товарами и отчётами. Доступна без авторизации, но содержит не все детали (например, нет примеров для некоторых endpoints).
• Личный кабинет продавца — раздел API → Документация. Здесь описаны методы, доступные именно вашему тарифу, а также приведены примеры запросов с учётными данными.
• Техническая поддержка — если в документации нет ответа, можно написать в чат WB Partner. Отвечают обычно в течение 1-2 дней, но для сложных вопросов может потребоваться больше времени.

На практике большинству продавцов хватает документации из личного кабинета. Там же есть песочница (sandbox) для тестирования запросов без риска нарушить работу основного аккаунта.

Регистрация приложения и получение ключей

Чтобы отправлять запросы, нужно создать приложение в личном кабинете Wildberries. Вот что нужно сделать:

Важный нюанс: ключи выдаются один раз. Если вы их потеряете, придётся создавать новое приложение. Храните их в защищённом месте (например, в менеджере паролей) и не передавайте третьим лицам.

После регистрации приложения нужно получить токен доступа. Для этого отправьте POST-запрос на:

https://suppliers-api.wildberries.ru/api/v3/oauth/token

С параметрами:

• grant_type: client_credentials
• client_id: ваш Client ID
• client_secret: ваш Client Secret

В ответ придёт JSON с полем access_token — его нужно передавать в заголовке каждого запроса:

Authorization: Bearer ваш_access_token

Пошаговая инструкция: первые запросы к API

Когда ключи получены, можно приступать к работе. Начнём с простого: получим список заказов. Этот метод пригодится для автоматизации обработки продаж.

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

Используем endpoint для списка заказов:

GET https://suppliers-api.wildberries.ru/api/v3/orders

Параметры (обязательные):

• dateFrom — дата начала периода в формате YYYY-MM-DD.
• flag — статус заказов (например, 0 для новых, 1 для в обработке).

Пример запроса на Python (с использованием библиотеки requests):

import requests

url = "https://suppliers-api.wildberries.ru/api/v3/orders"
headers = {
"Authorization": "Bearer ваш_access_token"
}
params = {
"dateFrom": "2026-01-01",
"flag": "0"
}

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

В ответ придёт массив заказов с полями: orderId, date, lastChangeDate, supplierArticle и другие. Полный список полей смотрите в документации.

Обработка ошибок и лимиты запросов

API Wildberries возвращает стандартные HTTP-коды:

Важный момент: лимит запросов — 1000 в час для большинства методов. Если превысите, получите ошибку 429. Чтобы избежать блокировки:

• Кэшируйте ответы (например, список товаров обновляйте раз в сутки).
• Используйте паузы между запросами (например, 1 запрос в секунду).
• Объединяйте данные в одном запросе (где это возможно).

Основные методы API: что можно автоматизировать

API Wildberries покрывает большинство бизнес-процессов: от управления товарами до работы с отчётами. Разберём ключевые направления.

Работа с товарами и остатками

Чаще всего продавцы автоматизируют:

• Обновление цен — метод PUT /api/v3/prices. Позволяет массово изменять цены по артикулам.
• Синхронизация остатков — POST /api/v3/stocks. Актуально для продавцов с несколькими складами.
• Загрузка карточек товаров — POST /api/v3/cards/upload. Можно создавать или обновлять товары пакетом (до 1000 штук за запрос).

Пример обновления остатков:

url = "https://suppliers-api.wildberries.ru/api/v3/stocks"
data = {
"stocks": [
{
"warehouseId": 12345,  # ID вашего склада
"sku": "ART0001",      # Артикул товара
"amount": 10           # Новое количество
}
]
}
response = requests.post(url, headers=headers, json=data)

Важно: при обновлении остатков учитывайте время обработки. Wildberries может задерживать отображение изменений до 30 минут.

Управление заказами и логистикой

Для работы с заказами используйте:

• GET /api/v3/orders — список заказов (как в примере выше).
• POST /api/v3/orders/stickers — генерация наклеек для маркировки.
• POST /api/v3/orders/status — изменение статуса заказа (например, «Отправлен»).

Пример изменения статуса заказа на «Отправлен»:

url = "https://suppliers-api.wildberries.ru/api/v3/orders/status"
data = {
"orders": [
{
"orderId": "123456789",  # ID заказа
"status": "Shipped"      # Новый статус
}
]
}
response = requests.post(url, headers=headers, json=data)

На практике этот метод часто интегрируют с системами учёта (1С, МойСклад), чтобы статусы обновлялись автоматически при формировании накладной.

{
"orders": [{
"orderId": "123456789",
"status": "Shipped",
"trackNumber": "RB123456789RU",
"shipmentDate": "2026-05-20"
}]
}

Типичные ошибки и как их избежать

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

• Игнорирование лимитов. Превышение 1000 запросов в час ведёт к блокировке на 10 минут. Решение: используйте очередь запросов или увеличивайте интервал между ними.
• Неправильный формат данных. Например, передача цены в формате "1000 руб." вместо 1000. Решение: всегда проверяйте примеры в документации.
• Работа с устаревшими методами. Wildberries периодически удаляет или изменяет endpoints. Решение: подпишитесь на рассылку обновлений API в личном кабинете.
• Отсутствие обработки ошибок. Если не проверять статус ответа, можно пропустить сбой (например, истёкший токен). Решение: добавляйте проверку response.status_code.

Ещё одна частая проблема — несовпадение артикулов. Если в запросе передать supplierArticle, которого нет в системе, API вернёт успешный ответ (200), но изменения не применятся. Всегда сверяйте артикулы с данными из отчёта GET /api/v3/goods/nomenclature.

Как интегрировать API с вашими системами

Самостоятельная работа с API подходит для небольших задач, но для полной автоматизации лучше интегрировать его с вашим софтом. Рассмотрим два популярных варианта.

Интеграция с 1С или МойСклад

Если вы используете 1С, есть два пути:

1. Готовые обработки. На Инфостарте или GitHub можно найти бесплатные и платные решения для синхронизации с Wildberries. Например, обработка «WBConnector» поддерживает загрузку заказов и обновление остатков.
2. Собственная разработка. Если нужна кастомизация, напишите HTTP-запросы на встроенном языке 1С. Пример кода для получения заказов:

   Запрос = Новый HTTPЗапрос("https://suppliers-api.wildberries.ru/api/v3/orders");
   Запрос.УстановитьЗаголовок("Authorization", "Bearer " + Токен);
   Запрос.Параметры.Добавить("dateFrom", "2026-01-01");
   Ответ = Запрос.Выполнить();

Для МойСклад есть официальный коннектор от Wildberries (доступен в разделе Интеграции личного кабинета). Он поддерживает:

• Автоматическую выгрузку заказов.
• Синхронизацию остатков.
• Обновление статусов отправки.

Автоматизация через Google Sheets или Excel

Если вам не нужна сложная система, можно использовать Google Apps Script для работы с API прямо из таблиц. Например, так можно выгружать заказы в Google Sheets:

1. Создайте новый проект в Google Apps Script.
2. Вставьте код для авторизации и запроса данных (аналогично примеру на Python).
3. Настройте триггер для автоматического обновления (например, раз в час).

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

function getWBOrders() {
var token = getWBAccessToken(); // Функция для получения токена
var url = "https://suppliers-api.wildberries.ru/api/v3/orders?dateFrom=2026-01-01";
var options = {
"headers": {"Authorization": "Bearer " + token}
};
var response = UrlFetchApp.fetch(url, options);
var data = JSON.parse(response.getContentText());
Logger.log(data);
}

Такой подход подходит для небольших объёмов данных. Для обработки тысяч заказов лучше использовать базы данных (PostgreSQL, MySQL) или специализированные сервисы вроде Zapier.

Что дальше: как масштабировать автоматизацию

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

• Аналитику продаж. Выгружайте данные о заказах в Power BI или Google Data Studio, чтобы строить дашборды по выручке, возвратам и динамике продаж.
• Управление репутацией. Используйте метод GET /api/v3/feedback для сбора отзывов и автоматического ответа на негатив (через чат-ботов).
• Динамическое ценообразование. Настройте скрипт, который будет корректировать цены в зависимости от остатков конкурентов (данные можно брать через парсинг или сервисы вроде WBParser).

Если ваш бизнес растёт, рассмотрите возможность перехода на WB Seller API — расширенную версию для крупных продавцов. Она предлагает:

• Большие лимиты запросов (до 5000 в час).
• Дополнительные методы для работы с рекламой и промо-акциями.
• Приоритетную поддержку.

Для доступа к Seller API нужно подать заявку в поддержку Wildberries и подтвердить оборот (обычно требуется от 500 заказов в месяц).