API Яндекс Маркета

4 августа 🔸 POST v2/campaigns/{campaignId}/offers/stocks POST v3/businesses/{businessId}/offers/stocks Изменили максимальное значение параметра limit с 200 до 100, значение по умолчанию — с 100 до 50. Если передано значение больше 100, оно обрезается до 100, ошибка валидации не возвращается.

29 июля 🔸 POST v3/businesses/{businessId}/warehouses POST v3/businesses/{businessId}/offers/stocks POST v3/businesses/{businessId}/offers/stocks/update POST v3/businesses/{businessId}/warehouse/models/status POST v3/businesses/{businessId}/reports/stocks/generate Передача остатков через API Работа со складами Добавили методы для работы со складами и остатками на уровне кабинета: получение списка складов, просмотр и передача остатков, включение и выключение модели работы склада, генерация отчета по остаткам. Методы подходят для кабинетов без групп складов. Обновили инструкции по передаче остатков и работе со складами. 🔸 POST v2/campaigns/{campaignId}/warehouse/status Пометили метод как устаревший. Вместо него используйте POST v3/businesses/{businessId}/warehouse/models/status. 🔸 PUT v2/campaigns/{campaignId}/offers/stocks POST v2/campaigns/{campaignId}/offers/stocks POST v2/reports/stocks-on-warehouses/generate POST v2/businesses/{businessId}/warehouses Уточнили, когда использовать методы: updateStocks актуален только для кабинетов с группами складов; getPagedWarehouses актуален для кабинетов с группами складов; getStocks и generateStocksOnWarehousesReport актуальны для моделей FBY и LaaS, а также для FBS, DBS и Экспресс при наличии групп складов.

16 июля 🔸 GET v2/campaigns/{campaignId}/settings В ответе метода добавили объект taxation с информацией о налогообложении партнера: ставку НДС vat. Поддерживаемые значения ставки: VAT_22, VAT_12, VAT_10, VAT_07, VAT_05 и NO_VAT.

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

22 июня 🔸 POST v1/businesses/{businessId}/orders POST v2/campaigns/{campaignId}/orders/{orderId}/deliverDigitalGoods Обработка заказов с цифровыми товарами В ответах методов получения заказов у объекта delivery добавили поле digitalGoods с информацией о способе доставки цифрового товара: тип (EMAIL, ACTIVATION_CODE, STEAM_GIFT или CHAT) и ссылка steamLink на Steam-аккаунт покупателя (только для типа STEAM_GIFT). Переработали инструкцию по работе с цифровыми товарами: описали флоу для каждого из четырех типов доставки.

Работайте через API с отзывами на товары ваших брендов С 18 июня рекламодатели могут работать с отзывами на товары не только в личном кабинете, но и через API. Чтобы получать отзывы используйте метод POST /v1/businesses/{businessId}/goods-feedback-advertiser. Для обработки отзывов рекламодателей передайте параметр sourceType=ADVERTISER в методах: — POST v2/businesses/{businessId}/goods-feedback/comments; — POST v2/businesses/{businessId}/goods-feedback/comments/update; — POST v2/businesses/{businessId}/goods-feedback/skip-reaction; — POST v2/businesses/{businessId}/goods-feedback/comments/delete. Подробности ищите в документации. Остались вопросы или не удаётся настроить интеграцию? Свяжитесь с нами, поможем разобраться: 🔴Напишите в Telegram-бот @YandexApiMarketSupportBot. 🔴Составьте обращение в личном кабинете: Общение → Поддержка → Работа с отзывами через API.

17 июня 🔸 GET v2/campaigns/{campaignId}/orders/{orderId}POST v1/businesses/{businessId}/orders Добавили новый подстатус заказа PURCHASE_GROUP_THRESHOLD_NOT_REACHED_CANCELLED — заказ участвовал в групповой покупке и был отменен, потому что не было достигнуто нужное количество покупок.

15 июня 🔸 POST v2/campaigns/{campaignId}/offers/update POST v2/campaigns/{campaignId}/offers Удалили устаревший параметр quantum — настройку продажи квантами. 🔸 POST v1/businesses/{businessId}/orders В товары заказа добавили поле itemStatuses. В нем возвращается информация о статусах отдельных единиц товара.

10 июня 🔸 POST v2/campaigns/{campaignId}/offersPOST v2/businesses/{businessId}/offer-mappings Добавили новый статус товара: READY_FOR_PUBLICATION. Статус устанавливается, если товар Готов к продаже, но магазин еще не завершил подключение.

