# REPRIQO 1.0.59

Руководство пользователя · Windows x64 · редакция 01.11.2026

## Содержание

1. [Первый запуск](#start)
2. [Подключите площадки](#connections)
3. [Заведите независимый склад](#warehouse)
4. [Управляйте синхронизацией](#sync)
5. [Находите товары и фотографии](#catalog)
6. [Настройте переоценку Kaspi](#repricing)
7. [Перенесите карточки](#transfer)
8. [Организации, магазины и заказы](#analytics)
9. [Рассчитайте прибыль](#profit)
10. [Отзывы, реклама и находки](#reviews)
11. [CSV, калькуляторы и Telegram](#tools)
12. [Обновление и поддержка](#help)

<a id="start"></a>

## 01. Первый запуск

*От регистрации до первой проверенной операции*

REPRIQO 1.0.59 - настольная программа для Windows x64. Она объединяет автопереоценку Kaspi, независимый склад Kaspi/Wildberries/Ozon, перенос карточек и локальную аналитику. Автоматические циклы работают, пока программа запущена, компьютер не спит, есть интернет, доступ REPRIQO и действующее подключение площадки.

> **30 дней для новых пользователей**
>
> 30 дней бесплатно на START для новых пользователей после регистрации. Предложение действует с учётом условий регистрации и устройства; оно не обещает повторный пробный период или продление существующего. Фактический доступ и дату окончания проверьте в «Подписка».

### Начните с одного товара

1. Установите полученный официальный установщик REPRIQO для Windows и запустите программу. Исходный ZIP проекта сам по себе не является готовым установщиком.
2. Нажмите «Нет аккаунта? Регистрация». Укажите номер телефона, контактный Email, пароль от 6 символов и повтор пароля. Реферальный код необязателен. Нажмите «Создать аккаунт» и завершите подтверждение Email, если программа запросит код.
3. Для входа в REPRIQO используйте номер телефона и пароль. «Запомнить вход на этом компьютере» включайте на своём ПК. Учётная запись REPRIQO и данные входа Kaspi - разные подключения.
4. Проверьте «Подписка», затем подключите нужные площадки. Обновите каталог и сравните один товар с кабинетом: артикул, вариант, склад и остаток.
5. Создайте один товар в «Склад», введите фактический доступный запас и привяжите предложения. Перед запуском общей выгрузки проверьте результат в кабинетах. Для автопереоценки отдельно задайте границы цены.

### Куда идти в меню

| Задача | Раздел |
| --- | --- |
| Остатки и привязки трёх площадок | Склад |
| Цены Kaspi, каталог, фото | Kaspi |
| Подключить API и прочитать каталог | Wildberries / Ozon |
| Организации, заказы, финансы, отзывы | Прибыль и заказы |
| Подготовить новые карточки | Перенос карточек |
| Разовый расчёт в тенге | Калькулятор прибыли Kaspi |

Первые пункты меню: «Обзор» → «Склад» → «Kaspi» → «Wildberries» → «Ozon» → «Прибыль и заказы» → «Перенос карточек». Дальше доступны «История», «Подписка», «Подключить Kaspi», «Поддержка» и другие пункты. В руководстве приведены подписи русского интерфейса.

> **Результат первого дня**
>
> Один товар сопоставлен с правильными предложениями; количество и валюта проверены; минимальная и максимальная цены заданы; понятен источник каждой финансовой суммы. Программа не гарантирует первое место, продажи или прибыль.

<a id="connections"></a>

## 02. Подключите площадки

*Kaspi: браузерная сессия. WB/Ozon: ключи API*

### Kaspi: вход внутри REPRIQO

1. В левом меню нажмите «Подключить Kaspi». В открывшемся встроенном окне войдите в кабинет продавца именно здесь, через вкладку Email. Вход в отдельном Chrome не передаёт сессию программе.
2. После появления разделов кабинета нажмите «Я вошёл — проверить». Дождитесь статуса готовой сессии. Окно можно закрыть; проверка и работа продолжаются в приложении.
3. Для автоматического восстановления нажмите «Данные входа Kaspi», введите «Email Kaspi:» и «Пароль Kaspi:», сохраните. На Windows данные хранятся в диспетчере учётных данных. Удалить их можно кнопкой «Удалить сохранённые данные».
4. Откройте «Kaspi» → «Обновить товары». Программа читает все страницы каталога «В продаже». Новые товары добавляются с выключенной автоматической переоценкой. Ранее добавленные товары автоматически не удаляются.

Проверка сессии выполняется каждые 15 минут. При завершении сессии REPRIQO пытается восстановить вход через Email. Kaspi может запросить код подтверждения: завершите его вручную. Возврат в кабинет не отменяет вашу ручную остановку мониторинга.

### Wildberries: токен и склад FBS

1. Откройте «Wildberries», вставьте «API-токен WB:» с правами «Контент» и «Маркетплейс», нажмите «Подключить WB».
2. Выберите правильный «Склад FBS:», нажмите «Загрузить товары WB», затем «Обновить остатки FBS». Сверьте артикул продавца, размер и штрихкод.
3. Для финансов дополнительно нужна категория токена «Финансы», для отзывов - «Вопросы и отзывы». Права чтения каталога не означают доступ ко всем этим операциям.

### Ozon: Client ID и API Key

1. В «Ozon» введите Client ID и API Key с доступом к нужным методам. Нажмите «Подключить Ozon» → «Загрузить товары Ozon» → «Обновить остатки».
2. Каталог показывает FBS/FBO и резервы отдельно. Для выгрузки общего склада выберите склад продавца FBS в «Товар и привязки». «Загрузить склады Ozon» поможет выбрать реальный ID склада: это не Product ID, не SKU и не артикул.

> **Два способа доступа к Kaspi**
>
> Браузерная сессия нужна прежним операциям с ценами, каталогом и общим складом. «Прибыль и заказы» → «Заказы» требует отдельный API-токен Kaspi. Пароль браузерного входа не заменяет API-токен.

API-ключи аналитики задаются в «Прибыль и заказы» → «Магазины» → «API-ключи магазина». Подключения могут использоваться повторно только при совпадении ID кабинета. Не передавайте пароли, токены или коды подтверждения в поддержку.

<a id="warehouse"></a>

## 03. Заведите независимый склад

*Ручной доступный запас + точные привязки предложений*

«Склад» хранит ваши собственные товары с внутренним SKU. Это отдельный учёт: программа не делает каталог Kaspi или WB главным складом и не суммирует их остатки для первоначального количества. Начальный доступный запас вы задаёте вручную.

### Создание и привязки

1. Нажмите «Добавить товар». Заполните «Внутренний SKU», «Название» и «Доступный остаток, шт.». Допускается целое число от 0 до 1 000 000. Укажите именно доступный для новых продаж запас.
2. Оставьте «Синхронизировать привязанные товары» включённым, если товар должен участвовать в обмене. Во вкладках Kaspi/Wildberries/Ozon отметьте предложения, которые расходуют этот общий запас.
3. Проверяйте цвет, размер, комплектность и выбранную точку/склад. Для Ozon выберите «Склад продавца Ozon FBS:». Для WB используется выбранный склад FBS. Обновить каталог в окне можно кнопкой «Обновить товары».
4. Нажмите «Сохранить». Для изменения выберите товар → «Товар и привязки». Одно предложение нельзя привязать к двум разным товарам общего склада.
5. В блоке «Мониторинг и выгрузка:» включите только нужные площадки. Нажмите «Синхронизировать» и сверьте один товар с кабинетами, затем расширяйте список.

| Что меняется | Как это учитывается |
| --- | --- |
| Продажа или ручное уменьшение на площадке | Уменьшение списывается с общего доступного запаса. |
| Пополнение или возврат | Увеличение на площадке само не создаёт приход. Внесите фактическое количество в общий склад вручную. |
| Непривязанное предложение | Продолжает работать отдельно. |
| Ошибка / неизвестный остаток | Не превращается в подтверждённый ноль. Нужна успешная проверка. |
| Ozon: уже зарезервированный товар | Для обмена используется свободный остаток без резерва; отгрузка уже зарезервированного товара повторно не списывается. |

### Остатки и статусы

- 0 шт. выделены светло-красным; 1-9 шт. - светло-оранжевым; от 10 шт. - обычный фон. Это визуальная подсказка, не автоматический заказ поставщику.
- «Ручной учёт» означает отсутствие действующих привязок; «Приостановлена» - остановленную синхронизацию товара или цикла. «Нужна сверка» требует проверки, а не повторных слепых отправок.
- «Журнал движений» показывает изменения, площадку и детали. Наведение на состояние строки помогает понять последнюю отправку, прочитанный остаток и ожидание.

> **Отдельное прежнее правило WB → Kaspi**
>
> Во вкладке Wildberries есть правило max(0, остаток WB - 2) с привязкой одного варианта WB к пяти SKU Kaspi. Это другой режим. Для предложений, которыми управляет общий склад, REPRIQO пропускает старую выгрузку; не путайте её с независимым ручным запасом.

Halyk Market и Teez доступны в аналитике заказов. Общий склад и перенос карточек для этих двух площадок в версии 1.0.59 не подключены.

<a id="sync"></a>

## 04. Управляйте синхронизацией

*Разные циклы WB/Ozon и Kaspi; восстановление после простоя*

| Управление | Реальное действие |
| --- | --- |
| «Интервал WB/Ozon:» 30 / 60 / 90 сек | Частота автоматического цикла общего склада для WB/Ozon. Это не интервал переоценки Kaspi. |
| «Остановить» / «Запустить» | Останавливает / включает и частый цикл WB/Ozon, и отдельную проверку Kaspi. |
| «Синхронизировать» | Один цикл; при выключенном таймере не включает его обратно. |
| Галочка площадки | Управляет чтением и отправкой именно этой площадки. |
| «Подтвердить остаток» | Ручная сверка фактического общего запаса и снятие блокировки перед новой проверкой. |

### WB/Ozon: прочитать, отправить, подтвердить

Перед выгрузкой читаются остатки FBS. Принятый запрос ещё должен проявиться в последующем чтении; на применение допускается до 3 минут. «Подтверждён» означает совпадение текущего общего количества со всеми активными привязками WB/Ozon. После изменения общего запаса нужно новое подтверждение.

### Kaspi: отправка и отложенная проверка

Отправка остатка Kaspi не ждёт, что новое количество уже появилось в кабинете. HTTP-ответ фиксирует приём запроса. Уменьшения проверяются отдельно раз в 15 минут после последней принятой отправки; новая отправка начинает отсчёт заново. Во время чтения Kaspi его следующая отправка ждёт освобождения запроса.

Ожидание, ошибка или отсутствие сессии Kaspi не задерживают WB/Ozon и их зелёный статус. Для товара только с Kaspi показывается состояние отправки, а не вымышленное подтверждение WB/Ozon. «Отправлено в Kaspi» не равно подтверждению наличия количества в кабинете.

### После сна, пропажи интернета или перезапуска

1. Оставьте программу завершить сверку. Сначала читаются площадки и учитываются уменьшения, затем отправляется актуальный общий запас. Сохранённые ожидания не обнуляются при перезапуске.
2. Если Kaspi требует вход, восстановите тот же кабинет. Сначала программа прочитает остаток и учтёт продажи; старое количество не должно воспроизводиться вслепую.
3. При «Нужна сверка» откройте «Журнал движений» и проверьте реальные предложения, склады и количество. Только затем нажмите «Подтвердить остаток», введите фактический доступный запас и подтвердите. Программа начнёт новую проверку перед выгрузкой.

> **Пример сверки**
>
> Общий склад 10 шт.; последняя отправка каждой площадке - 10. После простоя WB вернул 8, Ozon 9, Kaspi 7. Новые уменьшения 2 + 1 + 3 = 6, общий остаток станет 4. Уже учтённая разница повторно не списывается; увеличение на площадке не считается приходом.

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

<a id="catalog"></a>

## 05. Находите товары и фотографии

*Каталоги, миниатюры и поиск по штрихкоду WB*

### Обновление каталога Kaspi

В «Kaspi» нажмите «Обновить товары». Читается весь каталог «В продаже» текущего кабинета, с учётом лимита тарифа. Существующие ID, цены, настройки и складские привязки сохраняются. Загрузка каталога сама не отправляет цены и остатки. Новые карточки сначала настройте: автопереоценка у них выключена.

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

### Как работают фото

- Фото Kaspi загружаются для видимых строк; при прокрутке подгружаются следующие. Наведите указатель на миниатюру для увеличения. При отсутствии фото в данных продавца используется общедоступная карточка по подтверждённому ID.
- «Обновить товары» повторяет поиск фото текущего кабинета. Если нет подтверждённого ID или карточка недоступна, миниатюра может остаться пустой. Артикул продавца не заменяет ID карточки; чужие фото WB/Ozon в Kaspi не подставляются.
- На общем складе фото WB подбирается по точному артикулу продавца. При неоднозначном совпадении изображение может отсутствовать. Используйте «Обновить данные WB».

### Найдите внутренний товар по штрихкоду WB

1. Подключите Wildberries, загрузите каталог и во вкладке «Склад» нажмите «Обновить данные WB». Убедитесь, что товар привязан к WB либо внутренний SKU точно совпадает с артикулом продавца WB.
2. Нажмите «Сканер · F8» или клавишу F8. По умолчанию выбран режим «Штрихкод товара Wildberries → мой склад». Сканируйте USB/Bluetooth-сканером или введите код и нажмите «Найти».
3. Для камеры нажмите «Включить камеру» и оставьте в кадре один код. Для файла используйте «Изображение кода»; изображение должно быть до 12 МБ. Для поиска собственного кода выберите «Внутренний SKU моего склада».
4. Программа найдёт и выделит товар общего склада. Если кандидатов несколько, выберите нужную строку. Повторное сканирование заменит выделенный предыдущий код.

> **Сканирование - только поиск**
>
> Оно не увеличивает и не уменьшает остаток. Если код есть в WB, но товар не сопоставлен со складом, откройте «Товар и привязки» и добавьте правильную связь. Поддерживаются все сохранённые штрихкоды размеров, включая дополнительные.

Основная строка поиска склада также принимает штрихкод WB. В Ozon ищите по названию, артикулу продавца, Product ID, SKU Ozon и штрихкоду. Копировать ячейку и выделенный текст можно через правую кнопку мыши. Если камера недоступна, проверьте разрешение Windows; USB-сканер и ручной ввод остаются альтернативой.

<a id="repricing"></a>

## 06. Настройте переоценку Kaspi

*Границы цены важнее желаемой позиции*

### Настройте один товар до запуска автоматики

1. В «Kaspi» добавьте или обновите товары. Доступны «Обновить товары», «Импорт из Kaspi XML» и «+ Добавить товар». Откройте «Изменить» у нужной строки.
2. Задайте «Минимальная цена:», «Максимальная цена:» и «Макс. снижение за раз:». Максимум 0 означает отсутствие верхнего ограничения. Максимальная цена не может быть ниже минимальной.
3. Выберите «Режим мониторинга:»: «Минимальная цена в карточке» либо «Конкретный конкурент». Укажите «Быть дешевле:» или своё значение. Проверьте предварительный расчёт и сохраните.
4. Включите «Включить автоматическую переоценку» только у нужных товаров. Проверьте актуальный остаток кнопкой «↻ Остатки», используйте «Проверить» для проверки строки. «⚡ Цена» запускает операцию изменения цены, поэтому сначала проверьте её параметры.
5. Выберите интервал и нажмите «▶ Авто». Для остановки нажмите «■ Стоп». Контролируйте состояние и записи в «История».

| Настройка | Что означает |
| --- | --- |
| Минимальная цена | Нижняя граница рассчитанной цены. Не заменяет расчёт себестоимости и расходов. |
| Максимальная цена | Абсолютная верхняя граница. Имеет приоритет над пределом снижения за раз, если текущая цена выше максимума. |
| Макс. снижение за раз | Ограничение шага снижения, кроме необходимого возвращения под верхнюю границу. |
| Интервал автопереоценки | START: «60 сек» и «5 мин». BUSINESS/VIP: дополнительно «30 сек». Доступность зависит от активного тарифа. |

> **Пример абсолютного максимума**
>
> Текущая цена 19 945 ₸, конкурент 19 950 ₸, минимум 1 800 ₸, максимум 2 100 ₸, максимальное снижение за раз 500 ₸. Итог ограничивается 2 100 ₸, хотя изменение больше 500 ₸.

### Почему цена может не измениться

- «Нет данных» об остатке - это неизвестное количество, а не ноль. Автоцена ждёт успешной проверки. При 0 шт. действует пауза. Нажмите «↻ Остатки» и проверьте точку хранения.
- Сессия Kaspi закончилась, запрос занят, конкурент не найден, расчёт совпал с текущей ценой, товар выключен или тариф ограничивает операцию.
- Для связанного складского товара дополнительная защита может ждать сверки остатков. Не обходите её ручной подстановкой старого количества.

Перед отправкой ограничения цены проверяются повторно. Работа с ценой не является обещанием места в выдаче или доходности: учитывайте комиссии, доставку, рекламу, возвраты и налоги. Интервал «30/60/90 сек» на складе относится к WB/Ozon и не меняет период переоценки Kaspi.

<a id="transfer"></a>

## 07. Перенесите карточки

*Шесть направлений между Kaspi, Wildberries и Ozon*

| Источник | Возможные получатели |
| --- | --- |
| Kaspi | Wildberries, Ozon |
| Wildberries | Kaspi, Ozon |
| Ozon | Kaspi, Wildberries |

### Подготовка и отправка

1. Подключите источник и кабинет получателя. Откройте «Перенос карточек», выберите разные площадки, нажмите «Обновить товары». Отметьте только нужные товары.
2. Нажмите «Подготовить отмеченные». Получатся черновики - это ещё не публикация. Для Kaspi используются данные подключённого кабинета; неполные описания, характеристики и фотографии дополните вручную.
3. Откройте черновик и нажмите «Выбрать категорию». Нужна категория получателя. Список сортируется по похожести, но правильность выбора проверяет продавец.
4. Нажмите «Загрузить характеристики». Заполните обязательные поля и при необходимости «Справочник выбранной характеристики». Совпавшие названия характеристик могут подставляться, но справочные ID одной площадки не заменяют ID другой.
5. Проверьте артикул, название, описание, фото, цену и ограничения получателя. Для WB/Ozon цена задаётся в валюте кабинета получателя: включите «Подтверждаю цену в валюте кабинета получателя». Автоматического пересчёта валют нет.
6. Нажмите «Сохранить и проверить карточку». Для группы используйте «Редактировать отмеченные таблицей» - до 500 черновиков; «Категорию текущей карточки — отмеченным» применяйте только к однородной группе.
7. После проверки нажмите «Отправить отмеченные» и подтвердите публикацию. Смотрите журнал; затем нажмите «Проверить результат». «Остановить перенос» прекращает дальнейшую обработку, но не отменяет уже принятые площадкой карточки.

### Как читать результат

- Принятие запроса, код задания и завершение импорта - разные этапы. Ошибка одной карточки не удаляет подтверждённые результаты остальных.
- Для WB фотографии отправляются после появления созданной карточки при нажатии «Проверить результат». Проверьте их в кабинете.
- Kaspi принимает содержимое карточки. Размещение предложения и модерация выполняются в кабинете Kaspi; перенос не означает, что предложение уже продаётся.
- Повтор уже отправленного артикула блокируется. При сетевом результате «неизвестно» сначала проверьте кабинет и журнал. Не создавайте дубликат другим артикулом без проверки.

> **Перед массовой операцией**
>
> Отправьте одну контрольную карточку. Проверьте категорию, обязательные характеристики, маркировку WB, валюту и фотографии. Только после фактического результата расширяйте группу. Halyk Market и Teez в переносе не участвуют.

Для Kaspi-получателя задайте отдельный «API-токен Kaspi» в этом разделе. Успех зависит от прав API и требований площадки.

<a id="analytics"></a>

## 08. Организации, магазины и заказы

*Подготовьте аналитику отдельно от обмена остатками*

### Настройте «Прибыль и заказы» → «Магазины»

1. Нажмите «Добавить организацию». Введите её параметры. В «Налоги организации» укажите собственные проверенные ставки, базу и НДС; название режима СНР/ОУР не подставляет ставки автоматически.
2. Нажмите «Добавить магазин» либо «Из текущих подключений». Проверьте площадку, ID кабинета, организацию и валюту до первой загрузки. Для WB/Ozon из подключений исходно предлагается RUB.
3. Выберите магазин и нажмите «API-ключи магазина». Данные сохраняются в Windows Credential Manager отдельно для пользователя и магазина; в SQLite ключей нет. Уже подключённые кабинеты используются при совпадении ID.
4. Галочкой «Активен» включите магазин в общую сводку и автозагрузку заказов. Это не включает синхронизацию склада. Выбранный вручную магазин можно смотреть и с выключенной галочкой.

### Загрузите и обработайте список заказов

1. В верхнем фильтре выберите один магазин и период до 31 дня. Откройте «Заказы» → «Загрузить заказы API». Источники: Kaspi, Wildberries, Ozon, Halyk Market и Teez.
2. Ищите по артикулу, названию, номеру заказа и статусу. API показывает состояние площадки. Обычный заказ не является финансовой продажей и не доказывает прибыль.
3. Выделите нужные строки и нажмите «Лист сборки CSV». «Объединить накладные PDF» объединяет выбранные вами локальные PDF. «Открыть кабинет» ведёт к дальнейшей работе с заказом.
4. В «Магазины» выберите «Заказы: каждую минуту», «Заказы: каждые 5 минут», «Заказы: каждые 15 минут» или «Автозагрузка заказов выключена». Автозагрузка читает последние 14 дней активных магазинов.

| Площадка | Нужные данные / особенности |
| --- | --- |
| Kaspi | Отдельный API-токен для заказов. |
| Wildberries | Разрешение Marketplace; суммы берутся из пары convertedPrice / convertedCurrencyCode продавца. Валюта покупателя не подменяет валюту продавца. |
| Ozon | Client ID и API Key с доступом к нужным методам. |
| Halyk Market / Teez | Client ID и Client secret; участие в аналитике заказов, без общего склада и переноса. |

> **Границы сборки**
>
> Модуль не загружает автоматически все накладные через API и не переводит заказы в статусы сборки/отгрузки. Прежняя функция Kaspi «Накладные A4» сохранена: в окне Kaspi откройте нужные заказы и используйте на сайте «Распечатать все накладные».

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

<a id="profit"></a>

## 09. Рассчитайте прибыль

*Финансовый отчёт, себестоимость с датой и полнота расходов*

### Последовательность расчёта

1. В «Прибыль и заказы» выберите магазин, валюту и период до 31 дня. Для Ozon/WB откройте «Прибыль» → «Загрузить отчёт и пересчитать». Для остальных площадок импортируйте «Продажи и расходы» через CSV.
2. Нажмите «Задать себестоимость» либо откройте «Себестоимость» → «Добавить / изменить с даты». Цена задаётся за единицу, по SKU, магазину и дате начала действия. Новая запись не меняет более ранние продажи.
3. В «Налоги организации» проверьте ставки, базу, статус плательщика НДС и «Налоговые параметры проверены». Фактические tax/vat из отчёта имеют приоритет. Настройки применяются при пересчёте строк без фактических налогов.
4. Проверьте столбец «Не хватает», примечания и источник данных. «Пересчитать без загрузки» пересчитывает уже сохранённое; API не запрашивается. «Исходный отчёт JSON» сохраняет исходные операции выбранного магазина без API-ключей.

### Ozon: начисления площадки

Используется финансовый отчёт начислений по дням. «Начислено площадкой» - подписанная итоговая сумма площадки. При наличии этой суммы прибыль считается из неё за вычетом себестоимости, налога и НДС; комиссии и доставка повторно не вычитаются. Пустая разбивка комиссии не означает нулевые расходы.

«Удержания/корректировки» может быть отрицательной из-за корректировок и компенсаций. Если нельзя достоверно определить количество либо отправление содержит несколько SKU без распределения, программа не придумывает прибыль по товарам. Дата финансовой операции отличается от даты создания заказа.

### WB: отчёт может быть неполным

Нужна категория токена «Финансы». Загрузка ежедневных детализаций может ждать до 61 секунды между страницами; доступна «Остановить загрузку». Полная классификация прочих удержаний и рекламы ещё не реализована. Сумма к перечислению за реализованный товар не считается полным итогом всех расходов. Неполная строка не выдаётся за точную прибыль.

> **Неизвестно не равно нулю**
>
> Если расход точно отсутствует, укажите 0. Пустое поле означает неизвестное значение. Пустые расходы или себестоимость не заменяются нулём. При неполных строках общая прибыль не показывается как точная. Для закрытого периода используйте фактические расходы и налоги.

### Валюты и источники

- KZT и RUB - фильтр и валюта магазина, не конвертер. Суммы разных валют не складываются. Прежние магазины USD/EUR открываются в своей валюте. После появления денежных данных переключатель не переименовывает суммы в другую валюту.
- API и CSV хранятся отдельно. Успешная загрузка включает API; «Показать импорт CSV» возвращает CSV без удаления API. Для одного магазина эти источники не суммируются.
- Успешно прочитанный полный период заменяет прежние API-строки этого периода. Остановка/ошибка сохраняет незавершённый прежний отчёт; другие уже успешно загруженные магазины могут обновиться. Финансовая загрузка не меняет цены и склад.

<a id="reviews"></a>

## 10. Отзывы, реклама и находки

*Проверьте причину, затем выполните действие*

### Ответьте на отзыв WB/Ozon

1. Выберите один магазин и период. Откройте «Отзывы» → «Загрузить отзывы API». Используйте поиск «SKU или текст отзыва» и фильтр «Только 1–2 звезды».
2. Выберите один отзыв → «Ответить». Прочитайте исходный текст, напишите ответ и проверьте магазин/площадку в окне подтверждения. Подтверждение отправляет ответ покупателю.
3. Обновите отзывы или проверьте кабинет. Принятие WB не означает публикацию; «Обработан в Ozon» - статус обработки, а не доказательство наличия текста ответа.
4. При неизвестном результате повтор заблокирован. Сначала проверьте кабинет. Только если ответа нет и он нужен, нажмите «Проверил кабинет: разрешить новый ответ».

WB требует прав «Вопросы и отзывы». У Ozon права и подписка кабинета могут ограничивать управление отзывами. Для других площадок предусмотрен CSV-импорт, а не универсальная отправка ответа из REPRIQO.

### Загрузите аналитику рекламы

1. Внизу раздела выберите тип «Реклама» → «Шаблон CSV». Заполните по строке на день кампании: id, date, campaign_id, name, sku, spend, orders, revenue, status.
2. Выберите нужный магазин → «Импорт CSV». На вкладке «Реклама» проверьте расход, заказы, выручку и статус кампании.
3. Для прибыли распределённая реклама должна присутствовать в advertising отчёта «Продажи и расходы». Данные кампаний не вычитаются из прибыли повторно.

> **Реклама здесь - аналитика**
>
> REPRIQO 1.0.59 не включает/выключает рекламные кампании и не управляет ставками. Действующие тарифы и ожидаемая доставка не загружаются автоматически; эти значения вводятся пользователем.

### Используйте «Находки» как список проверок

| Сигнал | Как проверить |
| --- | --- |
| Убыток / дорогая доставка | Убыток определяется по полному расчёту; сравнение доставки требует expected_delivery. |
| Низкий запас / прогноз | Нужна связь internal_sku с общим складом. Прогноз использует чистые продажи последних 30 дней. |
| Отзывы 1-2 звезды | Проверьте, есть ли реальный ответ и требуется ли действие. |
| Срок отгрузки | Сверьте deadline и состояние заказа в кабинете. |
| Реклама без заказов | Сигнал анализирует период не менее 7 дней; проверьте полноту импорта. |

Прогноз запаса = доступный запас / (чистые проданные единицы за последние 30 календарных дней / 30). Неполная история и отсутствие связи с SKU делают прогноз неполным. Для WB допускается точное совпадение артикула с внутренним SKU. Сигнал не создаёт закупку, не изменяет цену и не доказывает причину проблемы.

<a id="tools"></a>

## 11. CSV, калькуляторы и Telegram

*Подготовьте данные и сохраните полезные настройки*

### Правила CSV без потери смысла

Сначала выберите один магазин и тип данных: «Продажи и расходы», «Заказы», «Отзывы», «Реклама» или «Себестоимость» → «Шаблон CSV». Сохраняйте его заголовки в нижнем регистре. Допустимы UTF-8 или Windows-1251; разделители ; , либо табуляция. Шаблон: UTF-8 с BOM и ;. Лимит импорта: 50 000 строк и 20 МБ.

- Даты: YYYY-MM-DD или ДД.ММ.ГГГГ. SKU - строка, включая начальные нули. deadline - ISO-время с часовым поясом, например 2026-11-01T14:00:00+05:00.
- В продажах revenue и расходы - за всю позицию; cost - за единицу в истории себестоимости. 0 означает известное отсутствие, пустая ячейка - неизвестное значение.
- Одна неверная строка отменяет весь импорт магазина. Повторный id обновляет запись без дубликата. «Экспорт вкладки» сохраняет текущую таблицу.
- Полный возврат отражайте отрицательными количеством, выручкой и возвращёнными удержаниями; невозвращённые расходы остаются положительными. Корректировка без единиц имеет quantity = 0.

### Выберите нужный калькулятор

| Раздел | Назначение |
| --- | --- |
| «Калькулятор прибыли Kaspi» в левом меню | Расчёт в тенге: введите себестоимость, цену продажи, доставку и прочие расходы; выберите категорию/подкатегорию и проверьте комиссию со своим кабинетом. Результат обновляется при вводе; действующие цены не изменяются. |
| «Прибыль и заказы» → «Калькулятор» | Ручные тарифы нескольких площадок/схем, выбор валюты, налоги/НДС, резерв возвратов, габариты и доплата за литр. До 50 сохранённых тарифов. |

В многоканальном калькуляторе введите цену, себестоимость, проценты, доставку, прочие расходы, налоги и желаемую прибыль → «Рассчитать». Доступны «Сохранить тариф», «Загрузить тариф», «Сравнить сохранённые тарифы». Сравниваются тарифы одной валюты, с текущими ценой, себестоимостью и габаритами товара. Автоконвертации нет; актуальность ставок проверяете вы.

Выручка включает НДС. Для плательщика НДС себестоимость и расходы вводятся без возмещаемого входящего НДС; невозмещаемый НДС включайте в расходы. Резерв возвратов - процент расходов от выручки, а не прогноз количества возвратов. Расчёт по введённым ставкам не выбирает подходящий налоговый режим.

### Включите уведомления своим ботом

1. Откройте «Прибыль и заказы» → «Уведомления» → «Настроить бота и чат». Нужны токен собственного бота и числовой chat_id.
2. Выберите события, включите «Включить отправку в Telegram», используйте «Тестовое сообщение». Это реальная отправка в заданный чат.
3. Сводка за вчера формируется после 09:00 UTC+5. Доступны отзывы на 1-2 звезды и сроки отгрузки. «Сформировать уведомления» запускает проверку условий.

Уведомления работают при запущенной программе и интернете. Неизвестный результат не повторяется автоматически: сначала проверьте чат, затем «Повторить выбранное после проверки чата». Это исходящие уведомления; командный Telegram-пульт управления складом в этой версии не заявлен.

<a id="help"></a>

## 12. Обновление и поддержка

*Сохраните рабочие данные и передайте поддержке точный контекст*

### Безопасное обновление

1. Остановите автопереоценку «■ Стоп» и склад «Остановить», дождитесь окончания запросов, закройте REPRIQO. Не запускайте две копии программы с одной базой.
2. Сделайте резервную копию папки %LOCALAPPDATA%\REPRIQO при закрытом приложении. Основная база - kaspi_price_manager.db. Ключи Windows Credential Manager в эту папку не входят; после переезда на другой ПК подключения могут потребовать настройки заново.
3. Установите полученное обновление поверх штатной установки. Если вам выдан исходный архив/скрипт, следуйте инструкции именно к этому пакету: он не равнозначен готовому EXE. Не заменяйте базу пустой базой из другого проекта.
4. После запуска проверьте версию, вход REPRIQO, «Подписка», количество товаров, привязки, выбранные склады и цену контрольного товара. Восстановите Kaspi и дайте завершиться сверке после простоя. Затем включите нужные циклы.

### Частые вопросы

| Ситуация | Что сделать |
| --- | --- |
| Kaspi не подключается | Войти во встроенном окне через Email; проверить пароль/код; нажать «Я вошёл — проверить» после загрузки кабинета. |
| Нет части товаров или фото | «Обновить товары»; проверить текущий кабинет, каталог «В продаже», лимит и подтверждённый ID. Пустое фото не означает удалённый товар. |
| Остаток не отправляется | Проверить галочки площадок, мониторинг, склад FBS, связи, доступ и журнал. При конфликте сверить фактический запас и «Подтвердить остаток». |
| Kaspi отправлен, но WB/Ozon уже зелёные | Это разные циклы. Статус «Подтверждён» относится к активным WB/Ozon, Kaspi проверяется отдельно через 15 минут после отправки. |
| Прибыль пустая | Проверить магазин, валюту, период, API/CSV, себестоимость с датой, налоги и «Не хватает». Заказ сам не даёт полного финансового результата. |
| Загрузка WB долго ждёт | Финансовый API требует паузы до 61 секунды между страницами. Смотрите статус, используйте «Остановить загрузку» при необходимости. |
| Нужно работать с командой в облаке | Облачных общих проектов, ролей сотрудников и совместной синхронизации аналитики в 1.0.59 нет. |

### Как обратиться в поддержку

Откройте «Поддержка» или Telegram: https://t.me/RepriqoSupportBot. В приложении также указан Email nixelectonics@gmail.com. Отправьте версию REPRIQO, Windows, площадку, точное название раздела/кнопки, время ошибки, текст статуса и шаги воспроизведения. Прикладывайте обезличенный скриншот или нужные строки журнала без токенов, паролей, кодов и данных покупателей.

При закрытии REPRIQO и сне ПК автоматические циклы не выполняются. Перед ежедневной работой проверяйте подключения, журнал и полноту расходов.