> For the complete documentation index, see [llms.txt](https://resolve-wiki.huckster.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://resolve-wiki.huckster.ru/sarp/modul-analitiki-i-otchyotov-sarp-seller-analytics-and-reporting-platform-chasto-zadavaemye-voprosy-f.md).

# Модуль Аналитики и отчётов SARP  (Seller Analytics\&Reporting Platform) Часто задаваемые вопросы (FAQ

### 1. О платформе и архитектуре SARP

SARP (Seller Analytics & Reporting Platform) — это сквозная экосистема управленческих решений для среднего и крупного бизнеса, торгующего на маркетплейсах.

Управленческие отчеты, служебные уведомления и внутренняя аналитика в реальном времени помогают селлерам оперативно принимать корректные решения:

* Вовремя отказываться от низкомаржинальных брендов (по которым удержания от маркетплейсов перекрывают всю скидку от поставщика).
* Устанавливать корректные диапазоны цен для участия в акциях без генерации убытка.
* Проанализировать и исправить имевшие место технические ошибки (снимать карантин цен, перенастраивать репрайсер, повторить выгрузку цен).
* Избегать проблем ручного ведения Excel-таблиц по множеству SKU и кабинетов параллельно с контролем логистики, заказов и удержания РРЦ, когда это становится физически нереализуемо.
* Решать проблему запаздывания отчетов от маркетплейсов, предоставляя информацию в реальном времени, вместо принятия решений «постфактум».
* Учитывать многомерность данных и сложность выявления взаимозависимостей показателей по историческим данным для прогнозирования.

#### Главное отличие от «сервисов оцифровки»

| **Критерий**        | **Утилиты / визуализаторы**                                                                                  | **Экосистема SARP**                             |
| ------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------- |
| **Суть работы**     | Просто переносят API-данные из таблиц WB / Ozon в графики и дешборды с минимальными типовыми рекомендациями. | Сквозная экосистема управленческих решений.     |
| **Фокус данных**    | Показывают прошлое.                                                                                          | Помогают прогнозировать и управлять будущим.    |
| **Бизнес-ценность** | Исключительно информационная.                                                                                | Инструмент для принятия стратегических решений. |

#### Архитектура системы (3 основных информационных блока)

1. **Пульс** — операционный контур. Набор уведомлений (алертов) по бизнес-процессу продаж на маркетплейсах в реальном времени.
2. **Аналитика** — тактический контур. Вся внутренняя аналитика по продажам и инструменты для анализа текущей ситуации, план-фактного анализа и прогнозирования.
3. **Отчеты HucksterMind** — стратегический контур. Набор управленческих отчетов в различных срезах, автоматически генерируемых собственным AI-ассистентом HucksterPlatform.

### 2. Подключение, синхронизация и импорт истории

#### Как подключить SARP к кабинетам Ozon и Wildberries?

Подробная инструкция по интеграции и подключению модуля доступна по ссылке: <https://wiki.huckster.ru/sarp/podklyuchenie-k-sarp>

#### Регламент обновления данных

Данные в SARP автоматически обновляются каждые 6 часов.

#### Глубина загрузки исторических данных

* **По умолчанию:** Данные по умолчанию загружаются с 1-го числа предыдущего месяца относительно даты подключения. Например, при интеграции в сентябре загрузятся данные начиная с 1-го августа.
* **По запросу в техподдержку:** Данные за более ранние месяцы можно запросить через службу поддержки. По отдельному согласованию с разработчиком глубина загрузки может быть увеличена до 60–90 дней, а в отдельных случаях — до года.

#### Устранение неполадок: Ошибка «Данные пока не загружены»

Если после привязки кабинета данные в интерфейсе отсутствуют, это вызвано тремя типовыми причинами:

1. **Недостаточно прав у API-токена.** Недостаточно прав у токена кабинета. Для работы SARP нужен полный доступ к информации о заказах, продажах и финансах. Если кабинет ранее подключался только для других функций сервиса, прав может не хватать.
2. **Первичный импорт.** Первичная загрузка ещё не завершилась. После подключения кабинета или добавления корректного токена нужно дождаться загрузки. Ориентир ожидания составляет до 6 часов.
3. **Большой объём данных.** При значительном количестве кабинетов и товаров (большом количестве SKU) загрузка может потребовать дополнительной проверки службой поддержки.

> **Чек-лист действий:** Проверьте права токена по инструкции подключения SARP. Если с момента добавления токена с нужными правами прошло более 6 часов, а сообщение осталось, сообщите службе поддержки маркетплейс, название кабинета и точное время подключения или замены токена. Сам токен присылать не нужно.

### 3. Пульс: Система умных уведомлений и алертов

«Пульс» помогает вовремя замечать проблемы в продажах, обмене данными с маркетплейсами и настройках репрайсера. Он объединяет уведомления и основные показатели бизнеса, чтобы было проще понять, на что обратить внимание.

На данный момент селлеру доступно 34 алерта с регулярным обновлением и расширением списка. Уведомления разделены по приоритету на Критические, Важные и Информационные. Полный интерактивный список и описание алертов доступны в таблице по ссылке: <https://wiki.huckster.ru/glavnaya/tablica-alertov>

#### Что контролирует Пульс (Ключевые триггеры)

* **Финансы:** Убыточные продажи (товары с отрицательной маржинальностью).
* **Репрайсер:** Отсутствие защитных цен на товарах, подключенных к репрайсеру; продажа по минимальной цене в режиме следования за конкурентами.
* **Технические сбои:** Просроченный или невалидный API-токен, требующий проверки подключения кабинета.
* **Логистика и склад:** Нулевые остатки товаров на складах маркетплейса при наличии активной карточки.
* **Аномалии продаж:** Полное отсутствие заказов при наличии товара на остатках; резкое изменение динамики заказов, выкупов, дохода и удержаний по сравнению с предыдущими периодами.

Чтобы разобраться в конкретном сигнале, на панели уведомлений «Пульса» нажмите на значок уведомлений или кнопку «Показать все», затем нажмите «Подробнее» у нужного уведомления. Детализацию можно скачать в Excel для дальнейшего анализа.

#### Протоколы реагирования на критические алерты

**Сценарий А: Уведомление об убыточных продажах (сигнал об отрицательной маржинальности)**

1. Начните с кнопки «Подробнее» у уведомления в «Пульсе»: скачайте Excel с детализацией и определите, какие товары требуют проверки.
2. Проведите аудит параметров: проверьте актуальность себестоимости, цены продажи, скидок, участия в акциях и расходов маркетплейса (логистика, хранение).
3. Проверьте настройки стратегий репрайсера: не допускают ли алгоритмы автоснижения слишком низкую цену.

> **Важно:** Не стоит автоматически повышать цены по всему кабинету: сначала разберите конкретные позиции и причину отрицательной маржинальности по артикулам из Excel-отчета.

**Сценарий Б: Отсутствие защиты от низких цен (для товаров, подключенных к репрайсеру)**

Проверьте не только выбор типа цены для защиты, но и заполнение защитных цен по товарам из уведомления:

* **Если защита уже настроена:** откройте настройки профиля, скачайте текущие защитные цены, заполните или исправьте значения порогов и загрузите файл обратно.
* **Если защита ещё не настроена:** создайте отдельный тип цены (например, «Защита»), заполните пороги по всем рабочим артикулам через «Управление каталогом ➡️ Обновить цены». Только после загрузки значений выберите этот тип цены в настройках защиты и сохраните.

> **Внимание:** Не включайте незаполненный тип цены в качестве защиты: по инструкции это полностью блокирует выгрузку цен на маркетплейс! Защитный порог выбирайте осознанно, с учётом допустимых цен ваших стратегий и скидок, а не просто для устранения уведомления.

### 4. Аналитика, метрики и финансовый учёт (PnL)

#### Разбор расхождений: Заказы в SARP vs Личный кабинет Ozon

Селлеры часто видят разные цифры заказов, что обусловлено разницей в методологии подсчета:

* **В личном кабинете Ozon:** показатель «Заказы» может включать абсолютно все созданные заказы, которые впоследствии покупатель отменил.
* **В SARP:** на графиках и в сводных данных отображаются чистые заказы за вычетом отменённых (Все заказы минус Отмены).

> **Пример:** Если оформлено 100 заказов, а 15 отменено, Ozon покажет 100, а SARP — 85. Поэтому меньшее количество заказов в SARP само по себе не означает потерю или некорректность данных. При сверке важно выбрать одинаковые кабинет и период и сравнивать показатели с одинаковым учётом отмен.

#### Карта финансовых показателей: Где искать нужные данные?

* **Доход и общие удержания маркетплейсов:** на главной странице сервиса, в сводных показателях за выбранный период.
* **Подробные затраты маркетплейса:** в блоке «Основные показатели». Там представлена разбивка по хранению, логистике, эквайрингу, продвижению, комиссии и прочим затратам в разрезе маркетплейсов и кабинетов.
* **Прибыль и рентабельность:** в разделе «Финансовые результаты», в отчёте о прибылях и убытках PnL.

> **Важно:** «Доход» никогда не равен чистой прибыли. В SARP доход означает сумму к выплате: выкупы за вычетом удержаний маркетплейса. Для оценки реальной чистой прибыли нужно учитывать себестоимость, налоги, маркетинг и другие операционные расходы бизнеса, которые необходимо вручную указать перед анализом в меню «Отчёт (PnL) ➡️ Настройки». Итоговая прибыль в отчёте носит оценочный характер и зависит от полноты ваших настроек.

**Текущий статус:** На данный момент аналитика и сравнение данных ведутся в разрезе за месяц. **Планируемое обновление:** В ближайшее время мы переходим на более частый и гибкий формат — контроль будет осуществляться понедельно.

#### Инструмент «План-факт продаж»

Находится в меню: Аналитика ➡️ План-факт продаж.

1. Выберите маркетплейс и кабинет в фильтрах.
2. Задайте план на месяц по нужному показателю: сумма заказов, выкупов или доход в рублях.
3. Следите за выполнением справа от графика: там отображаются процент выполнения плана на текущую дату и сумма, оставшаяся до цели. Отрицательный остаток означает перевыполнение.
4. Переключайте «Заказы», «Выкупы», «Доход», чтобы оценивать каждую метрику отдельно. Дополнительно можно сравнить текущие результаты с полным прошлым месяцем или аналогичным периодом прошлого месяца.

### 5. Модуль прогнозирования (Линейная регрессия)

В «Тренд-прогнозе» пунктирные линии показывают ожидаемые значения до последнего дня текущего календарного месяца. Наведите курсор на конечную точку прогнозной линии, чтобы увидеть ожидаемое значение, и сопоставьте его с установленным планом.

#### Математическая логика

Расчёт осуществляется методом линейной регрессии: система определяет тенденцию изменения заказов, выкупов или дохода на основе фактических данных за выбранный период и подбирает линию `y = a × x + b`, которая наилучшим образом описывает их динамику. Коэффициенты выбираются по методу наименьших квадратов (МНК) так, чтобы сумма квадратов отклонений фактических значений от линии была минимальной. Полученная тенденция продлевается до последнего дня месяца.

#### Два режима прогнозирования

1. **По предыдущему месяцу:** прогноз на основе полных данных закрывшегося прошлого месяца.
2. **По текущему месяцу:** прогноз на основе текущей динамики с начала месяца до текущей даты. Этот вариант доступен строго с 7-го числа.

#### Почему прогноз может отсутствовать?

Система проверяет показатели качества тренда: корреляция и коэффициент детерминации. Если данные слишком хаотичны и показатели ниже установленных порогов, прогнозная линия не отображается, чтобы не вводить в заблуждение.

> **Что важно учитывать:** Это оценка по наблюдаемой тенденции, а не гарантия результата. Тренд-прогноз не может учитывать отдельно все будущие акции, изменения рекламы, сезонность, отсутствие остатков и другие события. Резкие всплески и провалы могут существенно влиять на расчёт.

> **Примечание:** В разделе «Буст-прогноз» предусмотрена отдельная точка «Прогноз HucksterMind» — дополнительная ИИ-оценка. Также прогнозные оценки есть в отчётах HucksterMind («Продажи текущего месяца», «Сводный отчёт Руководителю»). Рекомендуется сравнивать оба тренд-прогноза с оценкой ИИ для планирования.

### 6. Работа со стандартными отчетами SARP

Инструкция по работе с разделом «отчёты»: <https://wiki.huckster.ru/sarp/instrukciya-po-funkcionalu-i-ispolzovaniyu-bloka-analitika/otchyoty>

#### Алгоритм выгрузки отчетов в Excel

1. Откройте SARP ➡️ «Аналитика» ➡️ «Отчёты».
2. В верхней части экрана выберите период: 3, 7, 30 или 90 дней либо задайте нужный диапазон дат вручную в поле справа.
3. Укажите маркетплейс и кабинет в фильтрах.
4. Нажмите на нужный отчет в разделе «Отгрузки». Дождитесь сообщения: «Отчёт успешно поставлен в очередь на формирование».
5. Перейдите в «Заказанные отчёты». Когда статус изменится с «Формируется» на «Готов», скачайте файл в формате Excel.

> **Важные тайминги:** Формирование тяжелых отчетов может занимать до 30 минут, а готовые отчеты хранятся около 3 дней. Если срок хранения истёк, сформируйте отчет заново. Если отчет с нужными параметрами уже был сформирован ранее и ссылка активна, его можно скачать повторно из истории без нового запуска.

#### Почему сформированный отчёт пустой или данные в нём не совпадают с ожидаемыми?

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

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

### 7. Умная аналитика HucksterMind (AI-ассистент)

Стандартные отчёты SARP дают структурированные данные для самостоятельного анализа, а наш AI-ассистент HucksterMind помогает переходить от сухих цифр к пониманию ситуации: он консолидирует и интерпретирует информацию, выделяет неочевидные тенденции, формирует выводы и прогнозные оценки. Это экономит время на подготовку сводной аналитики и позволяет принимать более предметные решения (какие товары изучить, какие настройки проверить и где искать причины изменения результатов).

#### Регламент заказа отчетов HucksterMind

| **Название отчета**                 | **Рекомендуемая частота**            | **Особенности, ограничения и практическая польза**                                                                                                                                                                                                         |
| ----------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Сводный отчёт Руководителю**      | 1–2 раза в месяц                     | Охватывает глубокий срез: последние 3 месяца + текущий период. Начинать запрашивать имеет смысл с 7–10-го числа. Чаще заказывать нецелесообразно.                                                                                                          |
| **Продажи текущего месяца**         | Примерно 1 раз в неделю              | Оптимален для отслеживания текущей динамики в течение месяца, изменений относительно прошлого периода и прогнозных оценок.                                                                                                                                 |
| **Товары-локомотивы**               | Примерно 1 раз в неделю              | Регулярный глубокий разбор и мониторинг ключевых товаров, брендов и регионов продаж.                                                                                                                                                                       |
| **Анализ истории алертов**          | По необходимости                     | Разбор и ретроспективный анализ накопившихся системных ошибок, уведомлений и проблем. Фиксированная частота отсутствует.                                                                                                                                   |
| **Анализ динамики тепловой карты**  | Раз в неделю                         | Рекомендуется оценивать: сместились ли часы и дни с наибольшим объёмом заказов; повторяются ли пики или это разовый всплеск; как изменилась картина после корректировки цен, рекламы или акций.                                                            |
| **Информация для продвижения Ozon** | Перед запуском РК / \~1 раз в неделю | Рекомендуется заказывать: строго перед запуском новых рекламных кампаний (РК); при регулярном продвижении — примерно раз в неделю (к пересмотру списка для экономии бюджета); дополнительно — при существенном изменении ассортимента или динамики продаж. |

> ⚠️ **Важно:** Ограничение ИИ в начале месяца: В первые дни месяца, ориентировочно с 1-го по 7–10-е число, HucksterMind может скрывать прогнозы на конец месяца или выводить сообщение о недостаточности данных. Это нормальный процесс, поскольку системе необходимо время для накопления репрезентативного массива данных за текущий период.

### 8. Онлайн-калькулятор юнит-экономики

#### Как найти

Калькулятор находится внутри выбранного кабинета маркетплейса: «Кабинеты» ➡️ нужный кабинет ➡️ «Онлайн-калькулятор».

#### Как он работает?

Калькулятор оценивает прибыль и маржинальность по каждому товару, учитывая себестоимость, цену продажи, комиссии, логистику, хранение и другие затраты маркетплейса. Также можно внести дополнительные расходы в рублях или процентах (например, на упаковку и рекламу) и задать параметры возвратов, брака и НДС.

Можно решать две задачи:

* Задать цену продажи — посмотреть, какая получается маржинальность.
* Задать желаемую маржинальность (например, 15%) — рассчитать необходимую цену продажи.

#### Пошаговый алгоритм работы

1. Создайте модель расчёта и дайте ей название.
2. Добавьте товары (они должны быть в каталоге Huckster и сопоставлены с товарами маркетплейса).
3. Проверьте себестоимость, схему работы и параметры затрат для выбранной площадки.
4. Внесите дополнительные расходы и нажмите «Пересчитать данные товары».
5. Сравните варианты; итоговый результат можно скачать в Excel.

> **Важно:** Сам пересчёт модели в калькуляторе не меняет реальные цены на маркетплейсе. Для переноса результата предусмотрены отдельные действия — обновление цен в каталоге или выгрузка непосредственно в кабинет маркетплейса.

### 9. Новый раздел «Воронка продаж»

Данные доступны по маркетплейсу Ozon для пользователей, у которых подключен любой вариант Ozon Premium.

Раздел предоставляет данные по основным метрикам конверсий за выбранный период в сумме и на каждый день. Данные можно посмотреть как в целом по кабинету, так и для конкретных товаров. Доступно визуальное (на графиках) сравнение основных показателей: Сумма заказов, конверсии в корзину и в заказ.

По всем метрикам сразу видно изменение результата относительно предыдущего дня.

#### Доступные показатели

1. Заказы: выручка и количество
2. Количество доставок, отмен, возвратов
3. Позиция товаров в выдаче
4. Конверсия: общая, из поиска, из карточки
5. Показы товара: всего, в поиске, в карточке
6. Добавления в корзину: всего, из поиска, из карточки
7. Уникальные посетители: всего, в поиске, в карточке

О запуске нового функционала мы всегда уведомляем наших Пользователей путем рассылки сообщений в рабочие группы и публикации в Телеграм-канале «Радар Репрайсера».

**Что нового уже в разработке для модуля SARP (beta-версия)**

1. Фактическая юнит-экономика в разрезе каждого товара (покабинетно, по одному или нескольким маркетплейсам);
2. Фактическая юнит-экономика в разрезе каждого товара с детализацией по каждому заказу.

**Что ожидается в модуле SARP**

История изменения СПП для Ozon и Wildberries (для выявления корреляции «цена – СПП – маржинальность – прибыль» и динамического ценообразования).

***

> О запуске нового функционала мы всегда уведомляем наших Пользователей путём рассылки сообщений в рабочие группы и публикации в Телеграм-канале «[Радар Репрайсера](https://t.me/radar_repricer)».


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://resolve-wiki.huckster.ru/sarp/modul-analitiki-i-otchyotov-sarp-seller-analytics-and-reporting-platform-chasto-zadavaemye-voprosy-f.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
