MarkerViewДокументацияМаркетплейсы
Разделы документации

Маркетплейсы

Подключение Ozon

Доступ к отзывам Ozon, API-ключи, подписка площадки и проверка первой синхронизации.

MarkerView подключается к Ozon по паре Client ID + API key. В облачной версии эти значения вводятся в кабинете MarkerView — редактировать .env, запускать команды или обращаться к серверу не требуется.

Что проверить в Ozon

Откройте настройки интеграций в кабинете продавца Ozon и найдите раздел Seller API. Названия и расположение пунктов Ozon может менять, поэтому сверяйтесь с актуальной официальной документацией Seller API, а не со старыми скриншотами.

  1. Проверьте в кабинете Ozon, доступен ли вашему тарифу или подписке API отзывов в данный момент. Условия доступа меняются, поэтому MarkerView не привязывает инструкцию к устаревающему названию тарифа.
  2. Создайте ключ с минимально необходимыми правами: доступ к отзывам; доступ к товарам для сопоставления SKU Ozon с вашим offer_id; доступ к вопросам — только если планируете работать с вопросами покупателей.
  3. Скопируйте Client ID и API key. Ключ храните в менеджере паролей: не пересылайте его, не публикуйте в заявках и не показывайте полностью на скриншотах.

Если Ozon не даёт выбрать нужные права или методы отзывов недоступны, сначала уточните текущие условия в кабинете или поддержке Ozon. MarkerView не может обойти ограничения Seller API.

Подключить источник

  1. В MarkerView откройте Маркетплейсы.
  2. В карточке Ozon заполните Client ID и API key.
  3. Нажмите Сохранить доступы.
  4. Включите Ozon переключателем в заголовке карточки. Ozon изначально может быть выключен.
  5. Нажмите Синхронизировать в карточке Ozon.

Ожидаемый результат: карточка показывает «Доступы сохранены» и «Готов к синхронизации», а запуск подтверждается уведомлением. Проверяйте появление данных в разделе отзывов. MarkerView получает только те записи и поля, которые возвращает доступный вашему кабинету Ozon API; полный архив и все вложения не гарантируются.

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

Почему важно право на товары

В отзыве Ozon приходит внутренний SKU площадки, а на сайте магазина товар обычно обозначен собственным артикулом offer_id. MarkerView запрашивает каталог Ozon и строит соответствие SKU → offer_id. Без доступа к товарам отзывы могут загрузиться, но остаться привязанными к SKU Ozon, поэтому на карточке вашего сайта будет показано «0 отзывов».

После добавления права на товары замените или обновите ключ и снова запустите синхронизацию: MarkerView повторно сопоставляет уже полученные записи. Затем проверьте каталог сайта.

Состояния и частые ошибки

  • «Не настроен» — не сохранён Client ID или API key.
  • «Отключён» — доступы есть, но источник не участвует в синхронизации.
  • «Проверьте доступы» — MarkerView не смог прочитать список товаров. Обычно ключу не хватает соответствующего права, ключ отозван либо Client ID и ключ относятся к разным кабинетам.
  • Ошибка 401 указывает на неверные или отозванные реквизиты; 403 чаще связан с правами или недоступностью метода для аккаунта.
  • Если источник успешно подключён, но отзывы не загружаются, ещё раз проверьте доступ к API отзывов в текущей подписке Ozon.
  • Сообщение «Уже выполняется» означает, что нужно дождаться текущего запуска, а не нажимать кнопку повторно.

Переключатель Публикация ответов разрешает отправлять ответы из MarkerView в Ozon. Включайте его осознанно и только при наличии нужных прав. Одна карточка Ozon хранит доступ одного кабинета продавца; для второго кабинета используйте отдельный аккаунт MarkerView.