Автоматизация Яндекс Маркета: остатки, цены, заказы и отзывы
Продавец работает на WB и Ozon, остатки и цены уже связаны с учётом, и тут подключается Яндекс Маркет. Кажется, что достаточно «добавить ещё одну площадку», но у Маркета своя логика: кабинет и магазины внутри него, модели работы, от которых зависит набор методов, карантин цен и собственные лимиты. Интеграцию с WB или Ozon один к одному не перенести.
Разберём по документации Партнёрского API на октябрь 2026 года: что зависит от модели, что можно автоматизировать, как устроены доступы и лимиты, в каком порядке внедрять и где обычно спотыкаются.
Короткий ответ: через Партнёрский API Маркета автоматизируют остатки, цены, заказы и статусы, отзывы, вопросы, чаты и отчёты. Набор зависит от модели: по FBY остатки через API не передают, по FBS, DBS и Экспресс передают. Авторизация - Api-Key-токен с выбранными доступами, OAuth устарел. Одновременно - не больше 4 запросов. Ориентир: интеграция или один процесс - от 7-15 до 35-55 тыс. ₽ в зависимости от числа систем и исключений.
Модели работы и что от них зависит в автоматизации
Для продаж на витрине у Маркета четыре модели. Справка Маркета прямо советует их сочетать: одну и ту же позицию можно продавать сразу по нескольким схемам, например хиты держать на складе Маркета, а новинки и товары с нестабильным спросом - на своём.
| Модель | Кто хранит и доставляет | Что важно для автоматизации |
|---|---|---|
| FBY | Товар на складе Маркета, сборка и доставка на Маркете | Остатки через API не передаются: следят за оборачиваемостью и заявками на поставку |
| FBS | Храните и собираете вы, доставляет Маркет | Остатки из учёта, статусы сборки, ярлыки, отгрузки и акты |
| Экспресс | Храните и собираете вы, курьер забирает заказ и доставляет примерно за два часа в ограниченной зоне | Остатки, быстрая обработка заказа, код подтверждения при передаче курьеру, если он включён |
| DBS | Храните, собираете и доставляете сами | Остатки, статусы, трек-номер, дата доставки, данные покупателя |
Есть ещё LaaS: товары лежат на складе Маркета, но продаются на других площадках, а Маркет доставляет эти заказы. Для продавцов с несколькими каналами это отдельный сценарий интеграции.
Для автоматизации отсюда два вывода. Первый: одна позиция может жить в нескольких моделях, и остаток у неё в двух местах - на складе Маркета и на вашем. Второй: модель задаётся на уровне магазина, а часть методов работает только для отдельных моделей, поэтому интеграция должна знать, какой магазин по какой схеме работает.
Что можно автоматизировать через Партнёрский API
Остатки
Для FBS, Экспресс и DBS остатки передаются из учёта: до 2 000 позиций в одном запросе при лимите 50 запросов в минуту у метода уровня кабинета. Если в кабинете настроены группы складов, нужен другой метод, уровня магазина: остаток передают по одному любому складу группы, остальные обновятся сами. По FBY остаток формирует склад Маркета из ваших поставок, через API его можно смотреть вместе с оборачиваемостью.
Цены
Основной способ - одна цена для всех магазинов кабинета: до 500 товаров в запросе при лимите 10 000 товаров в минуту. Отдельные цены по магазинам можно ставить, только если в кабинете есть такая возможность. Через API приходят и рекомендации Маркета по ценам, и список товаров в карантине - о нём ниже.
Заказы и статусы
Новые заказы и смену статусов удобно получать API-уведомлениями: Маркет сам отправляет запрос на ваш адрес, а полные данные заказа забираются отдельным методом. Дальше заказ уходит в учёт или CRM, статусы обновляются через API, для FBS добавляются ярлыки, отгрузки и акты, для DBS - трек-номер и дата доставки. Список заказов за период отдаётся не больше чем за 30 дней в одном запросе.
Отзывы, вопросы и чаты
Отзывы и вопросы о товарах читаются через API, на них можно отвечать, а новые отзывы и сообщения в чатах с покупателями приходят уведомлениями. Лимиты здесь скромнее, чем у цен: комментарии к отзывам - 1 000 запросов в час, ответы на вопросы - 500 запросов в час без подписки «Медиум» и 1 000 с ней. Как устроены черновики ответов с ИИ, показано на примере автоответов на отзывы Wildberries: для Маркета подход тот же, отличается API.
Отчёты
Через API заказываются отчёты: аналитика продаж, заказы, цены, отзывы, реализация, платежи, стоимость услуг Маркета, закрывающие документы. Отчёт формируется в два шага: сначала запрос на генерацию, потом проверка статуса и скачивание готового файла.
Доступы и лимиты API
Авторизация - Api-Key-токен в заголовке Api-Key. OAuth-токен документация использовать не рекомендует: способ устарел, а уже выпущенный токен работает до конца срока действия. Различие принципиальное: Api-Key привязан к кабинету, OAuth - к сотруднику, который его создал.
Создать Api-Key может владелец или менеджер кабинета. Токенов в кабинете до 30, каждый действует бессрочно, пока его не удалят. Доступы выбираются по группам: заказы и учёт товаров, цены, товары и карточки, продвижение, финансы и отчётность, общение с покупателями, настройки магазинов. У большинства групп есть вариант «только просмотр».
Практика простая: отдельный токен под каждую интеграцию и каждого подрядчика, минимум доступов, для отчётов - только чтение. Бессрочный токен сам не истечёт, поэтому после окончания работ с подрядчиком его удаляют вручную.
Лимиты, которые нужно учесть в коде:
- не больше 4 одновременных запросов на магазин или кабинет, при превышении сервер отвечает кодом 420;
- у каждого метода свой лимит на число запросов или объём данных, подписка «Медиум» часть лимитов расширяет;
- ошибки клиента 4xx тоже расходуют лимит, ошибки Маркета 5xx - нет;
- тело запроса - не больше 512 КБ.
Вывод для разработки: очередь запросов с ограничением параллельности и разбор ошибок вместо повторов вслепую. Сценарий, который раз за разом отправляет некорректный запрос, сам расходует свой лимит.
Чем Маркет отличается от WB и Ozon для автоматизации
Общая логика у трёх площадок одна: учёт - единый источник правды по остаткам, площадки получают данные из него, у цены есть нижняя граница. Она разобрана в статье автоматизация маркетплейсов, а особенности Ozon - в материале про автоматизацию продаж на Ozon. Адаптер к Маркету пишется заново, и вот что в нём требует отдельного внимания:
- Кабинет и магазины. Для покупателя все магазины кабинета выглядят одним продавцом, а в API часть методов работает на уровне кабинета, часть - на уровне магазина. Интеграции нужны оба идентификатора.
- Модели внутри одного ассортимента. Одна позиция может продаваться по FBY и FBS одновременно, и остатки по ней считаются в двух местах.
- Экспресс и DBS. У этих моделей свои данные и действия: код подтверждения у Экспресса, трек-номер, дата доставки и данные покупателя у DBS.
- Карантин цен. Если новая цена сильно ниже прежней или рыночной, Маркет скрывает товар с витрины, пока цену не подтвердят. По умолчанию при сравнении с прежней ценой порог - изменение больше чем в два раза. На цены, выставленные вручную в кабинете, карантин не действует, а на цены из API действует, поэтому репрайсер должен уметь его разбирать.
- Уведомления о событиях. Маркет сам сообщает о заказах, возвратах, отзывах, чатах и спорах. Опрос по расписанию остаётся страховкой на случай пропущенного уведомления.
Типовые сценарии и порядок внедрения
Порядок, который снижает риск: сначала то, что только читает данные, потом то, что меняет витрину.
- Доступы и карта магазинов. Токены с нужными доступами, список магазинов и их моделей, ответственный за кабинет в компании.
- Сопоставление SKU с учётом. Маркет требует передавать SKU в точности как в каталоге: «557722» и «0557722» для него разные SKU.
- Отчёты и алерты. Ежедневная сводка и сигналы о проблемах ничего не меняют на витрине, поэтому их запускают первыми.
- Остатки из учёта со страховым запасом. Источник - 1С или МойСклад, как устроен обмен, разобрано в статьях про интеграцию с 1С и интеграцию с МойСклад.
- Цены с нижней границей и разбором карантина.
- Заказы и статусы. Уведомления, передача заказа в учёт, статусы, ярлыки и документы.
- Отзывы и вопросы. Черновики с ИИ, негатив проверяет человек.
Посчитаем на допущениях. Магазин по FBS: 3 000 SKU, 300 заказов в день, один склад без групп. Полное обновление остатков - 2 запроса при лимите 50 в минуту, полный прайс - 6 запросов по 500 товаров при лимите 10 000 товаров в минуту. Лимиты здесь не узкое место. Узкие места другие: данные в каталоге обновляются до нескольких минут, поэтому нужен страховой остаток, а резкая переоценка через API может увести товар в карантин. Как синхронизация остатков, цен и заказов с учётом устроена целиком, показано в кейсе Яндекс Маркета с учётной системой.
Если до сезона мало времени, начинайте с остатков и алертов: что реально успеть до декабря, разобрано в статье про подготовку к новогоднему пику.
Подводные камни
- SKU не совпадает символ в символ. Лишний ноль в начале, и для Маркета это уже другой SKU.
- Изменения применяются не мгновенно. Обновление каталога занимает до нескольких минут, и без страхового остатка в пик возможна продажа того, чего уже нет.
- Группы складов. Если их настроят после запуска интеграции, метод передачи остатков придётся сменить.
- Зачёркнутая цена. Если на товар есть скидка, документация требует передавать зачёркнутую цену при каждом обновлении. Скидка - от 5 до 99%.
- Уведомления. Маркет отправляет их только на HTTPS с сертификатом официального центра и ждёт ответа 10 секунд, а входящие запросы стоит сверять с диапазонами IP Маркета. Поэтому обработчик сначала отвечает, а заказ разбирает уже в очереди.
- Отчёты меняют формат. Структура отчётов может меняться без предупреждения: появляется новая колонка, меняется название листа. Разбор пишут по названиям колонок, а не по их номерам.
- Неактивный магазин. Если магазин больше 90 дней не размещал товары на витрине, методы API для него недоступны.
- Старые интеграции на OAuth. Такой токен привязан к сотруднику. Переводите интеграцию на Api-Key заранее, а не в день, когда у сотрудника отключат доступ.
Сколько стоит: ориентир
Ориентир по ценам: интеграция остатков и цен с учётом или автоматизация одного процесса, например обработки заказов или ответов на отзывы с ИИ, - от 7-15 до 35-55 тыс. ₽ в зависимости от числа систем и исключений, эксплуатация - 4-15 тыс. ₽ в месяц: сервер, API модели, поддержка. Если интеграция с WB или Ozon уже есть, добавить Маркет обычно дешевле, чем строить с нуля: учётная часть и правила переиспользуются, пишется адаптер. Состав работ и сроки - на странице услуги автоматизация маркетплейсов.
Итог
Яндекс Маркет автоматизируется через официальный Партнёрский API: остатки, цены, заказы, отзывы, вопросы, чаты и отчёты. Начинать стоит с карты магазинов и моделей, сопоставления SKU и отчётов, затем остатки и цены, затем заказы и общение с покупателями. Три вещи закладывают сразу: Api-Key с минимальными доступами, очередь запросов под лимит в 4 параллельных и разбор карантина цен.
Частые вопросы
Можно ли через API управлять остатками на складе Маркета по FBY?
Нет. Передача остатков через API доступна для FBS, Экспресс и DBS. По FBY остаток формирует склад Маркета из ваших поставок, а через API его можно смотреть вместе с оборачиваемостью, получать данные о заявках на поставку и отчёты. Автоматизация здесь - планирование поставок по оборачиваемости, а не синхронизация остатков.
Что использовать для подключения: Api-Key или OAuth-токен?
Api-Key. Документация Маркета называет OAuth устаревшим способом и не рекомендует его, уже выпущенный OAuth-токен работает до конца срока действия. Api-Key привязан к кабинету, а не к сотруднику, действует бессрочно и выдаётся с выбранными доступами, например только на просмотр отчётов. В одном кабинете можно создать до 30 таких токенов.
Как часто можно обновлять остатки и цены на Маркете?
Ограничивают лимиты конкретных методов: передача остатков на уровне кабинета - 50 запросов в минуту по 2 000 позиций, цены для всех магазинов - 10 000 товаров в минуту по 500 в запросе. Одновременно можно выполнять не больше 4 запросов. Для магазина на несколько тысяч SKU лимиты не узкое место, важнее, что изменения применяются в течение нескольких минут.
Не готовы обсуждать проект? Оцените выгоду сами: калькулятор ROI автоматизации - 1 минута, без контактов. Или заберите чек-лист «Что автоматизировать первым».