Первые шаги
Начало работы
Подключите Ozon, Яндекс Маркет или Wildberries и дождитесь первой синхронизации.
#Подключите первый магазин
Для начала достаточно одного маркетплейса.
- Создайте ключ по инструкции своей площадки ниже.
- В SKUMETR откройте Ozon, Wildberries или Яндекс Маркет → Настройки. Нажмите «+» в заголовке — «Добавить магазин».
- Укажите «Название магазина» и доступы: для Ozon — Client ID и API-ключ, для Wildberries — API-токен, для Яндекс Маркета — API-ключ.
- Нажмите «Сохранить и проверить». Настройки сначала сохраняются, затем проверяется доступ. Если проверка завершилась ошибкой, исправьте ключ или его права и повторите её.
- Закройте форму и нажмите «Синхронизация» на карточке магазина для первой общей загрузки. Дождитесь завершения задачи и проверьте товары, заказы и журнал.
Успешная проверка подключения не подтверждает права на каждый отчёт и отправку остатков. Проверяйте результат загрузки нужных разделов.
#Настройте автообновление
В форме подключения три независимых пункта:
- «Общее обновление» — общий цикл загрузки данных.
- «Заказы» — отдельное расписание обновления заказов.
- «Товары, цены и остатки» — отдельное обновление каждый час или каждые 12 часов.
Первая галочка не включает остальные. Изменения действуют после сохранения. При включении обновления товаров первая загрузка ставится в очередь сразу. Если общее автообновление выключено, сохранение подключения само по себе не запускает общую загрузку.
«Сохранить» доступно, когда есть корректные несохранённые изменения. «Отменить» закрывает форму без сохранения. Статус магазина виден на карточке, а даты обновлений и текущие задачи — по кнопке «!» рядом с названием.
#Получите ключ своей площадки
Для подключения нужны Client ID и API-ключ Seller API из одного кабинета Ozon. Рекламные ключи добавляются отдельно и для первого запуска не нужны.
#Получите ключ в Ozon Seller
- Откройте нужный кабинет: Настройки → Seller API. В меню Ozon этот раздел также может называться «API ключи».
- Скопируйте Client ID.
- Нажмите «Сгенерировать ключ», задайте название «SKUMETR» и выберите права для используемых функций.
- Создайте ключ и сразу скопируйте его: повторно показать секрет Ozon не позволяет.
Для загрузки данных нужен доступ к чтению товаров, цен, остатков, складов, заказов, возвратов и финансов. Доступ только к товарам не подходит для всех разделов SKUMETR. Для передачи общего остатка из SKUMETR в Ozon дополнительно нужно право изменения остатков.
Если ограничены разрешённые сети, уточните адреса серверов у поддержки SKUMETR. Адрес вашего компьютера не подходит для серверной интеграции.
Порядок выпуска ключа описан в официальной инструкции Ozon.
#Подключите магазин
- В SKUMETR откройте Ozon → Настройки и нажмите «+» в заголовке.
- Заполните «Название магазина», Client ID и «API-ключ». Вставляйте только значение ключа, без подписей и кавычек.
- При необходимости включите нужные пункты «Автообновления». Каждый включается отдельно.
- Нажмите «Сохранить и проверить». Проверка обращается к списку товаров Seller API; она не проверяет все отчёты, права записи и рекламу.
- Закройте форму, нажмите «Синхронизация» на карточке магазина и дождитесь загрузки.
#Рекламная статистика
Если нужны рекламные отчёты, раскройте «Реклама» и укажите пару Performance Client ID и Performance Client Secret из Performance API. Для нового рекламного доступа нужны оба поля. Эти ключи отличаются от Seller API.
Отчёты загружаются при общей синхронизации. Их применение в расчёте прибыли ещё готовится. Кнопка «Сохранить и проверить» проверяет только Seller API. Подробнее — Performance API Ozon.
#Замените ключ без потери данных
Ориентируйтесь на срок, указанный при выпуске ключа в Ozon, и заменяйте его заранее. В карточке магазина нажмите «Изменить», вставьте новый ключ и нажмите «Сохранить и проверить». Пустое поле ключа сохраняет прежнее значение. После успешной загрузки с новым ключом отзовите старый, если он больше не используется.
Удалять подключение или очищать данные для замены ключа не нужно.
#Если возникла ошибка
- Ошибка авторизации: проверьте полноту ключа, срок и соответствие Client ID выбранному кабинету.
- Нет доступа: проверьте права ключа и ограничения по сетям.
- Товары загрузились, а журнал или заказы нет: проверьте права нужного раздела и результат его обновления.
- Остатки не отправляются: проверьте право изменения остатков и выбранный склад общего остатка.
Храните ключ как пароль. При утечке отзовите его в Ozon и создайте новый.
Для подключения нужен 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 минут.
- Нет журнала или товаров: проверьте права нужного раздела и результат обновления.
- Остатки не отправляются: нужны право записи и выбранный склад общего остатка.
Храните ключ как пароль. При утечке удалите его в Маркете и создайте новый.
Для подключения нужен отдельный API-токен Wildberries с правами на используемые данные.
#Выберите тип токена
- Сервисный — для конкретного сервиса из Каталога решений WB. Выбирайте SKUMETR, только если он доступен в каталоге; токен другого сервиса не подходит.
- Базовый — для ручного подключения, когда сервисный вариант недоступен. У него могут быть ограничения методов и частоты запросов.
- Персональный предназначен для собственной инфраструктуры продавца и не подходит для облачного SKUMETR.
- Тестовый работает с тестовыми данными.
Правила типов описаны в справке WB о подключении по API.
#Создайте токен
- В нужном профиле WB Partners откройте «Интеграции по API» и создание токена.
- Выберите нужный сервис из каталога либо ручную интеграцию с базовым токеном. Назовите токен «SKUMETR».
- Проверьте категории доступа по таблице ниже.
- Для загрузки данных выберите «Только чтение». Для отправки остатков из SKUMETR нужно «Чтение и запись».
- Создайте и сразу скопируйте токен: повторно посмотреть секрет нельзя.
| Категория | Для чего нужна в SKUMETR |
|---|---|
| Контент | Карточки и штрихкоды товаров |
| Цены и скидки | Цены |
| Аналитика | Остатки каталога |
| Маркетплейс | Склады и остатки продавца; отправка остатков при праве записи |
| Статистика | Загрузка заказов |
| Финансы | Финансовые отчёты и журнал |
Для всех этих разделов нужны все шесть категорий. «Статистика» не заменяет «Аналитику». Выбор категорий не отменяет ограничения типа токена.
#Подключите магазин
- В SKUMETR откройте Wildberries → Настройки, нажмите «+» в заголовке.
- Заполните «Название магазина» и «API-токен». Вставьте токен целиком, без подписи «Authorization:».
- Выберите нужное автообновление и нажмите «Сохранить и проверить».
- Раскройте «Права токена»: здесь показаны тип, категории, режим доступа, срок и предупреждения по сохранённому токену.
- Закройте форму и нажмите «Синхронизация» на карточке магазина. Проверьте результат загрузки товаров, заказов и журнала.
Проверка подключения подтверждает ответ WB на проверочный запрос. Она не загружает товары и остатки и не проверяет все финансовые методы или права записи. Диагностика показывает сведения из сохранённого токена; сообщение «Права на загрузку есть» не гарантирует успешную загрузку каждого раздела.
#Замените токен
Токены WB действуют 180 дней. Выпустите новый заранее; порядок создания и замены есть в инструкции WB.
В SKUMETR нажмите «Изменить» у существующего магазина, вставьте новый токен и выберите «Сохранить и проверить». Пустое поле сохраняет старый токен. После успешной загрузки отзовите прежний токен, если он больше не используется. Подключение и загруженные данные удалять не нужно.
#Если возникла ошибка
- 401: проверьте полноту токена, срок и отзыв.
- 403: проверьте категории, тип токена и соответствие сервису.
- 429: дождитесь снятия ограничения WB; частые повторные проверки не помогут.
- Не хватает данных: сопоставьте отсутствующий раздел с таблицей категорий и проверьте результат его обновления.
Не отправляйте токен в переписке и не вставляйте его в сторонние декодеры. При утечке отзовите токен в WB и создайте новый.
Была ли статья полезна?
Загружаем ваш ответ…