Установка: Надежность прогноза продаж

Перед установкой

Установку выполняет пользователь Битрикс24, которому разрешено устанавливать приложения. Для первичной проверки понадобится доступ к сделкам CRM.

Уточните у поставщика актуальный способ доступа к установке. Публичная ссылка на приложение в Маркете в этой инструкции пока не указана; наличие опубликованной карточки не предполагается.

В установочном экране приложения нет полей для ручного ввода ключей доступа, паролей или адресов внешних сервисов.

Установка

1. Откройте доступную вам страницу установки приложения «Надежность прогноза продаж» в нужном портале Битрикс24.
2. Запустите установку приложения.
3. Ознакомьтесь с запрашиваемыми правами: CRM и минимальный доступ к пользователям.
4. Подтвердите предоставление этих прав.
5. Дождитесь завершения шагов «Подключение к Битрикс24», «Регистрация портала» и «Подтверждение установки».
6. Проверьте сообщение «Установка завершена», если экран установки остаётся открыт.
7. Откройте установленное приложение в Битрикс24.

Не закрывайте окно во время выполнения установки. Сообщение об ошибке на одном из шагов означает, что завершение установки ещё не подтверждено.

Необходимые права и доступ

Приложению нужны две области доступа:

• crm — для получения сделок, по которым строится отчёт.
• user_brief — минимальный доступ к сведениям о пользователях, используемый для отображения имён ответственных.

Более широкие области user_basic и user для этой версии не требуются. Приложение отображает имя и идентификатор ответственного и не редактирует профили пользователей.

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

Первоначальная настройка

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

Конечная дата не включается. Например, период с 1 по 30 сентября задаётся датами 1 сентября и 1 октября. Для первичной проверки выбирайте период, в который также попадают даты закрытия доступных вам сделок.

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

Если в выборке несколько валют, не считайте общий итог единой сопоставимой денежной суммой: автоматическая конвертация валют не поддерживается.

Проверка установки

1. Убедитесь, что приложение открывается внутри Битрикс24 без сообщения об ошибке подключения.
2. Проверьте режим «Данные портала», а не «Демо-данные».
3. Убедитесь, что доступны фильтры периода и часового пояса.
4. Нажмите «Обновить».
5. Проверьте, что появился отчёт либо понятное сообщение об отсутствии данных за выбранный период.
6. При наличии строк сделок проверьте отображение ответственного по имени.
7. Нажмите «Открыть» в строке сделки и убедитесь, что открылась соответствующая карточка Битрикс24.

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

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

Подробное объяснение показателей и сценариев работы находится в разделе «Документация» в левом меню.

Частые проблемы при установке

Установка не завершена

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

Недостаточно прав

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

Вместо имени показан идентификатор менеджера

Проверьте, предоставлено ли приложению право user_brief. Если право есть, повторите загрузку отчёта. Не расширяйте доступ до user_basic или user только ради отображения имён. При недоступности имени приложение сохраняет расчёт и показывает идентификатор.

Открылись демоданные

Закройте автономно открытую страницу и запустите установленное приложение внутри нужного портала Битрикс24. Деморежим не подтверждает подключение к вашим сделкам.

После установки нет сделок

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

Данные не загрузились

Повторите запрос кнопкой «Обновить». Если ошибка повторяется, сообщите поддержке портал, время и выбранный период. Не отправляйте секретные ссылки установки или данные авторизации.

Показано предупреждение о частичных данных

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

Что необходимо уточнить перед публичным распространением

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