2 июня 🔸 POST v1/businesses/{businessId}/reports/marketing-detalization/generate Добавили новый метод для генерации отчета по счету маркетинга. 🔸 POST v2/reports/closure-documents/detalization/generate Из параметра contractType удалили значение MARKETING. Для генерации отчета по счету маркетинга используйте POST v1/businesses/{businessId}/reports/marketing-detalization/generate.

Начните работать с отчётами рекламодателей через API 3 июня 2026 обновили интеграцию, чтобы вы могли автоматизировать сбор информации по всем рекламным каналам и обрабатывать её удобным для вас способом. Теперь по API можно работать с отчётами рекламодателей: по счёту маркетинга, охватному продвижению, полкам, бусту показов и продаж. Чтобы сформировать нужный отчёт, начните передавать параметр sourceType = ADVERTISER в методах API. Подробности ищите в документации. Остались вопросы или не удаётся настроить интеграцию? Свяжитесь с нами, поможем разобраться: 🔴Напишите в Telegram-бот @YandexApiMarketSupportBot. 🔴Составьте обращение в личном кабинете: Общение → Поддержка → Работа через API.

Обновления в API 🔸POST v1/campaigns/{campaignId}/orders/create Добавили параметр fake в запрос создания заказа по модели LAAS. Он позволяет проверить работу магазина и его API на тестовых заказах; такой заказ не будет отгружен и не влияет на остатки. 🔸 Методы отчётов Изменили доступы к отчётам: для генерации отчётов достаточно read-only доступов API-Key-токена.

API-уведомления о вопросах и ответах Теперь по API можно получать уведомления ещё о нескольких типах событий: ➡️ покупатель задал вопрос о товаре, ➡️ появился ответ на вопрос о товаре, ➡️ кто-то прокомментировал ответ. Новые типы уведомлений помогут быстрее обрабатывать вопросы по товарам, а также оптимизировать свою интеграцию, уменьшив количество запросов к Маркету. Как настроить уведомления, читайте в нашей документации.

18 мая 🔸 Коды ошибок Уточнили описания ошибок, связанных с тарифными ограничениями и передачей идентификатора бизнеса в заголовке X-Business-Id. 🔸 POST v1/businesses/{businessId}/orders В блоке delivery добавили поле receiveBarcode — штрихкод получения заказа на ПВЗ. Возвращается только для модели LaaS.

14 мая 🔸 Типы решений по возврату В типы решений по возврату (ReturnDecisionType и ReturnRequestDecisionType) добавили значение PARTIAL_MONEY_REFUND — частичный возврат денег. 🔸 POST v1/businesses/{businessId}/returns/decisions Добавили поле partialCompensationBounds — пределы суммы частичной компенсации. Возвращается для decisionType = PARTIAL_MONEY_REFUND. 🔸 POST v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision POST v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision/submit Добавили поле compensation — сумму добровольной компенсации по позиции; передавайте при решении PARTIAL_MONEY_REFUND.

Обновления в API Изменения в методах и отчётах 🔸 В метод расчёта тарифов POST v2/tariffs/calculate добавлена валидация параметров выплат для магазинов РФ. Теперь поддерживаются только следующие комбинации: — частота DAILY (ежедневно); — частота WEEKLY (еженедельно) с отсрочкой paymentDelayWeeks в 1, 2 или 4 недели. При передаче других значений метод вернёт ошибку. 🔸 В методе получения детальной статистики по заказам POST v2/campaigns/{campaignId}/stats/orders в информации о стоимости услуг добавили значение CROSSREGIONAL_DELIVERY — доставка средней мили. 🔸 В отчёт по услугам Маркета POST v2/reports/united-marketplace-services/generate на листах «Буст продаж, оплата за показы» (файл cpm-boost) и «Видеобаннеры в такси» (файл pads) добавили колонку SURFACE_TYPE (площадка размещения). 🔸 В метод получения детальной информации по заказам POST v2/campaigns/{campaignId}/stats/orders добавлен новый тип денежного перевода MARKET_CESSION — уступка задолженности покупателя. За всеми обновлениями в API можно следить на странице Все обновления.

