Яндекс Маркет Partner API: Добавить товар в каталог

Сценарий из mcp-everything. Актуально на 2026-10-24.

Завести новый товар: выбрать категорию Маркета, заполнить характеристики и отправить в каталог.

1. Найди категорию: POST /v2/categories/tree вернёт дерево категорий Маркета с id. Характеристики выбранной категории — в методе /v2/category/{categoryId}/parameters.
2. Отправь товар: POST /v2/businesses/{businessId}/offer-mappings/update — в offerMappings[].offer: offerId, name (тип + бренд + модель + особенности), marketCategoryId, pictures, vendor, barcodes, description, weightDimensions и parameterValues.
3. Ответ 200 ещё не значит, что товар принят: при ошибке хотя бы в одном товаре не уходит ни один товар из запроса. Смотри ошибки и предупреждения в теле ответа.
4. Проверь статус карточки: POST /v2/businesses/{businessId}/offer-mappings с offerIds — в ответе статус карточки и категория.
5. Не используй устаревшие offer.category и offer.params — они отключаются 12.10.2026; вместо них marketCategoryId и parameterValues.

curl -X POST "https://api.partner.market.yandex.ru/v2/businesses/<businessId>/offer-mappings/update" \
  -H "Api-Key: $YM_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
        "offerMappings": [{
          "offer": {
            "offerId": "MUG-WHITE-330",
            "name": "Кружка керамическая Моя марка 330 мл белая",
            "marketCategoryId": <id категории>,
            "vendor": "Моя марка",
            "pictures": ["https://example.ru/img/mug-white.jpg"],
            "barcodes": ["4601234567893"],
            "description": "Белая керамическая кружка объёмом 330 мл.",
            "weightDimensions": {"length": 12, "width": 9, "height": 10, "weight": 0.4}
          }
        }]
      }'

Базовые 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>"

Методы сценария

POST /v2/businesses/{businessId}/offer-mappings — Информация о товарах в каталоге

Список товаров, их категории на Маркете и характеристики.

Параметр	Где	Тип	Обяз.	Описание
businessId	path	integer	да	Идентификатор кабинета
pageToken	query	string	нет	Страница результатов
limit	query	integer	нет	Количество значений на странице
language	query	string	нет	Язык name и description, по умолчанию RU
offerIds	body	array	нет	SKU товаров
cardStatuses	body	array	нет	Статусы карточек
categoryIds	body	array	нет	Категории на Маркете
vendorNames	body	array	нет	Бренды
tags	body	array	нет	Теги
archived	body	boolean	нет	true — товары в архиве

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	нет	Использовать только ваши данные о товаре

POST /v2/categories/tree — Дерево категорий

Возвращает дерево категорий Маркета. Характеристики категории — POST /v2/category/{categoryId}/parameters.

Нюансы

• Пагинация — по 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