Запрос «wb ups v 2» чаще всего означает работу с разделом «Поставки» (supplies) в API Wildberries версии v2: создание поставки, добавление заказов и получение статусов через обновлённые методы. Если ваши скрипты или интеграция внезапно перестали получать данные о поставках, вероятная причина — использование устаревших методов, которые площадка постепенно выводит из эксплуатации, либо токен без нужных прав доступа.

В этой статье разберём, что представляет собой v2 раздела поставок, чем он отличается от прежних версий, как проверить авторизацию и в каком порядке безопасно перевести интеграцию на актуальные методы. Точные адреса эндпоинтов и лимиты запросов периодически меняются, поэтому перед внедрением сверяйтесь с официальной документацией для разработчиков Wildberries — ниже даны общие принципы, которые не зависят от конкретной версии метода.

Что такое раздел «Поставки» в API Wildberries

Раздел Supplies (поставки) в API маркетплейса отвечает за логистику FBO: создание поставки на склад, добавление в неё заказов, получение стикеров и отслеживание статуса приёмки. Через эти методы продавец автоматизирует то, что вручную делается в личном кабинете.

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

  • 📦 Создание новой поставки и получение её идентификатора
  • 🛒 Добавление заказов в открытую поставку
  • 🏷️ Получение файла со стикерами для маркировки коробов
  • 🚚 Отслеживание статуса поставки и закрытие отгрузки

Чем v2 отличается от прежних методов

Точный перечень изменений зависит от того, какую именно версию вы использовали раньше, поэтому универсального «списка отличий» не существует — его нужно смотреть в changelog официальной документации. Тем не менее типовые отличия при переходе на новую версию API обычно такие.

Во-первых, меняется структура ответа: поля могут переименовываться, вкладываться в объекты или разбиваться на несколько методов. Во-вторых, уточняются лимиты запросов — число обращений в минуту на один метод. В-третьих, ужесточаются требования к токену: новые методы могут требовать отдельной категории доступа.

💡

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