Первые шаги
Как получить API-ключ Яндекс Маркета
Получение Api-Key для подключения Яндекс Маркета к SKUMETR.
Для подключения нужен API-Key из кабинета продавца Яндекс Маркета.
#Получите ключ
- В кабинете продавца откройте меню аккаунта → «Настройки» → «API и модули».
- В блоке «Токены авторизации» нажмите «Создать новый токен».
- Укажите название «SKUMETR» и нужные права, создайте токен и скопируйте его целиком.
Создавать токены могут владелец и менеджер кабинета. Порядок описан в официальной инструкции Яндекс Маркета.
| Задача | Доступ |
|---|---|
| Загружать товары, заказы, остатки и финансовые данные | «Просмотр всех данных» |
| Также отправлять общий остаток из SKUMETR | Дополнительно «Управление товарами и карточками» |
Доступ только для чтения не разрешает отправку остатков. Вместо просмотра всех данных можно выбрать отдельные группы чтения, но тогда нужны права на каждый используемый раздел. Группы доступов и права для отправки остатков описаны у Маркета.
#Подключите магазин
- В SKUMETR откройте Яндекс Маркет → Настройки и нажмите «+» в заголовке.
- Заполните «Название магазина» и «API-ключ». Нужен только сам ключ, без «Api-Key:», «Bearer» и кавычек.
- Если нужно ограничить загрузку, раскройте «Кабинет и магазин» и заполните идентификаторы по пояснению ниже. Для первого подключения их можно оставить пустыми.
- Выберите нужные пункты автообновления и нажмите «Сохранить и проверить».
- Закройте форму, нажмите «Синхронизация» на карточке магазина и дождитесь загрузки.
Проверка получает список доступных магазинов и сверяет указанные идентификаторы. Она не подтверждает доступ к каждому отчёту или отправке остатков.
#Когда нужны идентификаторы
«ID кабинета» — это businessId. «ID магазина (campaignId)» — технический идентификатор магазина для API. Без этих ограничений SKUMETR загружает доступные ключу магазины.
Найдите campaignId в кабинете Маркета: «API и модули» → «Идентификатор кампании». Не используйте номер рядом с названием магазина или номер рекламной кампании: это другие значения. Пояснение Маркета об идентификаторе.
Если указаны оба поля, они должны относиться к одному кабинету и магазину. При редактировании пустые поля сохраняют прежние значения, а не снимают ограничение.
#Замените ключ
API-Key действует, пока его не удалят. После изменения прав в Маркете дождитесь их применения — это может занять до 10 минут.
Для замены в SKUMETR нажмите «Изменить» у существующего магазина, вставьте новый «API-ключ» и нажмите «Сохранить и проверить». Пустое поле сохраняет прежний ключ. После успешной загрузки удалите старый ключ в Маркете, если он больше не используется. Подключение и загруженные данные удалять не нужно.
#Если возникла ошибка
- 401: проверьте полноту API-Key, выбранный кабинет и отзыв ключа.
- 403: проверьте права, идентификаторы и доступность API в кабинете Маркета. После изменения прав подождите до 10 минут.
- Нет журнала или товаров: проверьте права нужного раздела и результат обновления.
- Остатки не отправляются: нужны право записи и выбранный склад общего остатка.
Храните ключ как пароль. При утечке удалите его в Маркете и создайте новый.
Была ли статья полезна?
Загружаем ваш ответ…