Яндекс Маркет Partner API: POST /v2/businesses/{businessId}/offer-mappings/update — Добавление и изменение товаров

Параметр	Где	Тип	Обяз.	Описание
`businessId`	path	integer	да	Идентификатор кабинета
`offerMappings`	body	array	да	Товары для добавления или обновления
`offerMappings[].offer.offerId`	body	string	да	Ваш SKU
`offerMappings[].offer.name`	body	string	нет	Название: тип + бренд + модель + особенности
`offerMappings[].offer.marketCategoryId`	body	integer	нет	Категория на Маркете
`offerMappings[].offer.pictures`	body	array	нет	Ссылки на изображения; первое — основное
`offerMappings[].offer.vendor`	body	string	нет	Бренд
`offerMappings[].offer.barcodes`	body	array	нет	Штрихкоды (EAN-13, EAN-8, UPC-A, UPC-E)
`offerMappings[].offer.description`	body	string	нет	Описание
`offerMappings[].offer.weightDimensions`	body	object	нет	Габариты упаковки и вес
`offerMappings[].offer.parameterValues`	body	array	нет	Характеристики; передаются вместе с marketCategoryId
`offerMappings[].offer.basicPrice`	body	object	нет	Цена с указанием скидки
`offerMappings[].mapping`	body	object	нет	Подходящая карточка на Маркете
`onlyPartnerMediaContent`	body	boolean	нет	Использовать только ваши данные о товаре

Базовые URL

Боевой: https://api.partner.market.yandex.ru

Авторизация

Тип: API-ключ

Основной способ — API-ключ (Api-Key-токен) из кабинета продавца в заголовке Api-Key. Также поддерживается OAuth-токен Яндекса со скоупом market:partner-api (авторизация через https://oauth.yandex.ru/authorize). Доступ к методам определяется доступами токена: all-methods, all-methods:read-only, inventory-and-order-processing, offers-and-cards-management, pricing, communication, finance-and-accounting, settings-management, promotion и их read-only вариантами.

curl https://api.partner.market.yandex.ru/v2/campaigns -H "Api-Key: <token>"

Нюансы

Пагинация — по pageToken и limit; параметры page и pageSize устарели и отключаются с 05.10.2026.
GET /v2/campaigns/{campaignId}/orders отключается 12.04.2027 — переходите на POST /v1/businesses/{businessId}/orders.
Параметры offer.category, offer.params, customsCommodityCode устарели (отключение 12.10.2026); используйте marketCategoryId, parameterValues, commodityCodes.
При ошибке хотя бы в одном товаре offer-mappings/update не отправляет в каталог ни один товар из запроса; ответ 200 сам по себе не означает, что товары прошли проверку.
Отчёты генерируются асинхронно: сначала .../generate, потом опрос GET /v2/reports/info/{reportId}.
Тестовые заказы отмечены fake: true.
У метода GET /v2/campaigns/{campaignId}/orders ограничение — до 6 параллельных запросов.

Сценарии с этим методом

Добавить товар в каталог

Если этого недостаточно — официальная документация: https://yandex.ru/dev/market/partner-api/doc/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-market.md