Программный обмен с Wildberries и Ozon: с чего начать селлеру и агентству

Селлер из Казани держит 300 карточек на двух площадках. Каждое утро он открывает свою складскую таблицу, потом кабинет Wildberries, потом кабинет Ozon и руками переносит новые остатки. На 310-й позиции он ошибается на одну цифру: ставит 12 вместо 2. Днём приходят 10 заказов на товар, которого нет. Отмены, снятие с продажи, просевший рейтинг карточки. Всё это чинит одна вещь, которую он пока обходит стороной, потому что звучит страшно, программный обмен данными с площадкой.

Разбираем без страшных слов: что это такое, чем отличается доступ у Wildberries и у Ozon, какие данные можно передавать автоматически, какие лимиты нельзя превышать и где новичок чаще всего ломает связку в первую неделю. Материал рассчитан на селлера, который перерос ручной ввод, и на начинающего интегратора или агентство, которое хочет собирать такие связки клиентам.

Что такое программный обмен простыми словами

Когда две программы обмениваются данными напрямую, без человека, который переносит цифры из одного окна в другое, это и есть программный обмен. В мире разработки его называют тремя буквами, которые читаются как «эй-пи-ай» и расшифровываются как «интерфейс программирования приложений». Дальше в тексте будем говорить проще: программный интерфейс площадки, или канал обмена.

Смысл такой. У Wildberries и Ozon есть набор готовых команд: «дай мне список заказов за сегодня», «поставь остаток 5 штук по этому товару», «покажи, сколько денег к выплате». Ваша программа (складская таблица, учётная система, самописный скрипт) отправляет такую команду, площадка её выполняет и присылает ответ. Человек в этой цепочке не нужен. Именно поэтому остаток обновляется за секунду, а не за десять минут утреннего переноса руками.

Важно сразу развести две схемы работы, потому что от них зависит, какие команды вам вообще понадобятся:

  • FBS (по-английски Fulfillment by Seller, «сборка силами продавца») — товар лежит на вашем складе или у вашего фулфилмента, заказ вы собираете сами и передаёте в доставку площадки. Здесь программный обмен нужен постоянно: остатки, новые заказы, статусы сборки.
  • FBO (Fulfillment by Operator, «сборка силами площадки») — товар лежит на складе маркетплейса, он сам собирает и отправляет. Wildberries свою складскую схему называет FBW (склад Wildberries). Здесь обмен нужен реже, но поставки, цены и отчёты всё равно удобнее вести автоматически.

Ключ доступа: где взять у Wildberries и где у Ozon

Чтобы ваша программа могла отдавать команды, площадка должна её узнавать. Для этого выдаётся ключ доступа. Логин и пароль от кабинета сюда не передаются, вместо них работает отдельная длинная строка.

Wildberries. Ключ здесь называют токеном (длинная строка-пропуск, которую площадка выдаёт вашей программе вместо логина). Создаётся он в кабинете продавца: раздел «Настройки», затем пункт про доступ для внешних программ (в кабинете он подписан латиницей, тремя буквами, которые читаются как «эй-пи-ай»). Вы задаёте имя токена, отмечаете, к каким разделам данных он открывает доступ, и решаете, будет он только читать данные или ещё и записывать. По документации на дату проверки 16 июля 2026 Wildberries различает четыре типа токена: персональный (для ваших собственных программ), сервисный (для стороннего сервиса), базовый и тестовый. Токен лучше держать в секрете так же, как пароль: кто им владеет, тот управляет вашими карточками и ценами.

Ozon. Здесь пара из двух значений: идентификатор продавца (в кабинете он подписан «Client-Id») и ключ доступа. Оба создаются в разделе «Настройки», в пункте для внешних программ (подписан латиницей как «Seller» и те же три буквы «эй-пи-ай»), там же лежит список ключей. Идентификатор говорит площадке, чей это магазин, ключ подтверждает право отдавать команды. Подключение бесплатное, как и у Wildberries.

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

Какие бывают разделы методов

