Остатки на Ozon по FBS: как обновлять вручную, файлом и через API

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

Три способа обновить остатки

1. Вручную в кабинете. Остаток правится в разделе логистики FBS, в карточке вашего склада. Годится для десятка позиций и для срочной правки. Точный путь Ozon периодически меняет, ищите управление остатками рядом с настройками склада.
2. Файлом XLS. Там же выгружается шаблон: артикул, название склада из выпадающего списка, количество. Рабочий вариант на сотни позиций, но ручной труд остаётся.
3. Через Seller API. Единственный способ, который живёт на тысячах позиций и позволяет обновляться чаще, чем раз в день.

Отдельно стоит помнить, что всё это касается только FBS и realFBS. При FBO остатки списываются автоматически в момент продажи, руками их не трогают.

Лимиты Seller API, которые определяют вашу схему

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

Лимиты приведены по документации Ozon Seller API на август 2026 года. Площадка их меняет, поэтому перед тем как закладывать интервалы в интеграцию, сверьтесь с актуальным разделом документации в своём кабинете.

• 100 пар «товар-склад» в одном запросе к методу обновления остатков, и до 80 запросов в минуту с одного аккаунта.
• Один товар обновляется не чаще раза в 30 секунд.Чаще нельзя: метод вернёт ошибку о превышении частоты.
• Цена одного товара меняется не более 10 раз в час, а в один запрос на цены помещается до 1000 товаров.
• Общий потолок 50 запросов в секунду на один Client ID, и лимиты отдельных методов действуют поверх него. Раньше было 10, подняли в мае 2025 года.
• С февраля 2026 действует единый лимит на операции с товарами — по данным Ozon, 30 000 операций в минуту. Важная деталь: при превышении запрос не обрабатывается частично. Если доступно 500 операций, а в запросе 1000 товаров, не пройдёт ни один.

Практический вывод из первых двух пунктов: полный проход по каталогу в 10 000 позиций упирается в 100 позиций на запрос и 80 запросов в минуту, то есть минимум пара минут только на отправку. Обновлять весь ассортимент по кругу каждые пять минут не выйдет, и не нужно: обновлять надо то, что изменилось.

Какие методы за что отвечают

Запись:

• POST /v2/products/stocks — остатки FBS и realFBS. Метод живой и развивается: в июле 2026 в него добавили новую ошибку для архивных товаров. Устаревшая первая версия /v1/product/import/stocks помечена как deprecated ещё в 2024 году.
• POST /v1/product/import/prices — цены, включая цену до скидки, минимальную и цену для Premium.

Чтение:

• POST /v4/product/info/stocks — сколько доступно и сколько зарезервировано покупателями.
• POST /v2/product/info/stocks-by-warehouse/fbs — остатки по вашим складам. Первую версию метода Ozon отключил в апреле 2026, проверьте, что интеграция обновлена.
• POST /v1/warehouse/list — идентификаторы складов. Без них обновление остатков не пройдёт.

Что происходит при нулевом остатке

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

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

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

Пять ошибок, которые ломают остатки тихо

1. Две интеграции в один склад. Технически конфликта нет, побеждает последний запрос, и ошибки вы не увидите. Зато лимит «раз в 30 секунд на товар» превращает вторую интеграцию в генератор отказов, и часть корректных обновлений первой просто не доезжает.
2. Смешение артикула и внутреннего идентификатора. Если в запросе переданы оба, Ozon применяет изменения по артикулу продавца. Документация прямо советует использовать что-то одно. Разные системы, пишущие разными ключами, дают тихую рассинхронизацию.
3. Забытый резерв под заказы юрлиц. Такие заказы оплачиваются не сразу, товар при этом зарезервирован. Новый остаток нужно ставить с учётом резерва, иначе вы обнулите то, что уже обещано покупателю.
4. Обновление ради обновления. Гнать весь каталог по кругу каждые несколько минут бессмысленно: вы упрётесь в лимиты и получите отказы по позициям, которые реально изменились.
5. Запросы по чужим и несуществующим товарам. По статистике самой площадки это самая массовая категория ошибок при обновлении остатков.

Главная проблема не в API

Допустим, интеграция написана идеально и работает на пределе лимитов. Оверселл всё равно останется, потому что источник расхождения находится не на стороне Ozon, а на стороне поставщика.

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

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

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

Как часто можно обновлять остатки на Ozon?

Остаток одного товара обновляется не чаще раза в 30 секунд. Всего с аккаунта проходит до 80 запросов в минуту к методу остатков, по 100 пар «товар-склад» в каждом.

Через сколько обновлённый остаток появляется на витрине?

Для загрузки файлом сервисы называют интервал от двадцати минут до часа. Для API Ozon публично срок не обещает, поэтому опираться стоит на собственные замеры в своём кабинете.

Что делать, если товар кончился у поставщика?

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

Можно ли обойтись без API и работать файлами?

До нескольких сотен позиций да. Дальше файл перестаёт успевать за реальными остатками, а на каталогах в тысячи позиций ручная выгрузка гарантирует оверселл.

Коротко

Лимиты Ozon заданы жёстко: 30 секунд на товар, 80 запросов в минуту, 50 запросов в секунду на аккаунт. В эти рамки укладывается любая нормальная интеграция, если она обновляет изменившееся, а не весь каталог подряд. Но даже идеальная синхронизация не спасает от расхождения на стороне поставщика, и закрывает его только автоматический резерв.

FBSeller делает обе части: держит остатки актуальными по официальному API дистрибьютора и резервирует товар в момент заказа, а не по расписанию.