18 мая 2026 обновим лимиты для некоторых методов Проверьте, какие лимиты подходят для ваших задач и оптимизируйте интеграцию, если часто работаете с большим количеством данных. 🆕 Базовый лимит уменьшится до 5 000 запросов в час для методов: Список невыкупов и возвратов: GET /v2/campaigns/{campaignId}/returns Информация о невыкупе или возврате: GET /v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId} Получение заявления на возврат: POST /v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/application Получение фотографий товаров в возврате: GET /v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision/{itemId}/image/{imageHash} Получение возможных решений по возврату: POST /v1/businesses/{businessId}/returns/decisions Передача решения по возврату: POST /v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/application LAAS Создание возврата: POST /v1/campaigns/{campaignId}/returns/create LAAS Получение подходящих для возврата пунктов выдачи: POST /v1/campaigns/{campaignId}/return-delivery-options LAAS Отмена возврата: POST /v1/campaigns/{campaignId}/returns/cancel Получение списка товаров, которые участвуют или могут участвовать в акции POST /v2/businesses/{businessId}/promos/offers Добавление товаров в акцию или изменение их цен POST /v2/businesses/{businessId}/promos/offers/update Удаление товаров из акции POST v2/businesses/{businessId}/promos/offers/delete Получение доступных чатов POST /v2/businesses/{businessId}/chats ➡️ До 18 мая 2026 будет действовать старый лимит — 10 000 запросов в час. 🆕 Лимит уменьшится до 7 000 запросов в час: Информация о невыкупе или возврате: GET /v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId} ➡️ До 18 мая 2026 будет действовать старый лимит — 10 000 запросов в час. 🆕 Лимит уменьшится до 1 000 запросов в час: Список магазинов пользователя: GET /v2/campaigns ➡️ До 18 мая 2026 будет действовать старый лимит — 5 000 запросов в час. 🆕 Лимит уменьшится до 200 запросов в час: Получение листа сборки: POST /v2/reports/documents/shipment-list/generate ➡️ До 18 мая 2026 будет действовать старый лимит — 1 000 запросов в час. 🆕 Лимит уменьшится до 100 запросов в час: Настройки кабинета: POST /v2/businesses/{businessId}/settings ➡️ До 18 мая 2026 будет действовать старый лимит — 1 000 запросов в час.

C 18 мая 2026 изменятся лимиты методов для Бустов продаж, Вопросов и Отзывов Оптимизируйте интеграцию или подключите подписку для продавцов, если часто работаете с большим количеством данных. Включение буста продаж и установка ставок POST /v2/businesses/{businessId}/bids 🆕 с 18 мая 2026: базовый лимит — 500 запросов в минуту, с подпиской Медиум — 1 000 запросов в минуту ➡️ до 18 мая 2026: старый лимит — 1 000 запросов в минуту Информация об установленных ставках POST /v2/businesses/{businessId}/bids/info 🆕 с 18 мая 2026: базовый лимит — 500 запросов в минуту, с подпиской Медиум — 1 000 запросов в минуту ➡️ до 18 мая 2026: старый лимит — 1 000 запросов в минуту Рекомендованные ставки для заданных товаров POST /v2/businesses/{businessId}/bids/recommendations 🆕 с 18 мая 2026: базовый лимит — 500 запросов в минуту, с подпиской Медиум — 1 000 запросов в минуту ➡️ до 18 мая 2026: старый лимит — 1 000 запросов в минуту Получение отзывов о товарах продавца POST /v2/businesses/{businessId}/goods-feedback 🆕 с 18 мая 2026: базовый лимит — 5 000 запросов в час, с подпиской Медиум —10 000 запросов в час ➡️ до 18 мая 2026: старый лимит — 10 000 запросов в час Получение комментариев к отзыву POST /v2/businesses/{businessId}/goods-feedback/comments 🆕 с 18 мая 2026: базовый лимит — 5 000 запросов в час, с подпиской Медиум —10 000 запросов в час ➡️ до 18 мая 2026: старый лимит — 10 000 запросов в час Пропуск реакции на отзывы POST /v2/businesses/{businessId}/goods-feedback/skip-reaction 🆕 с 18 мая 2026: базовый лимит — 500 запросов в час, с подпиской Медиум —1 000 запросов в час ➡️ до 18 мая 2026: старый лимит — 1 000 запросов в час Получение вопросов о товарах продавца POST /v1/businesses/{businessId}/goods-questions 🆕 с 18 мая 2026: базовый лимит — 1 000 запросов в час, с подпиской Медиум —5 000 запросов в час ➡️ до 18 мая 2026: старый лимит — 10 000 запросов в час Получение ответов на вопрос POST /v1/businesses/{businessId}/goods-questions/answers 🆕 с 18 мая 2026: базовый лимит — 1 000 запросов в час, с подпиской Медиум —5 000 запросов в час ➡️ до 18 мая 2026: старый лимит — 10 000 запросов в час Создание, изменение и удаление ответа или комментария POST /v1/businesses/{businessId}/goods-questions/update 🆕 с 18 мая 2026: базовый лимит — 500 запросов в час, с подпиской Медиум —1 000 запросов в час ➡️ до 18 мая 2026: старый лимит — 500 запросов в час

