Яндекс Маркет Partner API: Забирать новые заказы и подтверждать их

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

Обработка заказов FBS: получить новые заказы из всех магазинов кабинета и сообщить Маркету, что заказ собран.

Создай Api-Key-токен в кабинете продавца с доступом inventory-and-order-processing. Узнай businessId (кабинет) и campaignId (магазин): GET /v2/campaigns.
Забирай новые заказы: POST /v1/businesses/{businessId}/orders с statuses = ["PROCESSING"] и substatuses = ["STARTED"] — это заказы, которые ждут сборки. Листай страницы через pageToken из ответа. Старый GET /v2/campaigns/{campaignId}/orders отключается 12.04.2027 — сразу пиши на новом.
Собрал заказ — переведи его на следующий этап: PUT /v2/campaigns/{campaignId}/orders/{orderId}/status с order.status = PROCESSING и order.substatus = READY_TO_SHIP.
Если товара нет, отмени заказ тем же методом: status = CANCELLED с причиной в substatus, например SHOP_FAILED.
Тестовые заказы приходят с fake: true — не отправляй их в учётную систему.

H="Api-Key: $YM_TOKEN"

# Новые заказы во всех магазинах кабинета
curl -X POST "https://api.partner.market.yandex.ru/v1/businesses/<businessId>/orders?limit=50" \
  -H "$H" -H 'Content-Type: application/json' \
  -d '{"statuses": ["PROCESSING"], "substatuses": ["STARTED"]}'

# Заказ собран
curl -X PUT "https://api.partner.market.yandex.ru/v2/campaigns/<campaignId>/orders/<orderId>/status" \
  -H "$H" -H 'Content-Type: application/json' \
  -d '{"order": {"status": "PROCESSING", "substatus": "READY_TO_SHIP"}}'

Базовые 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	нет	Количество значений на странице

POST /v1/businesses/{businessId}/orders — Информация о заказах в кабинете

Заказы по всем магазинам кабинета; рекомендуемая замена GET /v2/campaigns/{campaignId}/orders.

Параметр	Где	Тип	Обяз.	Описание
`businessId`	path	integer	да	Идентификатор кабинета
`pageToken`	query	string	нет	Страница результатов
`limit`	query	integer	нет	Количество значений на странице
`orderIds`	body	array	нет	ID заказов
`externalOrderIds`	body	array	нет	Внешние ID заказов
`campaignIds`	body	array	нет	ID магазинов
`statuses`	body	array	нет	Статусы заказов
`substatuses`	body	array	нет	Этапы обработки или причины отмены
`programTypes`	body	array	нет	Модели работы магазина
`dates`	body	object	нет	Фильтр по датам
`fake`	body	boolean	нет	true — тестовые заказы
`waitingForCancellationApprove`	body	boolean	нет	Только DBS: заказы с запросом на отмену
`sourcePlatforms`	body	array	нет	Площадки-источники заказов

GET /v2/campaigns/{campaignId}/orders — Информация о заказах в магазине

Устаревает: деградация с 18.01.2027, отключение 12.04.2027; замена — POST /v1/businesses/{businessId}/orders.

Параметр	Где	Тип	Обяз.	Описание
`campaignId`	path	integer	да	Идентификатор магазина
`orderIds`	query	array	нет	ID заказов; не сочетать с другими фильтрами
`status`	query	array	нет	Статус: CANCELLED, DELIVERED, DELIVERY, PROCESSING и др.
`substatus`	query	array	нет	Этап обработки или причина отмены
`fromDate`	query	string	нет	Дата оформления от, ДД-ММ-ГГГГ
`toDate`	query	string	нет	Дата оформления до, ДД-ММ-ГГГГ
`updatedAtFrom`	query	string	нет	Дата обновления от, ISO 8601
`updatedAtTo`	query	string	нет	Дата обновления до, ISO 8601
`fake`	query	boolean	нет	Тестовые заказы
`pageToken`	query	string	нет	Страница результатов
`limit`	query	integer	нет	Количество значений на странице

PUT /v2/campaigns/{campaignId}/orders/{orderId}/status — Изменение статуса заказа

Возвращает обновлённую информацию о заказе. Для нескольких заказов — POST /v2/campaigns/{campaignId}/orders/status-update.

Параметр	Где	Тип	Обяз.	Описание
`campaignId`	path	integer	да	Идентификатор магазина
`orderId`	path	integer	да	Идентификатор заказа
`order.status`	body	string	да	Новый статус заказа
`order.substatus`	body	string	нет	Этап обработки (PROCESSING) или причина отмены (CANCELLED)
`order.delivery`	body	object	нет	Информация о доставке

Нюансы

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