Подключение маркетплейса: настройки, статусы и журнал
Все параметры подключения Ozon и Wildberries, статусы подключения и счётчики журнала запусков
Справочник описывает подключение маркетплейса в разделе Расширения → Интеграции: параметры формы, статусы подключения и записи журнала запусков. Настройки хранятся у каждого подключения отдельно, поэтому два кабинета одного маркетплейса настраиваются независимо.
Статусы подключения
| Статус | Когда возникает | Что дальше |
|---|---|---|
| Черновик | Подключение создано, но ещё не сохранено с полными данными | Переходит в Включена или Отключена при сохранении |
| Включена | Подключение сохранено и участвует в плановой синхронизации | Остаётся, пока не выключено вручную или не отклонено маркетплейсом |
| Ошибка | Маркетплейс отверг учётные данные при синхронизации (401 или 403) | Не синхронизируется. Возвращается в Включена после обновления учётных данных и включения |
| Отключена | Выключено переключателем в шапке формы | Плановые и ручные запуски не выполняются |
| В архиве | Подключение удалено кнопкой архивации | Не восстанавливается. Учётные данные, созданные вместе с ним, архивируются, если их не используют другие подключения |
Общие действия
| Действие | Где | Что делает |
|---|---|---|
| Запустить сейчас | Карточка подключения | Ставит внеочередную синхронизацию в очередь, минуя расписание. Недоступно для выключенного подключения и во время паузы по лимиту маркетплейса |
| Журнал запусков | Карточка подключения | Открывает журнал, отфильтрованный по этому подключению |
| Сбросить состояние | Карточка подключения | Очищает курсоры, отметки об ошибках и паузу по лимитам. Следующий запуск начинает импорт заново с глубины первого импорта |
Параметры
- Ozon
- Wildberries
| Настройка | Тип | По умолчанию | Описание |
|---|---|---|---|
| Отзывы | Переключатель | Включено | Главный переключатель импорта. Выключен — плановые запуски пропускают подключение, остальные параметры блока скрыты |
| Какие отзывы импортировать | Список | Все | Фильтр по статусу отзыва в кабинете Ozon: Все, Необработанные, Просмотренные, Обработанные |
| Статус создаваемых отзывов | Список | Опубликован | Статус, с которым отзыв создаётся в Aplaut: Опубликован или Ожидает модерации. Применяется только к новым отзывам, статусы уже импортированных не меняются |
| Ответы продавца | Список | При каждой синхронизации | Забирать ли с Ozon ответы, оставленные продавцом в кабинете: При каждой синхронизации, Только при первом импорте отзыва, Никогда |
| Имя автора отзыва | Строка | Пусто | Подставляется как автор импортированных отзывов. Ozon не передаёт имена покупателей. Пустое значение даёт «Аноним» |
| Имя автора ответа продавца | Строка | Пусто | Подставляется как автор ответов продавца, импортированных с Ozon. Пустое значение даёт «Аноним» |
| Глубина первого импорта, дней | Число, 1–720 | 90 | Период, за который первый запуск забирает отзывы |
| Частота синхронизации | Список | Каждый час | Интервал планового запуска: 1, 3, 6, 12 или 24 часа |
| Игнорировать отзывы без текста | Переключатель | Включено | Отзыв с пустым текстом не импортируется |
| Если товара из отзыва нет в базе | Список | Создать отзыв без товара | Поведение, когда артикул продавца из отзыва не найден среди товаров компании: Создать отзыв без товара, Не создавать отзыв, Запросить товар из Ozon |
| Вопросы и ответы | Переключатель | Выключено | Недоступно, помечено «Скоро» |
| Отправка ответов | Переключатель | Выключено | Первый комментарий к отзыву публикуется на Ozon как официальный ответ продавца |
| Когда отправлять | Список | После публикации комментария | Момент отправки: Сразу после создания комментария или После публикации комментария |
| Отмечать отзыв обработанным | Переключатель | Включено | После отправки ответа отзыв в кабинете Ozon получает статус «Обработан» |
Учётные данные новое подключение получает от Ozon: продавец устанавливает приложение Aplaut в кабинете продавца, и набор Ozon (OAuth) создаётся сам. Вручную он не заполняется, платформа обновляет токены по мере истечения. Установку можно начать и из Aplaut — кнопкой Подключить через Ozon в шаге Учётные данные; порядок описан в инструкции как подключить Ozon или Wildberries.
Приложение получает доступ к отзывам, вопросам, рейтингу, чату и чтению товаров.
Сообщения, которыми заканчивается неудачная выдача доступа:
| Сообщение | Что произошло |
|---|---|
| Доступ не выдан — подтвердите его в Ozon и попробуйте ещё раз | Продавец отказал в доступе или закрыл окно Ozon |
| Ozon выдал недостаточно прав для работы с отзывами | Доступ выдан не полностью. Пройдите выдачу заново, не снимая запрошенных прав |
| Ссылка подключения устарела. Начните подключение заново | Ссылка выдачи доступа уже использована или просрочена |
| Подключение начато для другой компании. Начните заново | Возврат из Ozon пришёл в кабинет другой компании |
| Подключение начал другой пользователь. Начните заново | Выдачу начал один пользователь Aplaut, а вернулся другой |
| Ozon не выдал токены. Попробуйте ещё раз через минуту | Ozon не ответил на обмен кода на токены |
| Не удалось сохранить токены Ozon. Мы уже разбираемся, попробуйте ещё раз через минуту | Сбой защищённого хранилища на стороне Aplaut |
| Подключение через Ozon пока недоступно. Мы уже разбираемся | Приложение не настроено на стороне Aplaut |
| Недостаточно прав для подключения интеграции | У роли в кабинете Aplaut нет прав на интеграции |
Ключи Seller API остаются только у подключений, созданных до перехода на приложение. Новые подключения так не создаются, а существующие продолжают работать, пока ключ действителен.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
client_id | Строка | Да | Client-Id кабинета продавца. Не секрет |
api_key | Строка | Да | API-ключ Seller API. Хранится в защищённом хранилище |
| Настройка | Тип | По умолчанию | Описание |
|---|---|---|---|
| Отзывы | Переключатель | Включено | Главный переключатель импорта. Выключен — плановые запуски пропускают подключение, остальные параметры блока скрыты |
| Какие отзывы импортировать | Список | Все | Фильтр по наличию ответа продавца: Все, Без ответа, С ответом. Значение «Все» выполняет два прохода — по отвеченным и по неотвеченным |
| Статус создаваемых отзывов | Список | Опубликован | Статус, с которым отзыв создаётся в Aplaut: Опубликован или Ожидает модерации. Применяется только к новым отзывам, статусы уже импортированных не меняются |
| Имя автора ответа продавца | Строка | Пусто | Подставляется как автор ответов продавца, импортированных с Wildberries. Пустое значение даёт «Аноним» |
| Глубина первого импорта, дней | Число, 1–720 | 90 | Период, за который первый запуск забирает отзывы |
| Частота синхронизации | Список | Каждый час | Интервал планового запуска: 1, 3, 6, 12 или 24 часа |
| Игнорировать отзывы без текста | Переключатель | Включено | Отзыв без текста, достоинств, недостатков и тегов не импортируется. Отзыв только с тегами импортируется |
| Если товара из отзыва нет в базе | Список | Создать отзыв без товара | Поведение, когда артикул продавца из отзыва не найден среди товаров компании: Создать отзыв без товара, Не создавать отзыв, Запросить товар из Wildberries |
| Вопросы и ответы | Переключатель | Выключено | Недоступно, помечено «Скоро» |
| Использовать песочницу | Переключатель | Выключено | Запросы идут в тестовую среду Wildberries. Требует токен тестового контура |
| Отправка ответов | Переключатель | Выключено | Первый комментарий к отзыву публикуется на Wildberries как официальный ответ продавца |
| Когда отправлять | Список | После публикации комментария | Момент отправки: Сразу после создания комментария или После публикации комментария |
Имя автора отзыва в настройках отсутствует: Wildberries передаёт имя покупателя вместе с отзывом.
Учётные данные:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
token | Строка | Да | Токен API продавца с категорией «Вопросы и отзывы». Для стратегии «Запросить товар из Wildberries» нужна ещё категория «Контент». Хранится в защищённом хранилище |
Журнал запусков
Одна запись журнала — один фактический запуск. Пропуск по расписанию, выключенная синхронизация, пауза по лимиту и занятая блокировка записи не создают.
| Поле | Значения |
|---|---|
| Статус | Выполняется, Выполнен, Ошибка |
| Причина ошибки | Превышен лимит запросов, Ошибка авторизации, Ошибка |
| Триггер | По расписанию, Вручную, По событию |
| Тип | Отзывы, Ответ на отзыв |
Запуск со статусом Выполняется старше часа помечается как Завис: он прерван перезапуском сервиса и не возобновится. Записи журнала хранятся 90 дней.
Счётчики запуска синхронизации:
| Счётчик | Что считает |
|---|---|
| Получено отзывов | Отзывы, пришедшие от маркетплейса до фильтрации |
| Импортировано | Отзывы, созданные или обновлённые в Aplaut |
| Пропущено без текста | Отфильтровано настройкой «Игнорировать отзывы без текста» |
| Пропущено без товара | Отфильтровано стратегией «Не создавать отзыв» |
| Создано товаров | Товары, созданные стратегией «Запросить товар» |
| Найдено товаров | Отзывы, у которых товар нашёлся в каталоге компании (Ozon) |
| Обогащено отзывов | Отзывы, для которых дозапрошены фото, видео и оценки полезности (Ozon) |
| Импортировано ответов продавца | Ответы, забранные из кабинета продавца (Ozon) |
| Пропущено удалённых | Отзывы, удалённые на Ozon между выдачей списка и дозапросом |
| Курсоры до запуска, Курсоры после запуска | Состояние курсоров синхронизации |
| Лимит действует до | Время, до которого синхронизация приостановлена маркетплейсом |
Лимиты
| Ограничение | Значение | Область действия |
|---|---|---|
| Глубина первого импорта | 1–720 дней | Одно подключение |
| Интервал плановой синхронизации | 1, 3, 6, 12 или 24 часа | Одно подключение |
| Длительность одного запуска, Ozon | 10 минут | Один запуск синхронизации |
| Отзывов за один запуск, Ozon | до 2000 | Один запуск синхронизации |
| Отзывов за один запуск, Wildberries | до 10 000 на каждый проход фильтра | Один запуск синхронизации |
| Пауза после превышения лимита Ozon | 1 час | Одно подключение |
| Пауза после превышения лимита Wildberries | Время из ответа Wildberries, не больше 24 часов; без него — 1 час | Одно подключение |
| Хранение записей журнала | 90 дней | Все подключения компании |
Смотрите также: как подключить Ozon или Wildberries, данные отзывов с маркетплейсов, о синхронизации отзывов с маркетплейсами.