Чтобы вы смогли начать пользоваться нашими отчетами нам нужен API доступ к вашим данным, делается это в 2 простых шага

• Создать ваш АПИ-ключ(и) (они же токены) в вашем Личном Кабинета поставщика Вайлдберриз
• Вставить его в раздел «АПИ ключи» в Личном Кабинете сервиса PI-Data

Какие ключи мы просим?

Сначала немного теории (но ее можно и пропустить) — с 28 ноября 2023 года ВБ позволяет гибко настраивать права доступа АПИ ключей: на что именно (выбрать категории) и какие права у них будут. И теперь это надо указывать при создании любого ключа. Категорий много, ниже мы перечислим только те, которые нужны для работы нашего сервиса (у всех категорий нам нужен доступ только на чтение, т.к. мы ничего не меняем в данных)

• Контент — предоставляет нам доступ к полезной и корректной информации о товарах. Теперь мы можем видеть информацию о товарах, даже если они еще не были проданы, что позволяет нам более точно анализировать данные. Кроме того, данное обновление помогает избежать проблем с неправильным определением бренда товара.
• Статистика — эта категория открывает нам доступ к вашим данным по торговле FBW: заказы, продажи, остатки, поставки, остатки и отчеты по реализации
• Аналитика — забираем отсюда данные по хранению
• Продвижение — отсюда мы получаем информацию о ваших рекламных активностях и расходах
• Цены и скидки — отсюда мы получаем данные по ценам на ваши товары. ВАЖНО: мы не просим доступ на запись, можете быть спокойны — мы не сможем установить цены/скидки на ваши товары
• Маркетплейс — отсюда мы получаем информацию о ваших продажах по модели FBS (если вы не работаете по этой модели, то мы ничего не получим)

В итоге нам нужен ключ с правами на чтение к шести категориям: «Контент», «Статистика», «Аналитика», «Продвижение», «Цены и скидки» и «Маркетплейс». По этому ключу невозможно ничего отредактировать (нет прав на запись) — в частности Цены и Скидки в безопасности

Как создать АПИ ключ для нашего сервиса?

АПИ ключ создается в личном кабинете на ВБ Профиль —> Настройки —> Доступ к API (важно — выпускать ключи, они же токены, может только владелец кабинета)

Инструкция для создания нового ключа

• В разделе Доступ к API нажмите на кнопку «Создать новый токен» (токен = АПИ ключ)

• Заполните появившееся окно как показано на картинке ниже
  • Задайте имя токена, например, «pi-data» (т.к. ключей у вас может быть много и надо будет в них ориентироваться, например, чтобы быстро отключить какой-то из токенов, то рекомендуем их называть просто и понятно)
  • Поставьте галочку «только на чтение»
  • Важно: Галочку «Тестовый контур» ставить НЕ нужно.
  • Обязательно выберите шесть категорий: Контент, Маркетплейс, Статистика, Аналитика, Продвижение, Цены и скидки

• Еще раз проверьте, что у вас отмечены все шесть категорий, без них наш сервис не примет ваш токен (и подсветит какой категории вам не хватает)
  • Вы увидите предупреждение «Вы собираетесь добавить более двух опций в один токен…» — это хорошее замечание, но в данном случае мы объяснили вам зачем мы просим сразу 5 опций и для чего, дробить этот ключ на два не имеет смысла, поэтому это предупреждение игнорируйте
• Нажмите «Создать токен» и сразу скопируйте токен и вставьте в наш сервис, потому что он отображается только в момент создания! (мы не рекомендуем его где-либо записывать и сохранять, т.к. это опять-таки небезопасно — лучше при необходимости его перевыпустить, вас в этом никто не ограничивает)

Примечание от команды: таким способом вы можете создавать любое количество ключей (в пределах лимита ВБ — в марте 2024 лимит равнялся 20 токенам), и мы рекомендуем делать разные ключи для разных сервисов аналитики и программ, с которыми вы работаете.

На это есть как минимум 3 причины, связанные с безопасностью:
— в случае проблем вы сможете быстро отключить любой сервис, которые вызывает подозрения, и не придется менять ключи везде
— по истории вы сможете понять, какой сервис (если вдруг такое случится) что-то «накосячил»
— для каждого сервиса вы выдаете минимум необходимых прав

Как добавить АПИ ключ в наш сервис?

Для этого вам понадобятся

• Доступ в сервис pi-data в раздел API ключи
• АПИ ключи из ЛК ВБ — либо кто-то вам их прислал, либо вы можете сделать их самостоятельно (по инструкции ниже)

В нашем сервисе перейдите в раздел API ключи и нажмите на кнопку «+», появится новая строка для указания поставщика и ввода ключа:

В появившейся строке укажите название поставщика (по этому имени вы впоследствии сможете фильтровать данные — важно, если у вас будет более одного поставщика) и вставьте ключ. После этого нажмите галочку для добавления

После этого система проверит ваши ключи и либо вы увидите сообщение, что мы «запускаем» загрузку данных, либо система выдаст сообщение об ошибке (например, ошибка формата ключа или недостаточно прав или что данный поставщик уже добавлен в систему). Если не получится устранить ошибку самостоятельно, то обязательно обратитесь в техническую поддержку (чат в правом нижнем углу экрана)

Если ошибок нет и запуск прошел успешно, то ключ получит зеленый статус работает — значит все прошло хорошо и скоро данные появятся в системе. О том как быстро это происходит — читайте тут

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

Состояния ключей и их редактирование

Вы можете увидеть следующие состояния ваших Ключей:
— «Запускаем», голубой: мы запрашиваем данные по ключам и проверяем их работу, занимает несколько первых минут
— «Работает», зеленый: все в порядке, все работает стабильно
— «Отключен», голубой: появляется, когда вы ставите загрузку на паузу
— Красный: данные не загружаются/ ключ не прошел проверку инициализации. Проверьте ключи, возможно, они поменялись и вам нужен новый.
— Желтый: данные не загружаются/временная ошибка.

Действующие ключи можно:
— редактировать (значок карандаша), когда вам нужно обновить ключ поставщика или, например, исправить ошибку в его имени
— временно остановить загрузку данных
— удалить
ВАЖНО: будьте внимательны при удалении, все раннее загруженные данные по поставщику удаляются без возможности восстановления