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

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

Синхронизировать остатки из учётной системы, чтобы Маркет не продавал отсутствующий товар.

Нужен campaignId магазина (из GET /v2/campaigns) и токен с доступом inventory-and-order-processing.
Отправь остатки: PUT /v2/campaigns/{campaignId}/offers/stocks — в skus для каждого товара твой SKU (sku) и items с count. SKU в одном запросе не должны повторяться.
Передавай остатки сразу после изменения, а не раз в сутки: лимит щедрый — 100 000 запросов в минуту.
Нулевой count снимает товар с продажи, пока его нет на складе.

curl -X PUT "https://api.partner.market.yandex.ru/v2/campaigns/<campaignId>/offers/stocks" \
  -H "Api-Key: $YM_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
        "skus": [
          {"sku": "MUG-WHITE-330", "items": [{"count": 25}]},
          {"sku": "MUG-BLACK-330", "items": [{"count": 0}]}
        ]
      }'

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

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

GET /v2/campaigns — Список магазинов пользователя

Для Api-Key-токена возвращает магазины кабинета, для которого выдан токен. Отсюда берут campaignId и businessId.

Параметр	Где	Тип	Обяз.	Описание
`pageToken`	query	string	нет	Идентификатор страницы результатов
`limit`	query	integer	нет	Количество значений на странице

PUT /v2/campaigns/{campaignId}/offers/stocks — Передача остатков

Параметр	Где	Тип	Обяз.	Описание
`campaignId`	path	integer	да	Идентификатор магазина
`skus`	body	array	да	Остатки; sku уникальны в запросе
`skus[].sku`	body	string	да	Ваш SKU
`skus[].items`	body	array	да	Информация об остатках
`skus[].items[].count`	body	integer	да	Количество доступного товара
`skus[].items[].updatedAt`	body	string	нет	Дата и время обновления остатков

Нюансы

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