Обновления в API Изменения в методах и отчётах 🔸 В отчёт по услугам Маркета POST v2/reports/united-marketplace-services/generate добавили колонку VOLUME — объём в литрах в блоке габаритов заказа и товара. 🔸 В отчёт по схождению с закрывающими документами POST v2/reports/closure-documents/detalization/generate в описание листов отчёта (операции рекламодателя) добавили колонку SURFACE — площадка. Обновление документации 🔸 Для методов получения данных по возвратам уточнили форматы ответов: — В методе получения заявления на возврат GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/application файл отдаётся в формате PDF. — В методе получения фото возврата GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}/decision/{itemId}/image/{imageHash} фото возвращается как image/jpeg или image/png (проверить можно в заголовке Content-Type). Максимальный размер файла — 50 МБ. 🔸 Для API Уведомлений уточнили логику уведомлений о сообщениях в чате: при отправке стикера уведомление не формируется. 🔸 Для работы по подписке: при использовании расширенных возможностей API через OAuth-токен теперь необходимо передавать идентификатор бизнеса в заголовке X-Business-Id. За всеми обновлениями в API можно следить на странице Все обновления.

C 18 мая 2026 изменятся лимиты методов для работы с Ценами Проверьте, какие лимиты подходят для ваших задач, оптимизируйте интеграцию или подключите подписку для продавцов, если часто работаете с большим количеством данных. Просмотр цен в кабинете POST /v2/businesses/{businessId}/offer-prices 🆕 с 18 мая 2026: базовый лимит — 5 000 товаров в минуту, с подпиской Медиум — 10 000 товаров в минуту ➡️до 18 мая 2026: старый лимит — 10 000 товаров в минуту Просмотр цен в магазине POST /v2/businesses/{businessId}/offer-prices 🆕 с 18 мая 2026: базовый лимит — 10 000 товаров в минуту, с подпиской Медиум — 100 000 товаров в минуту ➡️до 18 мая 2026: старый лимит — 150 000 товаров в минуту Рекомендации Маркета POST /v2/businesses/{businessId}/offers/recommendations 🆕 с 18 мая 2026: базовый лимит — 50 запросов в минуту, с подпиской Медиум —100 запросов в минуту ➡️ до 18 мая 2026: старый лимит — 100 запросов в минуту Список товаров, находящихся в карантине по цене в кабинете POST /v2/businesses/{businessId}/price-quarantine 🆕 с 18 мая 2026: базовый лимит — 5 000 товаров в минуту, с подпиской Медиум —10 000 товаров в минуту ➡️ до 18 мая 2026: старый лимит — 10 000 товаров в минуту Список товаров, находящихся в карантине по цене в магазине POST /v2/campaigns/{campaignId}/price-quarantine 🆕 с 18 мая 2026: базовый лимит — 5 000 товаров в минуту, с подпиской Медиум —10 000 товаров в минуту ➡️до 18 мая 2026: старый лимит — 10 000 товаров в минуту Удаление товара из карантина по цене в кабинете POST:/v2/businesses/{businessId}/price-quarantine/confirm 🆕 с 18 мая 2026: базовый лимит — 5 000 товаров в минуту, с подпиской Медиум —10 000 товаров в минуту ➡️ до 18 мая 2026: старый лимит — 10 000 товаров в минуту Удаление товара из карантина по цене в магазине POST /v2/campaigns/{campaignId}/price-quarantine/confirm 🆕 с 18 мая 2026: базовый лимит — 5 000 товаров в минуту, с подпиской Медиум —10 000 товаров в минуту ➡️ до 18 мая 2026: старый лимит — 10 000 товаров в минуту