Ключ Яндекс.Маркета: как создать и какие доступы нужны
Обновлено · Команда «В плюсе»
Ключ Partner API — это доступ, которым сервис читает ваш кабинет Яндекс.Маркета: заказы всех витрин с их услугами, товары, остатки, отчёты по услугам и взаиморасчётам, буст продаж. Ключ один — ни номер кабинета, ни номера магазинов вводить не нужно: сервис читает их по самому ключу.
Как создать ключ
- 1
Откройте «Настройки → Токены авторизации»
В кабинете partner.market.yandex.ru и нажмите «Создать». - 2
Дайте токену имя
Любое, например «В плюсе», — чтобы потом отличать его от других токенов кабинета. - 3
В «Какие доступы предоставить?» выберите «Просмотр всех данных»
Это all-methods:read-only — права только на чтение. Изменить что-либо в вашем кабинете с таким токеном невозможно. Если открывать всё не хочется, ниже есть проверенный узкий набор. - 4
Включите «Бессрочный токен»
Не для удобства: срок жизни ключа Маркет по API не сообщает вовсе, и предупредить вас за 10 дней, как мы делаем с токеном Wildberries, не получится. Ключ со сроком однажды перестанет работать молча. - 5
Скопируйте ключ целиком, вместе с «ACMA:» в начале
Маркет показывает его один раз. Потерянный ключ не восстанавливается — создаётся новый.
Регистр «ACMA:» можно не выверять
Префикс у Маркета регистрозависим, и часть буферов обмена его портит — поэтому его регистр мы чиним сами. А вот остальную строку не трогаем: она тоже регистрозависима, и «на всякий случай» привести её к одному регистру значило бы сломать рабочий ключ.Какие доступы отметить
По умолчанию мы советуем «Просмотр всех данных»: там нечего пропустить. Если слово «всех» смущает, выберите «Только выбранные» и отметьте все четыре доступа — этот набор мы прогнали на живом кабинете, он покрывает всё, что сервису нужно.
| Доступ в кабинете Маркета | Что открывает |
|---|---|
| Просмотр информации о заказах inventory-and-order-processing:read-only | Заказы и их экономика, возвраты, остатки |
| Просмотр товаров и карточек offers-and-cards-management:read-only | Справочник товаров |
| Просмотр информации о продвижении товаров promotion:read-only | Буст продаж: показы и клики |
| Просмотр финансовой информации и отчётности finance-and-accounting | Отчёты по услугам и взаиморасчётам |
Отметьте все четыре — пропущенный доступ ломает тихо
Ключ создастся и магазин подключится в любом случае. Просто часть данных не придёт: расходы не попадут в прибыль, и она окажется выше настоящей. Ошибку не видно ни вам, ни нам. Сомневаетесь — берите «Просмотр всех данных», там ошибиться нечем.Безопасно ли отдавать ключ
И «Просмотр всех данных», и узкий набор — доступы только на чтение. С таким ключом нельзя изменить цену, остатки, карточку товара или статус заказа: изменяющих методов у него нет вовсе, а не «мы обещаем ими не пользоваться».
- Ключ хранится зашифрованным и нигде в интерфейсе не показывается — даже вам.
- Пишущий доступ к настройкам магазина мы не просим: read-only варианта у него нет, а менять в вашем кабинете нам нечего.
- Отозвать доступ можно в любой момент — удалите токен в кабинете Маркета. Сервис перестанет получать данные, уже загруженные останутся.
Кабинет и магазины — это разные номера
У Маркета две сущности, и в интерфейсе обе называются «номер». Кабинет — это ваш бизнес, на него выдаётся ключ. Магазины внутри него — это витрины: FBY, FBS, DBS и Экспресс. Ключ видит их все, поэтому подключается кабинет целиком, а не витрина по отдельности.
Слот занимает кабинет, а не витрина
Четыре витрины одного кабинета — это один магазин в вашей подписке, а не четыре. Подробности про слоты — в статье об оплате.Если ключ видит несколько кабинетов, форма покажет их списком и попросит выбрать. Мы не выбираем за вас: слот считается по кабинету, и списать его за не тот было бы обидно.
Частые ошибки
- «Ключ не подошёл» — чаще всего скопирована не вся строка. Проверьте, что «ACMA:» в начале на месте: Маркет показывает ключ один раз, и хвост легко потерять при выделении.
- «Ключ рабочий, но магазинов в нём нет» — токен создан в другом кабинете. Откройте «Токены авторизации» в том кабинете, чьи магазины хотите подключить.
- Данные пришли не полностью — обычно это пропущенный доступ. Проще всего создать новый токен с «Просмотром всех данных» и заменить его кнопкой «Заменить ключ» на карточке магазина. Заказы, закупочные цены и история сохранятся.
- «Кабинет уже подключён к другому аккаунту» — один кабинет Маркета привязывается только к одному аккаунту «В плюсе». Если кабинет ваш и доступ к старому аккаунту утрачен, напишите нам через контакты — поддержка отвяжет его.
- Новый ключ не принимается при замене — он должен видеть тот же кабинет, что и подключённый магазин. Чтобы подключить другой кабинет, добавьте отдельный магазин.
Что происходит дальше — в статье «Раздел „Магазины“», а куда уходят деньги на Маркете — «Услуги и удержания».
Читайте также
Посмотрите на своих цифрах
Прикиньте прибыль по своему товару прямо на калькуляторе — без регистрации и карты.