О синхронизации отзывов с маркетплейсами

Обмен с маркетплейсом односторонний в обе стороны по очереди: Aplaut забирает отзывы по расписанию и отправляет обратно ровно один ответ на отзыв. Маркетплейс не сообщает о новых отзывах сам, поэтому всё строится на периодическом опросе, и из этого следуют почти все особенности, которые видит продавец.

Почему отзыв появляется не сразу

Плановый запуск идёт по расписанию подключения — по умолчанию раз в час. Отзыв, оставленный покупателем сразу после очередного запуска, попадёт в Aplaut на следующем.

Каждый запуск продолжает с того места, где остановился предыдущий: платформа помнит дату последнего обработанного отзыва и берёт всё, что новее. Такой курсор дешевле полного перебора, но у него есть слабое место — отзыв, который прошёл модерацию маркетплейса с опозданием, появляется в API задним числом, когда его окно уже закрыто. Поэтому каждый запуск сдвигает границу на десять минут назад и перечитывает этот нахлёст. Повторное чтение ничего не ломает: импорт обновляет отзыв с тем же идентификатором, а не создаёт второй.

У Wildberries к этому добавляется собственная особенность. Список фильтруется по признаку «есть ответ продавца», и у отвеченных и неотвеченных отзывов свои курсоры. Отзыв, на который продавец ответил прямо в кабинете Wildberries уже после того, как курсор отвеченных ушёл вперёд, повторно не перечитывается: в Aplaut такой отзыв останется без ответа. Помогает сброс состояния синхронизации — следующий запуск перечитает историю заново.

Почему импортируется не всё

Первый запуск не забирает историю целиком за один раз. Он ограничен и по глубине (настройка «Глубина первого импорта»), и по времени: запуск живёт десять минут, а дальше продолжает следующий. У кабинета с десятками тысяч отзывов первый импорт занимает несколько часов, и промежуточные цифры в журнале — нормальная картина, а не сбой.

Дальше работают фильтры, и они отсекают заметную долю. Оценки без текста по умолчанию не импортируются, потому что модерировать и показывать на сайте в них нечего. Отзывы на товары, которых нет в каталоге Aplaut, по умолчанию создаются без привязки — артикул остаётся в атрибутах, и товар можно привязать позже, когда каталог пополнится. Всё это видно в счётчиках журнала запусков, поэтому расхождение с цифрой в кабинете маркетплейса почти всегда объясняется двумя-тремя строками одного запуска.

Почему синхронизация встаёт на паузу

Маркетплейсы ограничивают частоту запросов, и ведут себя при этом по-разному. Wildberries считает лимит по тарифу продавца и в отказе присылает время, через которое можно вернуться. Ozon ограничение объявляет, но времени ожидания не даёт.

Поэтому Aplaut притормаживает себя сам: запросы идут не подряд, а с паузами. Если ограничение всё-таки сработало, синхронизация останавливается мягко — курсоры остаются на месте, и следующие запуски пропускают подключение, пока окно не откроется. Для Wildberries длительность паузы берётся из ответа маркетплейса (не больше суток), для Ozon — час. Ничего не теряется: после паузы импорт продолжается с той же точки.

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

Почему уходит только первый ответ

Wildberries хранит один ответ продавца на отзыв, и переписки там нет. Ozon технически допускает несколько комментариев, но Aplaut ведёт себя одинаково с обоими: на маркетплейс уходит первый комментарий к импортированному отзыву, остальные остаются внутри платформы.

Ответ не отправится, если он уже есть на маркетплейсе — импортированный оттуда или отправленный из Aplaut раньше. Не отправится и комментарий к отзыву, который пришёл не с этого маркетплейса. Такие случаи проходят молча: записи в журнале запусков не появляется, потому что запроса к маркетплейсу не было.

Смотрите также: как подключить Ozon или Wildberries, настройки подключения маркетплейса, данные отзывов с маркетплейсов.