이 가이드는 러시아어로 제공됩니다

Как подключить Яндекс Маркет к порталу: токен, заказы, уведомления

Яндекс Маркет подключается по API-ключу кабинета. Портал ведёт цикл FBS: заказы в канбане, карточки товаров, цены, остатки, сборка, ярлыки, отгрузки, запросы на отмену, возвраты и финансы. Всё, что меняет данные в кабинете Маркета, по умолчанию выключено и включается переключателями в настройках подключения.

1. Что умеет интеграция

2. Что нужно заранее

• Кабинет продавца на Яндекс Маркете с подключённым магазином: договор заключён, модель работы выбрана (для полного цикла в портале — FBS).
• Склад продавца, настроенный в кабинете Маркета, если вы собираетесь выгружать остатки.
• Тариф Web Plus: раздел «Маркетплейсы» доступен на нём (сейчас в бете).
• Право «Подключения к площадкам» у вашей роли в мастерской.
• Для тестирования больше ничего не нужно: тестовые заказы Маркет создаёт бесплатно.

3. Как получить ключ

1. Откройте кабинет продавца Яндекс Маркета.

2. Перейдите в настройки API-ключей.

3. Создайте ключ и дайте ему понятное имя, например «Портал».

4. Выберите доступы под то, чем будете пользоваться:

   • «Обработка заказов и доставка» — заказы, сборка, ярлыки, отмены, отгрузки, возвраты, запросы на отмену и финансы по заказам. Можно выдать только на чтение, но тогда портал не сможет выполнять действия с заказами;
   • «Управление товарами и карточками» — карточки, характеристики и остатки;
   • «Цены» — выгрузка цен (нужен полный доступ, не только чтение). Комиссии считаются при доступе «Цены» (достаточно чтения) или «Финансы и бухгалтерия».

   «Полный доступ» тоже подходит. Лишнего не отмечайте.

5. Скопируйте ключ. Ключ бессрочный, но его можно отозвать в кабинете.

Портал сам проверяет доступы ключа и показывает в карточке подключения чек-лист: чего не хватает и что добавить. Доступы можно перепроверить кнопкой «Проверить права».

Если API Маркета для вашего кабинета выключен, портал покажет причину текстом. Обычно это значит, что в кабинете нет активного магазина: например, магазин не подключён к модели FBS, нет договора, товары не размещались 90 дней или интеграция выключена вручную. Завершите подключение магазина в кабинете Маркета.

4. Подключение у нас

1. Откройте раздел «Маркетплейсы» → «Подключения».
2. Нажмите «Подключить» у карточки Яндекс Маркета.
3. Вставьте ключ.
4. Выберите режим:
   • боевой кабинет: только настоящие заказы;
   • тестовые заказы: только тестовые заказы Маркета, настоящие не подмешиваются.
5. Портал проверит связь и доступы. Ключ сохранится только после успешной проверки.
6. В «Настройках подключения»:
   • выберите магазин. У одного ключа может быть несколько магазинов. Если магазин с моделью FBS один, портал выберет его сам, а если несколько, выберите нужный в поле «Магазин». Рядом видно, доступен ли API этого магазина;
   • выберите склад продавца для остатков;
   • включите нужные виды записи: «Карточки товаров», «Цены», «Остатки», «Действия с заказами».

Кабинеты с группами складов портал пока не поддерживает.

5. Уведомления площадки

Без уведомлений портал опрашивает Маркет по расписанию, и новый заказ появляется с задержкой. С уведомлениями заказ появляется за секунды.

1. В карточке подключения скопируйте наш URL уведомлений.
2. В кабинете Маркета откройте «Настройки» → «API и модули» → «API-уведомления» и вставьте URL.
3. Сохраните и включите уведомления.

Портал сразу подтягивает заказы, когда приходит уведомление о новом заказе, изменении заказа, смене статуса, отмене, запросе на отмену, новом возврате или невыкупе и смене его статуса.

Уведомления только ускоряют работу. Регулярный опрос остаётся, поэтому потерянное уведомление ничего не ломает.

Оповещения вам в Телеграм и браузер

Это другое, чем уведомления выше: те нужны порталу, а эти приходят вам. Портал сам пишет вам о важном, в Телеграм и в браузер (web-push). Присылаем:

• новый заказ;
• отмена заказа покупателем или Маркетом (отмену, которую вы сделали из портала, мы не присылаем);
• запрос покупателя на отмену со сроком, до которого нужно ответить (Маркет присылает такие запросы для модели DBS);
• возврат или невыкуп;
• «сегодня последний день отгрузки», если заказ ещё не собран (приходит днём);
• карточка отклонена (с причиной) или прошла модерацию;
• товар закончился: остаток на Маркете стал 0;
• ошибка отправки на Маркет;
• проблемы с подключением, например ошибка доступа.

Как настроить. Откройте «Профиль» → «Уведомления» → «Маркетплейсы». У каждого события свой переключатель. По умолчанию включено всё, кроме «Карточка прошла модерацию». Для оповещений нужен привязанный Телеграм: его привязывают в профиле.

