Запрос «wb ups v 2» чаще всего означает работу с разделом «Поставки» (supplies) в API Wildberries версии v2: создание поставки, добавление заказов и получение статусов через обновлённые методы. Если ваши скрипты или интеграция внезапно перестали получать данные о поставках, вероятная причина — использование устаревших методов, которые площадка постепенно выводит из эксплуатации, либо токен без нужных прав доступа.
В этой статье разберём, что представляет собой v2 раздела поставок, чем он отличается от прежних версий, как проверить авторизацию и в каком порядке безопасно перевести интеграцию на актуальные методы. Точные адреса эндпоинтов и лимиты запросов периодически меняются, поэтому перед внедрением сверяйтесь с официальной документацией для разработчиков Wildberries — ниже даны общие принципы, которые не зависят от конкретной версии метода.
Что такое раздел «Поставки» в API Wildberries
Раздел Supplies (поставки) в API маркетплейса отвечает за логистику FBO: создание поставки на склад, добавление в неё заказов, получение стикеров и отслеживание статуса приёмки. Через эти методы продавец автоматизирует то, что вручную делается в личном кабинете.
Версия v2 появилась как развитие исходного набора методов. Как правило, при смене версии у таких API меняется структура ответов, состав полей и правила пагинации, а старые методы некоторое время работают в режиме совместимости, после чего отключаются. Именно на этом этапе у продавцов и разработчиков возникает большинство проблем.
- 📦 Создание новой поставки и получение её идентификатора
- 🛒 Добавление заказов в открытую поставку
- 🏷️ Получение файла со стикерами для маркировки коробов
- 🚚 Отслеживание статуса поставки и закрытие отгрузки
Чем v2 отличается от прежних методов
Точный перечень изменений зависит от того, какую именно версию вы использовали раньше, поэтому универсального «списка отличий» не существует — его нужно смотреть в changelog официальной документации. Тем не менее типовые отличия при переходе на новую версию API обычно такие.
Во-первых, меняется структура ответа: поля могут переименовываться, вкладываться в объекты или разбиваться на несколько методов. Во-вторых, уточняются лимиты запросов — число обращений в минуту на один метод. В-третьих, ужесточаются требования к токену: новые методы могут требовать отдельной категории доступа.
Переход на v2 — это не просто смена URL: проверьте структуру ответа, лимиты и права токена, иначе интеграция будет отвечать ошибками даже при корректном запросе.
Проверка токена и прав доступа
Первое действие при любой ошибке API поставок — проверить API-ключ (токен). В личном кабинете продавца токены создаются с набором категорий доступа, и методы поставок требуют соответствующей категории. Если токен создан давно или с ограниченным набором прав, новые методы будут возвращать ошибку авторизации.
Порядок безопасной проверки:
- 🔑 Откройте раздел управления API-ключами в личном кабинете продавца и убедитесь, что токен активен
- 🗂️ Проверьте, что у токена включена категория, связанная с поставками и заказами
- 🧪 Выполните тестовый запрос к простому методу (например, списку поставок) и посмотрите код ответа
- 🔄 При сомнениях выпустите новый токен с нужными правами и обновите его в интеграции
⚠️ Внимание: токен API — это полный доступ к операциям вашего магазина. Не публикуйте его в коде на GitHub, не передавайте третьим лицам и не храните в открытом виде в таблицах. При малейшем подозрении на утечку немедленно перевыпустите ключ.
Типовые ошибки при работе с v2 и их причины
Большинство проблем при обращении к методам поставок сводится к нескольким классам ошибок. Ниже — ориентировочная таблица диагностики; точные тексты ошибок зависят от конкретного метода.
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| Ошибка авторизации (401/403) | Токен без нужной категории доступа или отозван | Права токена в личном кабинете, заголовок авторизации |
| Метод не найден (404) | Используется отключённая версия метода или опечатка в пути | Актуальный путь в документации, версию в URL |
| Превышение лимита (429) | Слишком частые запросы в цикле | Паузы между запросами, кэширование ответов |
| Пустой или неожиданный ответ | Изменилась структура полей в v2 | Формат JSON в документации, парсинг в коде |
| Заказ не добавляется в поставку | Заказ уже в другой поставке или сменил статус | Актуальный статус заказа отдельным запросом |
Порядок безопасной миграции на v2
Переводить рабочую интеграцию на новую версию стоит поэтапно, не отключая старый код до полной проверки. Ниже чек-лист, который подходит для большинства самописных скриптов и модулей.
☑️ Миграция интеграции поставок на v2
Отдельное внимание уделите обработке ошибок. В новой версии коды и тексты ошибок могут отличаться, и логика повторных попыток, написанная под старые ответы, перестанет срабатывать. Добавьте логирование сырых ответов сервера хотя бы на период миграции — это сильно упростит диагностику.
Храните идентификаторы поставок и заказов в своей базе с отметкой версии API, через которую они созданы. При расхождениях после миграции вы сможете быстро понять, какие записи затронуты.
Если интеграция — готовый модуль или сервис
Не все продавцы пишут код сами: многие используют готовые модули для 1С, CMS или сторонние аналитические сервисы. В этом случае миграция на v2 — задача разработчика модуля, а ваша проверка сводится к другому списку действий.
Убедитесь, что у вас установлена актуальная версия модуля: разработчики выпускают обновления при изменении API маркетплейса. Проверьте в личном кабинете сервиса, не требует ли он перевыпуска токена с новыми правами. Если модуль давно не обновлялся и его поддержка прекращена, это прямой риск остановки выгрузки поставок — стоит заранее рассмотреть альтернативу.
Как понять, что модуль использует устаревшие методы
Косвенные признаки: в логах модуля появились ошибки 404 или 403 при ранее рабочей конфигурации; поставки создаются в личном кабинете, но не отображаются в модуле; разработчик в changelog упоминает переход на новую версию API. Точный ответ даст только документация модуля или запрос его разработчику.
⚠️ Внимание: не пытайтесь «чинить» чужой закрытый модуль, подменяя адреса методов в его файлах. Такие правки слетают при первом обновлении и могут нарушить лицензионные условия. Корректный путь — обновление модуля или обращение к его разработчику.
Ограничения и когда нужна официальная документация
Всё описанное выше — общая логика работы с версиями API маркетплейса. Конкретные адреса эндпоинтов, состав полей, лимиты запросов в минуту и сроки отключения старых методов — переменные величины, которые Wildberries публикует в документации для разработчиков и в новостях API. Опираться нужно именно на эти источники, а не на статьи и форумы: информация в них устаревает быстро.
Если вы не разработчик, а продавец, и интеграция нужна для бизнеса, разумный вариант — привлечь специалиста, который уже делал подключения к API маркетплейсов. Ошибка в логике поставок может привести к реальным потерям: неотгруженным заказам и штрафам.
Универсальное правило: работоспособность интеграции с WB API проверяется тремя вещами — актуальный токен с нужными правами, актуальная версия методов, корректная обработка лимитов и ошибок.
Частые вопросы
Что означает «wb ups v 2» в запросе?
Чаще всего это сокращение от Wildberries API, раздел Supplies (поставки), версия 2 — набор методов для автоматизации создания и ведения поставок FBO. Если вы искали что-то другое (например, источник бесперебойного питания), уточните запрос.
Старые методы поставок ещё работают?
Это зависит от текущей политики площадки: устаревшие методы обычно некоторое время работают параллельно с новыми, затем отключаются. Актуальный статус конкретного метода смотрите в официальной документации API — там публикуются пометки об устаревании и даты отключения.
Какой токен нужен для методов поставок?
Нужен API-ключ, при создании которого включена категория доступа, связанная с поставками и заказами. Точное название категории проверьте в интерфейсе создания ключа в личном кабинете — набор категорий периодически пересматривается.
Почему запросы к v2 возвращают ошибку 429?
Это превышение лимита запросов: метод вызывается чаще, чем разрешено. Добавьте паузы между обращениями, уберите запросы из тесных циклов и кэшируйте ответы, которые не меняются каждую минуту. Конкретные значения лимитов указаны в документации к каждому методу.
Можно ли перевести на v2 готовый модуль для 1С самостоятельно?
Если модуль закрытый — нет, переход на новую версию API выполняет его разработчик через обновление. Ваша задача — следить за обновлениями модуля и вовремя перевыпускать токен, если сервис этого требует.