Команды сгруппированы по темам. У Wildberries по документации на дату проверки разделов тринадцать, но новичку хватит понимания шести групп. У Ozon набор устроен похоже, названия отличаются, суть та же.

  • Карточки и контент. Создание и правка карточек, загрузка фото и описаний, характеристики. Отсюда начинают те, кто заводит ассортимент пачкой, а не по одной карточке руками.
  • Цены и скидки. Массовая смена цен, установка скидок, участие в акциях. Самая частая причина, по которой селлер вообще идёт в программный обмен: цены надо менять быстро и по многим карточкам сразу.
  • Остатки и заказы. У Wildberries это раздел «Маркетплейс» (заказы по схеме сборки продавцом, склады, обновление остатков), у Ozon отдельно методы по остаткам и по заказам FBS и FBO. Это сердце связки для тех, кто на FBS: остаток должен уходить на площадку сразу после каждой продажи и приёмки.
  • Поставки. Формирование поставок на склады площадки, список доступных складов и коэффициентов приёмки. Полезно, чтобы планировать отгрузку не вслепую.
  • Статистика и аналитика. Отчёты о реализации, воронка продаж, поисковые запросы, продажи по регионам. Отсюда тянут данные в свои таблицы и внешнюю аналитику.
  • Финансы и документы. Баланс магазина, суммы к выплате, печатные формы, акты и универсальные передаточные документы. Нужно тем, кто сводит деньги площадки со своей бухгалтерией.

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

Лимиты: сколько запросов можно и что такое ошибка 429

Площадка не даст слать команды бесконечно. Есть потолок частоты, и его нельзя превышать, иначе ответом придёт ошибка с номером 429, что дословно значит «слишком много запросов».

Ozon. По документации на дату проверки лимит общий: до 50 запросов в секунду с одного идентификатора продавца, независимо от того, сколько у вас потоков или какой метод вы дёргаете. Превысили, получаете ошибку 429 и число секунд, через которое можно повторить. С мая 2026 Ozon добавил отдельные, более строгие лимиты на операции с товарами, так что массовую загрузку карточек стоит разбивать на части.

Wildberries. Здесь потолок считается по разделам и по типу токена. По документации на дату проверки для большинства разделов это порядок ста запросов в минуту, до тысячи записей за один запрос списком и таймаут около тридцати секунд на выполнение. Механизм называют «ведром с жетонами»: у вас есть запас разрешённых обращений, он тратится на запросах и понемногу восстанавливается со временем. Превысили, снова ошибка 429.

Практический вывод для того, кто пишет связку сам: не бейте площадку в лоб циклом без пауз. Ставьте задержку между запросами, объединяйте товары в пакеты, где команда это позволяет, и обрабатывайте ошибку 429 повтором через указанное число секунд, а не падением всей выгрузки.

Что поменялось в 2026 году

Две даты, которые важно держать в голове, если читаете старые инструкции.

С 30 марта 2026 Wildberries развёл лимиты запросов по типам токена. Для персонального и сервисного токена потолок остался прежним, а для базового и тестового стал ниже. Смысл простой: тестовый токен нужен, чтобы попробовать команды, а не гонять на нём боевую выгрузку. Для рабочей интеграции берите персональный или сервисный токен.

С мая 2026 Ozon ужесточил лимиты на операции с товарами в своём канале обмена. Если ваша связка писалась раньше и вдруг начала ловить ошибки 429 на загрузке карточек, дело не в поломке, а в новом потолке: массовые операции надо дробить.

Тарифы, коэффициенты и наборы команд площадки меняют регулярно, поэтому перед боевым запуском всегда сверяйтесь со свежей документацией на dev.wildberries.ru и docs.ozon.ru, а не с прошлогодним гайдом.

Типовые ошибки новичка

