API Wildberries для склада: как подключить кабинет за 15 минут

1Что даёт подключение по API

Если коротко: кабинет WB перестаёт быть «сайтом, куда кто-то ходит руками» и становится частью вашей складской системы. Вот что автоматизируется в первую очередь:

2Выпускаем токен: какие права нужны складу

В кабинете WB: Профиль → Настройки → Доступ к API → Создать токен. WB предлагает выбрать категории доступа. Для складской работы по FBS нужны:

• Маркетплейс — заказы FBS, поставки, стикеры, статусы. Это основа;
• Статистика — отчёты о продажах и складах (для сверок и аналитики);
• Контент — карточки товаров: названия, баркоды, артикулы. Нужен для импорта каталога;
• Цены и скидки — если планируете управлять ценами из системы.

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

3Проверяем подключение

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

1. Каталог подтянулся — в системе появились карточки с артикулами, баркодами и названиями из WB;
2. Заказы пришли — новые FBS-заказы видны в очереди сборки с деталями (артикул, баркод, дедлайн слота);
3. Остатки ушли — тестовое изменение остатка в системе отразилось в кабинете WB (обычно в течение 5–15 минут);
4. Стикер скачался — по тестовому заказу получена этикетка WB без захода в кабинет.

Если все четыре пункта зелёные — подключение рабочее, склад может переходить на работу в системе, а не в кабинете.

4Лимиты WB и типовые грабли

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

1. 429 Too Many Requests. Опрос «в лоб» каждую секунду быстро упирается в лимит. Правильно: очередь запросов, паузы, повтор с экспоненциальной задержкой. Хорошая система делает это сама, вы лимитов не замечаете;
2. Дубли заказов. Если синхронизация написана без защиты от повторов, один заказ приедет дважды — и уедет двумя этикетками. Дедупликация по ID заказа обязательна;
3. Отменённые заказы. Покупатель отменил, а склад уже собрал. Система должна убирать отменённые из очереди и из поставок автоматически;
4. Остатки «в одну сторону». Система отправила остатки, но не проверила, что WB их принял. Через неделю — расхождения и oversell. Нужна сверка «отправлено/принято»;
5. Несколько кабинетов. У продавца два-три кабинета WB с одинаковым товаром — остатки и заказы должны жить по каждому кабинету отдельно, иначе пересорт гарантирован.

Частые вопросы

Нужен ли программист, чтобы подключить API? Если подключаете готовую систему (нашу или другую WMS) — нет: вставили токен, нажали «синхронизировать». Программист нужен, только если пишете интеграцию с нуля.

API платный? Нет, API WB бесплатен. Платить придётся только за складскую систему, если она платная.

Работает ли API для FBO? Частично: по FBO доступны поставки на склад WB, остатки и статистика. Но заказы покупателей по FBO собирает сам WB — там автоматизировать нечего.

А Ozon? У Ozon свой API (Client-Id + Api-Key), логика та же: заказы, этикетки, остатки, статусы. Наша система работает с обоими маркетплейсами одновременно.