У каждого сотрудника мастерской свои настройки. Сотрудники получают оповещения, если у них есть доступ к заказам площадок, а у владельца действует тариф Web Team.

Когда вы только подключили площадку, первая синхронизация оповещений не присылает: заказы из прошлого не считаются новыми. Об одном и том же событии повторно мы не пишем.

6. Товары

Вкладка «Маркетплейсы» → «Товары». Товар мастерской — одна карточка на изделие, общая для всех площадок.

Уже торгуете на Маркете? Нажмите «Загрузить карточки с Маркета». Портал заберёт карточки кабинета и свяжет их с вашими товарами по артикулу (в кабинете он называется offerId). Остальные карточки заведёт новыми товарами. Уже заполненное в портале не перезаписывается. Главное фото для изделия склада копируется к нам. Что происходит со складом при загрузке, описано ниже в подразделе «Изделия на складе для новых карточек». Если вы сняли там галочку, свяжите загруженный товар с изделием склада в редакторе, иначе его остаток не выгружается.

У каждой карточки виден статус на Маркете: на модерации, активна, отклонена или в архиве. Если Маркет отклонил карточку или нашёл ошибки, портал покажет его тексты.

Выставить новый товар:

1. Добавьте товар: из изделия склада, из модели или с нуля.
2. Нажмите «Выставить на Маркет» и найдите категорию Маркета поиском.
3. Заполните характеристики категории. Обязательные отмечены, для многих есть списки значений.
4. Добавьте фото. Нужны публичные ссылки на изображения.
5. Укажите габариты и вес упаковки, штрихкоды, бренд и страну производства. Для нового товара Маркет требует бренд и описание.
6. Проверьте карточку и нажмите «Выставить».

Отправка идёт через очередь. Маркет применяет изменения до нескольких минут, статус карточки подтягивается сам.

Изделия на складе для новых карточек

При загрузке карточек («Загрузить карточки с Маркета») есть галочка «Создать изделия на складе для новых карточек». Она включена по умолчанию. Для каждой новой карточки, у которой ещё нет связи со складом, портал создаёт изделие на складе готовой продукции. В него попадают:

• название и описание карточки;
• главное фото: оно скачивается к нам;
• цена;
• количество: столько, сколько осталось на Маркете в момент загрузки.

Себестоимость Маркет не знает, поэтому её нужно указать самому. Пока вы этого не сделали, такие изделия на складе подсвечены пометкой «С площадки: проверьте количество и себестоимость», а над списком висит баннер с фильтром. Проверьте изделие и нажмите «Проверено»: подсветка исчезнет.

Товар сразу связан с изделием, поэтому дальше остаток на Маркете идёт со склада. Если тот же артикул есть на другой площадке, изделие будет тем же, дублей не появится. Если снять галочку, изделия не создаются, и товар нужно связать со складом в редакторе самому.

Фото, которые загружены в кабинет Маркета файлом, Маркет отдаёт внутренней ссылкой, и скачать их нельзя. Изделие в этом случае создаётся без фото. Добавьте фото на складе сами.

Выставить и следить за товаром со склада

На складе готовой продукции у изделия есть кнопка «Выставить на маркетплейс»: она открывает мастер выставления. Чтобы сделать товары для площадок сразу из нескольких изделий, нажмите «Создать товары для площадок». В колонке «Площадки» виден статус изделия по каждой площадке.

Панель «Подробнее» у изделия показывает:

• продажи по каналам;
• «хватит на N дней» или «пора допечатать»;
• где изделие выставлено;
• резерв;
• экономику одной штуки;
• кнопку «Допечатать».

7. Цены

Базовая цена задаётся в кабинете на уровне всего бизнеса. Дополнительно можно указать «цену до скидки» (зачёркнутую):

• это целое число;
• скидка должна быть от 5 до 99%, иначе Маркет её не покажет. Портал предупредит, если скидка выходит за эти рамки.

Комиссии и услуги портал считает по калькулятору тарифов Маркета для модели FBS. Это примерная стоимость, окончательные цифры видны в финансах после продажи. В расчёт входят:

• размещение (процент от цены);
• доставка покупателю;
• магистраль;
• обработка;
• перевод платежа.

Из этих удержаний, себестоимости и налога считаются прибыль с одной штуки и цена-пол «не ниже себестоимости». Цену ниже неё выгрузить нельзя. Без себестоимости защита не работает, портал об этом предупреждает.

Если Маркет поместил товар в карантин из-за резкого снижения цены, проверьте и подтвердите цену в кабинете Маркета.

8. Остатки

Остатки уходят на склад продавца (FBS), который вы выбрали в настройках подключения. У каждого товара выберите режим:

Если остаток не определён (товар не связан со складом, поле пустое), портал не трогает остаток на Маркете. Ноль по ошибке не уйдёт. Если в ноль уходит сразу много товаров, портал попросит подтверждения.

