Ключ Яндекс Маркета

Работа с Яндекс Маркетом FBS — бета-версия: первый сбор Маркета Биркадо проверяет вместе с вами, и до проверки коды Маркета в документы не входят.

Ключ Яндекс Маркета — ключ API, по которому Биркадо читает данные вашего кабинета Маркета: заказы FBS и Экспресс, коды маркировки в них, невыкупы и возвраты, а из каталога — фото, бренд и штрихкод товаров. Сервис только читает: менять что-то в Маркете он не будет.

Как выпустить ключ

1. Войдите в кабинет продавца Яндекс Маркета.
2. Откройте Настройки → API и модули → Токены авторизации.
3. Нажмите «Создать токен», название — «Биркадо».
4. Доступы — Просмотр информации о заказах и Просмотр товаров и карточек. Нужны оба: первый открывает заказы, коды и возвраты, второй — фото товаров из каталога.
5. Скопируйте ключ.

Ключ выдаётся на кабинет Маркета и действует, пока вы его не удалите.

Куда вставить

Владелец или администратор организации вставляет ключ в «Настройки → Подключения → Яндекс Маркет» и нажимает «Проверить и сохранить». На первой настройке ключ вставляется в карточку организации (строка Яндекс Маркета → «Подключить» → «Проверить»).

Сервис проверит ключ:

• доступ к заказам и магазины FBS кабинета с открытым API;
• доступ к товарам и карточкам — без него ключ не сохранится;
• ИНН магазина — по отчёту Маркета по заказам: в API Маркета ИНН нет. Отчёт Маркет готовит до полутора минут — дождитесь конца проверки.

ИНН магазина должен совпасть с ИНН организации. Магазин другого юрлица сервис предложит вынести в новую организацию.

Отчёт по заказам Маркет даёт заказать раз в две минуты. Если вы нажали «Проверить» ещё раз, сервис возьмёт уже заказанный отчёт; если Маркет всё-таки не дал отчёт, сервис так и скажет — повторите проверку через две минуты.

Если в кабинете Маркета магазины нескольких юрлиц, сервис возьмёт только магазины ИНН вашей организации, а остальные назовёт в карточке Маркета: «Другое юрлицо: не собираются». Завести организацию по ключу такого кабинета нельзя — заведите её по ключу WB или Ozon и подключите Маркет в её карточке.

Если у магазина не было заказов за 90 дней, Маркет не назовёт ИНН. Тогда завести организацию по ключу Маркета нельзя: заведите её по ключу WB или Ozon и подключите Маркет в её карточке. В готовой организации такой ключ сохранится, а ИНН сервис узнает по первому отчёту с заказами.

Сразу после сохранения начинается первый сбор Маркета — заказы за последние 90 дней (на тарифе «Старт» — 30, на «Бизнесе» — 60).

Что сервис берёт

• Модели FBS и Экспресс. DBS и FBY сервис не берёт.
• Коды из заказов. Код попадает в сервис, только если вы внесли его в заказ при сборке. Для заказов физлиц Маркет этого не требует, но без кода в заказе вывести код сервис не сможет: такие заказы видны в карточке подключения — «уехали без кода», а кнопка «Показать заказы» откроет их список с номером, датой и товаром.
• Невыкупы и возвраты — с кодом каждого экземпляра и его судьбой: выдан магазину, принят на складе Маркета, утилизирован.
• Фото, бренд и штрихкод товаров из каталога Маркета — для карточки кода и таблицы «Все коды». Цены и себестоимость сервис не берёт.

Если ключ подключён до 29 октября 2026 года

Ключи, подключённые до 29.10.2026, сервис просил с одним доступом «Просмотр информации о заказах». Такой ключ работает: заказы, коды и возвраты собираются, но фото товаров у кодов Маркета нет — в карточке подключения строка «Фото товаров: нет доступа «Просмотр товаров и карточек»». Чтобы фото появились, выпустите ключ с обоими доступами и нажмите «Заменить ключ» в «Настройки → Подключения → Яндекс Маркет»: собранные данные, документы и настройки сохранятся, фото подтянутся в следующем сборе.

Если ключ не работает

Ключ удалили в кабинете Маркета или Маркет закрыл магазину API — сбор Маркета останавливается, на экранах организации появляется полоса «Ключ Маркета не работает», владельцу приходит письмо. Выпустите новый ключ и нажмите «Заменить ключ»: собранные данные, документы и настройки сохранятся.