Одни и те же грабли повторяются почти у каждого, кто собирает первую связку.

  • Один ключ на всё. Тот же токен и в самописном скрипте, и в стороннем сервисе, и у подрядчика. Утёк один, скомпрометировано всё. Заводите отдельный ключ под каждую задачу и давайте ему только нужные разделы.
  • Запись там, где хватило бы чтения. Если связка только читает статистику, ей не нужен доступ на изменение цен. Лишние права, это лишний риск при утечке.
  • Цикл без пауз. Программа шлёт запросы без задержки, ловит 429 и считает, что «площадка не работает». Площадка работает, это ваш темп слишком высокий.
  • Остаток обновляется по расписанию, а не по событию. Раз в час, а продажи идут каждую минуту. В окно между обновлениями уходят заказы на товар, которого уже нет. На FBS остаток должен уходить сразу после продажи и после приёмки, а не по таймеру.
  • Нет обработки отмен. Заказ отменили, а в вашей системе он всё ещё «в резерве». Остаток на площадке и на складе расходятся, и дальше снежный ком.

Когда остаток держит склад, а не вы вручную

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

Устойчиво это работает там, где остаток формирует складская система (по-английски WMS, «система управления складом»), которая фиксирует каждое движение товара: приёмку, упаковку, отгрузку, возврат. Тогда после каждой операции остаток пересчитывается сам и сам же уходит на площадку по её каналу обмена. Ручная выгрузка из таблицы больше не нужна, а вместе с ней уходит и ошибка «продал то, чего нет». Fulfillment Lite устроен именно так: склад ведёт остаток по каждой позиции (SKU, отдельная товарная единица, например «чёрная сумка размера M»), фиксирует каждое движение и держит обмен с площадкой без ручного переноса. Если интересно посмотреть, как это собрано, загляните в раздел о складском учёте, демо открывается без регистрации.

Если после связки с площадкой вы планируете сводить данные ещё и с 1С, посмотрите разбор схем интеграции 1С с Wildberries и Ozon: там подробно про то, где именно рвётся обмен остатками между учётной системой, складом и площадкой. А чтобы понять, когда таблицы уже не тянут и пора переходить на складскую систему, поможет разбор что такое WMS и кому она нужна.

Что делать: чек-лист на первый запуск

Собирается за один вечер, если под рукой доступ к кабинету.

  1. Определите схему. Вы на FBS (товар у вас) или на FBO/FBW (товар у площадки). От этого зависит, нужен ли постоянный обмен остатками или хватит цен и отчётов.
  2. Заведите ключ под задачу. В Wildberries: «Настройки», пункт доступа для внешних программ, отметьте только нужные разделы. В Ozon: «Настройки», раздел для внешних программ, откройте список ключей и сохраните идентификатор продавца и сам ключ. Не переиспользуйте чужой ключ.
  3. Начните с чтения. Первой командой возьмите список заказов или остатки. Убедитесь, что данные приходят, прежде чем что-то менять на площадке.
  4. Заложите паузы и повтор. Между запросами ставьте задержку, ошибку 429 обрабатывайте повтором через указанное число секунд, массовую загрузку дробите на части.
  5. Привяжите остаток к событию, а не к таймеру. Остаток на площадку должен уходить после каждой продажи, приёмки и возврата, а не раз в час.
  6. Сверьтесь через сутки. На следующий день сравните остаток на складе и на площадке по десяти случайным карточкам. Сходится в ноль, связка рабочая. Расходится, ищите, какое событие не отрабатывает.

Три признака, что связка собрана правильно

  • Остаток на складе и на площадке совпадает без ручной сверки. Если раз в день кто-то «поправляет цифры руками», обмен настроен не до конца.
  • У каждого сервиса и подрядчика свой ключ с минимальным набором прав. Один общий ключ на всё, это не экономия, а отложенная утечка.
  • Программа не падает от ошибки 429, а спокойно повторяет запрос. Значит, темп согласован с лимитом площадки, и выгрузка переживёт распродажу, когда данных станет в разы больше.

Что в итоге

Программный обмен, это не магия для программистов, а способ убрать человека из переноса цифр между складом и площадкой. У Wildberries доступ открывает токен с набором разделов, у Ozon, пара из идентификатора и ключа. Команды сгруппированы по темам: карточки, цены, остатки и заказы, поставки, статистика, финансы. Частоту ограничивают лимиты, за превышением следует ошибка 429, а в 2026 году потолки у обеих площадок стали строже.

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

Источники