Работа с Playerok

Playerok подключается к Lovsel как самостоятельная площадка: свои сделки, чаты, товары, автоматизация и уведомления — в том же кабинете, что GGsel и FunPay. Чтобы видеть только Playerok, выберите его в переключателе площадок вверху кабинета. Коротко о возможностях — на странице «Автоматизация Playerok».

У Playerok нет официального API для продавцов. Lovsel работает с аккаунтом через те же запросы, что сайт playerok.com в браузере (по данным открытой библиотеки PlayerokAPI). Это неофициальная интеграция: если Playerok изменит сайт, отдельные операции могут временно перестать работать — кабинет сообщит об этом прямо.

Подключение

Нужны cookies аккаунта (обязательно token), User-Agent браузера и при необходимости прокси. Пошаговая инструкция с ответами на частые ошибки — «Подключение Playerok».

После подключения Lovsel загружает историю продаж целиком, чаты и все товары — без уведомлений и автовыдачи. Сделки, открытые на момент подключения, показываются отдельно: решение по ним принимаете вы.

Синхронизация

Lovsel опрашивает Playerok на своём сервере круглосуточно — по умолчанию раз в 12 секунд (от 8 до 120):

• первые страницы продаж и чатов — каждый проход; если новых сделок много, Lovsel дочитывает их на следующих проходах с того же места;
• изменившиеся чаты дочитываются до последнего известного сообщения;
• незавершённые сделки сверяются по одной каждые 5 минут — так Lovsel замечает подтверждение, возврат или проблему даже у старых сделок;
• отзывы — раз в 10 минут, профиль и баланс — раз в 10 минут;
• список товаров — полным обходом раз в 30 минут; товар считается удалённым, только когда обход прошёл до конца.

Что уже обработано, Lovsel хранит в базе, поэтому повтор, сверка и перезапуск не дают повторных уведомлений и автоответов. Граница синхронизации сохраняется: после остановки сервиса новые сделки и сообщения за время остановки обрабатываются при следующем запуске.

Мгновенные уведомления площадки (WebSocket) Lovsel не использует: опрос с ограниченной частотой работает предсказуемо для многих продавцов сразу и не держит по несколько соединений и потоков на каждого.

При ошибках связи Lovsel делает паузы с нарастанием (до 5 минут), при просьбе площадки сбавить темп — минутную паузу, при истёкшей сессии — проверяет раз в 10 минут и присылает одно уведомление. Если Playerok трижды подряд показал проверку браузера, работа Playerok приостанавливается до обновления данных подключения. Пока площадка недоступна, разделы показывают сохранённые данные с отметкой «Синхронизировано … назад».

Сделки и статусы

«Сделки» — продажи подключённого аккаунта (покупки продавца сюда не попадают и в выручку не входят): поиск, фильтры по статусам и «С проблемой», сортировка, переключатель «Текущий аккаунт / Вся история».

Исходный статус Playerok всегда виден в карточке сделки. Значение PENDING библиотека не описывает, поэтому такая сделка не считается ни оплаченной, ни неоплаченной и в выручку не входит. «Проблема по сделке» — отдельный признак: статус не меняет, но сделка отмечается и попадает в фильтр «С проблемой», а в центр событий приходит карточка.

В карточке сделки: покупатель, цена товара, комиссия площадки и зачисление продавцу — если Playerok сообщил сумму операции продажи; иначе «неизвестно» (Lovsel не придумывает сумму). Зачисление — это не чистая прибыль: себестоимость товара Lovsel не знает. Там же данные покупателя для получения, его комментарий, состояние выдачи, история событий и ссылки на сделку и чат на Playerok.

Действия: выдать товар, отметить «товар отправлен» (только для оплаченной сделки), полный возврат (для оплаченной или отправленной, ещё не подтверждённой сделки). Перед каждым действием Lovsel перечитывает сделку. Подтвердить получение за покупателя и вывести деньги нельзя.

Чаты

«Чаты» — переписка с покупателями и поддержкой Playerok; уведомления площадки — отдельный чат только для чтения. Ответ уходит в чат Playerok и отмечает его прочитанным. Сообщения покупателей и поддержки, новые сделки, смены статусов, проблемы и отзывы приходят в центр событий одной карточкой на чат с отметкой Playerok.

Товары

«Товары» — все ваши товары со статусами: черновик, на модерации, активен, отклонён, заблокирован, истёк, продан, удалён. Можно:

• изменить цену — меняется только цена, остальные поля товара сохраняются;
• опубликовать черновик — с выбором варианта публикации и явным подтверждением его цены;
• удалить товар с Playerok — это удаление, а не выключение, поэтому с отдельным подтверждением;
• изменить цену или удалить сразу несколько товаров — очередью с прогрессом, отменой и результатом по каждому.

Создание товара с характеристиками категории, данными для выдачи и изображениями выполняется на сайте Playerok: ссылка на товар открывает его там же.

Баланс Playerok

На странице подключения виден баланс аккаунта на Playerok: всего, доступно, заморожено, ожидает зачисления. Это деньги на площадке, а не баланс Lovsel: продажа на Playerok не пополняет Lovsel, возврат на Playerok не списывает ничего с Lovsel. Подписка, пополнения и единый баланс Lovsel работают как раньше.

Аналитика

Продажи Playerok входят в обзор, «Все площадки → Заказы», аналитику, топ товаров и сравнение площадок. Выручка — цена товара по оплаченным, отправленным и подтверждённым сделкам; возвраты и «ожидает на Playerok» в выручку не входят. Разные валюты не складываются.

Ограничения

• Интеграция неофициальная: при изменении сайта Playerok отдельные операции могут временно не работать.
• Cookies защиты привязаны к IP и браузеру; с сервера они подходят не всегда — может понадобиться прокси.
• Мгновенных уведомлений нет: новые события появляются с задержкой до интервала опроса.
• Создание товаров с полями категории и изображениями — на сайте Playerok.
• Ответить на отзыв через Lovsel нельзя — только поблагодарить в чате.
• Платное продвижение Lovsel сам не покупает.
• Частичного возврата у Playerok нет.
• История продаж при первом подключении загружается до 9 600 сделок.

Для разработчиков

Плагины с "playerok" в MANIFEST["marketplaces"] получают события playerok.* и ctx.playerok — см. «Плагины для Playerok».