Перейти к содержимому
Разделы
Содержание

Первые шаги

Как получить API-ключ Яндекс Маркета

Получение Api-Key для подключения Яндекс Маркета к SKUMETR.

Для подключения нужен API-Key из кабинета продавца Яндекс Маркета.

#Получите ключ

  1. В кабинете продавца откройте меню аккаунта → «Настройки» → «API и модули».
  2. В блоке «Токены авторизации» нажмите «Создать новый токен».
  3. Укажите название «SKUMETR» и нужные права, создайте токен и скопируйте его целиком.

Создавать токены могут владелец и менеджер кабинета. Порядок описан в официальной инструкции Яндекс Маркета.

ЗадачаДоступ
Загружать товары, заказы, остатки и финансовые данные«Просмотр всех данных»
Также отправлять общий остаток из SKUMETRДополнительно «Управление товарами и карточками»

Доступ только для чтения не разрешает отправку остатков. Вместо просмотра всех данных можно выбрать отдельные группы чтения, но тогда нужны права на каждый используемый раздел. Группы доступов и права для отправки остатков описаны у Маркета.

#Подключите магазин

  1. В SKUMETR откройте Яндекс Маркет → Настройки и нажмите «+» в заголовке.
  2. Заполните «Название магазина» и «API-ключ». Нужен только сам ключ, без «Api-Key:», «Bearer» и кавычек.
  3. Если нужно ограничить загрузку, раскройте «Кабинет и магазин» и заполните идентификаторы по пояснению ниже. Для первого подключения их можно оставить пустыми.
  4. Выберите нужные пункты автообновления и нажмите «Сохранить и проверить».
  5. Закройте форму, нажмите «Синхронизация» на карточке магазина и дождитесь загрузки.

Проверка получает список доступных магазинов и сверяет указанные идентификаторы. Она не подтверждает доступ к каждому отчёту или отправке остатков.

#Когда нужны идентификаторы

«ID кабинета» — это businessId. «ID магазина (campaignId)» — технический идентификатор магазина для API. Без этих ограничений SKUMETR загружает доступные ключу магазины.

Найдите campaignId в кабинете Маркета: «API и модули» → «Идентификатор кампании». Не используйте номер рядом с названием магазина или номер рекламной кампании: это другие значения. Пояснение Маркета об идентификаторе.

Если указаны оба поля, они должны относиться к одному кабинету и магазину. При редактировании пустые поля сохраняют прежние значения, а не снимают ограничение.

#Замените ключ

API-Key действует, пока его не удалят. После изменения прав в Маркете дождитесь их применения — это может занять до 10 минут.

Для замены в SKUMETR нажмите «Изменить» у существующего магазина, вставьте новый «API-ключ» и нажмите «Сохранить и проверить». Пустое поле сохраняет прежний ключ. После успешной загрузки удалите старый ключ в Маркете, если он больше не используется. Подключение и загруженные данные удалять не нужно.

#Если возникла ошибка

  • 401: проверьте полноту API-Key, выбранный кабинет и отзыв ключа.
  • 403: проверьте права, идентификаторы и доступность API в кабинете Маркета. После изменения прав подождите до 10 минут.
  • Нет журнала или товаров: проверьте права нужного раздела и результат обновления.
  • Остатки не отправляются: нужны право записи и выбранный склад общего остатка.

Храните ключ как пароль. При утечке удалите его в Маркете и создайте новый.

Настройки Яндекс Маркета