Когда уходит остаток. Остаток выгружается по событию: примерно через 10–15 секунд после того, как изменилось количество изделия на складе (продажа, списание под заказ, правка, отмена). Если вы правите количество несколько раз подряд, всё уходит одной отправкой. Кроме того, раз в 5 минут и раз в сутки портал сверяет остатки на всякий случай. Защита от массового обнуления работает по-прежнему.

9. Заказы

Если изделие есть на складе готовой продукции, заказ попадает в колонку «Сборка заказа», а остаток списывается автоматически. При отмене остаток возвращается. Если вы сами передвинули карточку, портал не вернёт её обратно.

Срок отгрузки из заказа попадает в календарь и в «Дела» цветом Маркета.

Действия на Маркете выполняются на странице заказа:

• сборка: раскладка товаров по коробкам и статус «готов к отгрузке»;
• ярлыки PDF: для одного заказа сразу, для нескольких заказов одним файлом. Маркет формирует файл до 30 секунд;
• отмена заказа. Доступна причина «Магазин не может выполнить заказ», а для модели DBS ещё «Не удалось связаться с покупателем». Текст комментария Маркет не принимает.

Коды маркировки «Честный знак» портал не передаёт. Заказы с маркировкой собирайте в кабинете Маркета.

Все действия идут через очередь. Результат и понятная подсказка при ошибке видны в «Журнале».

Отгрузки. Отгрузки со склада продавца создаёт сам Маркет. Вкладка «Отгрузки» показывает их на неделю вперёд. Отгрузку можно подтвердить и скачать акт приёма-передачи. Создать или отменить отгрузку в портале нельзя, это делается в кабинете.

Таблицы с фильтрами и журнал

Вкладки раздела «Маркетплейсы» — «Товары», «Отгрузки», «Возвраты», «Финансы» и «Журнал» — теперь таблицы с фильтрами (площадка, статус, период, поиск) и сортировкой. В «Журнале» видно дату, время и того, кто внёс изменение. Нажмите на запись, и откроется, что именно изменилось.

10. Запросы на отмену и возвраты

Запросы покупателя на отмену Маркет присылает только для модели DBS. Такой заказ получает чип «Просит отмену». Одобрите или отклоните запрос на странице заказа.

Возвраты и невыкупы за последние 30 дней видны списком. У заказа появляется чип возврата. Вернувшийся товар на склад автоматически не приходуется: сначала осмотрите его.

11. Финансы

По каждому заказу портал загружает с Маркета:

• оплату покупателя и возвраты;
• все удержания Маркета по видам: размещение, доставка, магистраль, обработка, перевод платежа и другие;
• баллы и субсидии.

Эти данные попадают в прибыль заказа, и она считается по реальным цифрам.

Юнит-экономика. Во вкладке «Финансы» → «Юнит-экономика» по каждому товару за период видно: сколько продано и возвращено, выручку, удержания площадки по видам (комиссия, логистика, хранение, эквайринг, прочее), себестоимость, прибыль, маржу и прибыль на штуку. Убыточные товары подсвечены красным, таблицу можно скачать в CSV. Себестоимость берётся из карточки заказа, а если её нет — из товара мастерской или склада готовой продукции. Возврат товара возвращает его себестоимость. Начисления, которые площадка не относит ни к товару, ни к заказу, показаны отдельной строкой «Без привязки к товару» и входят в итог. Пока заказ не доставлен, Маркет не присылает оплату — до этого выручка берётся из цены заказа. Удержания заказа из нескольких товаров делятся между ними пропорционально цене.

Начисления, которые не привязаны к заказам (реклама, хранение, подписки), портал пока не загружает. Смотрите их в отчётах кабинета Маркета.

12. Что делается только в кабинете Маркета

• Договор и подключение магазина.
• Настройка складов и графика работы.
• Акции и буст продаж.
• Отзывы, вопросы и чаты (пока).
• Поставки FBY.
• Маркировка «Честный знак».
• Претензии и споры.
• Подтверждение цены после ценового карантина.
• Создание и отмена отгрузок.

13. Частые ошибки

14. Безопасность

• Ключ хранится в зашифрованном виде. В интерфейсе видны только его последние символы.
• Условия работы портала с кабинетом продавца — раздел 12 оферты: портал действует в кабинете только по вашей команде или по правилам, которые вы включили сами.
• Каждый вид записи на Маркет выключен по умолчанию и включается отдельно в настройках подключения.
• Подключение можно поставить на паузу, и запись на Маркет остановится.
• Права в мастерской: «Заказы площадок» — заказы и действия с ними; «Товары на площадках» — товары и карточки; «Финансы площадок» — выплаты и удержания.

15. Изменения

• 01.10.2026 — первая версия инструкции.
• 30.09.2026 — полный цикл: карточки, цены, остатки, сборка, ярлыки, отгрузки, запросы на отмену, возвраты, финансы. Работа сверена с официальным описанием API Маркета, проверка на живом кабинете ещё впереди.
• 30.09.2026 — связка склада и площадки, выгрузка остатков по событию, оповещения в Телеграм, таблицы с фильтрами.