# КП Generator — инструкция для пользователей

Портал ГК Тепломонтаж для подготовки коммерческих предложений.

Адрес портала: **https://kp.24teplo.ru/**

Инструкция без входа: **https://kp.24teplo.ru/help**

Логин и пароль для работы в справочнике и КП выдаёт администратор. Не передавайте их посторонним.

---

## 1. Вход

1. Откройте ссылку портала в браузере (Chrome, Safari, Яндекс.Браузер).
2. Введите логин и пароль.
3. Нажмите **Войти**. Откроется **Реестр КП**.

Сессия держится около двух недель. Кнопка **Выйти** — в шапке справа. **Тема** переключает светлый и тёмный вид.

В меню:

- **Справочник** — материалы и цены
- **Реестр КП** — список документов и создание нового КП
- **Настройки** — только у администратора
- **Справка** — эта инструкция

---

## 2. Как сделать КП — короткий путь

1. **Реестр КП** → **Создать КП**.
2. Выберите **организацию** (шапка PDF и номер документа).
3. Укажите **название клиента**.
4. Добавьте позиции: из справочника кнопкой **В КП** или вручную **+ Добавить позицию**.
5. Проверьте количество, закупку, наценку и продажу.
6. Нажмите **Сохранить и выйти** — документ появится в реестре.
7. Из реестра скачайте **PDF** или **XLS**.

Номер КП выдаётся при сохранении: год (две цифры) + префикс организации (две буквы) + порядковый номер, например `26ТМ0001`.

---

## 3. Справочник

Слева — дерево категорий (ZOTA, Вираж, Holodon). Справа — карточки товаров: фото, название, цена, источник.

- Поиск — поле **Поиск по названию**.
- **В КП** на карточке добавляет товар в текущее коммерческое предложение.
- Если КП ещё не открыто, позиция попадёт в черновик подготовки КП.

Обычный сотрудник не загружает каталоги и не скрывает категории. Это делает администратор.

---

## 4. Подготовка КП

Раздел не в главном меню: в него попадаете через **Создать КП** или **Открыть**.

### Шапка документа

| Поле | Что писать |
|---|---|
| Организация | Юрлицо группы. От неё зависят шапка PDF, НДС по умолчанию и номер КП |
| Название клиента | Как в договоре / на бланке |
| Скидка, % | Скидка от суммы продажи |
| НДС | Без НДС / 5 / 7 / 20 / 22 |
| Описание проекта | Кратко, попадает в PDF |
| Комментарий для заказчика | Срок, условия — в PDF и Excel |
| Внутренний комментарий | Только в портале, в PDF **не** выводится |

### Строки таблицы

Два вида строк:

- **Позиция** — материал или услуга с количеством и ценами
- **Раздел** — заголовок блока (кнопка **+ Раздел**), без цены

Колонки позиции:

- флажок выбора
- **Материал / услуга** — начните вводить, выберите подсказку из справочника
- **Коммент.** — уточнение к строке (в PDF склеивается с названием через пробел)
- **Ед.** — шт, м, м² и другие из справочника
- **Кол-во**
- **Закупка** — ваша цена закупки; значок ссылки открывает источник
- **Розница** — справочно, в итог не входит
- **Нац., %** и **Продажа** — считаются друг из друга
- **Итого** — количество × продажа

Кнопка **цена** у закупки ищет цену по названию. **Enter** в поле названия тоже запускает поиск цены.

### Формулы

В количестве, закупке, рознице и продаже можно ввести выражение, начиная с `=`:

- `=8/3` — количество 2,667
- `=8000/940*5` — цена

Нажмите **Enter** или щёлкните вне поля. Допустимы `+ − * /` и скобки.

### Клавиатура в количестве и ценах

- стрелки **← →** — соседнее числовое поле
- стрелки **↑ ↓** — то же поле в строке выше или ниже
- **Enter** — то же поле на следующей строке (на последней строке добавится новая)

### Выбор нескольких строк

Флажок в начале строки. **Shift+клик** — диапазон. Появятся кнопки **Выше**, **Ниже**, **Копировать**.

### Сводка материалов

Под таблицей одинаковые позиции **суммируются**, если совпадают название, единица, закупка, продажа и наценка. Если цена или наценка разные — отдельные строки.

Правка цены в сводке меняет все строки этой группы. **Наценка на все, %** проставляет наценку всем позициям КП.

### Итоги справа внизу

Сумма закупки, наценка (процент и сумма), сумма продажи, скидка, НДС, итог к оплате.

### Кнопки документа

| Кнопка | Действие |
|---|---|
| Сгенерировать PDF | Сохраняет КП и скачивает PDF A4 |
| Выгрузить в XLS | Сохраняет и скачивает Excel |
| Сохранить и выйти | Пишет в реестр и открывает список КП |
| Обновить цены справочника | Подставляет актуальные закупки из каталога по позициям этого КП |
| Поделиться ссылкой | Копирует внутреннюю ссылку `/p/…` (нужен вход в портал) |
| Копировать себе | Если открыто чужое КП — создаёт вашу копию |

PDF помечен: «Не является офертой». Внутренний комментарий и ссылка на витрину в PDF не печатаются.

Черновик также запоминается в браузере. Надёжная копия — только после **Сохранить и выйти** или PDF/XLS.

---

## 5. Реестр КП

Колонки: номер, клиент, организация, проект, кто создал, дата.

- фильтр ищет по всем полям
- клик по заголовку колонки сортирует список
- **Открыть** — редактирование (своё КП) или просмотр (чужое)
- **Копировать** — ваша копия с новым номером
- **PDF** / **XLS** — сразу из списка

Чужое КП нельзя править: только просмотр или **Копировать себе**.

### Удаление

- Своё КП в течение **24 часов** после создания можно удалить сразу.
- Позже ставится **пометка на удаление** — окончательно убирает администратор.
- Администратор может удалять выбранные КП из реестра.

---

## 6. Права доступа

**Пользователь**

- справочник (без загрузки каталогов)
- свои КП: создание, правка, PDF, Excel
- чужие КП: просмотр или копия себе

**Администратор** — всё выше, плюс настройки, загрузка справочника, все КП, массовое удаление.

---

## 7. Для администратора

### Пользователи (Настройки → Пользователи)

ФИО, логин, роль (пользователь / администратор), пароль, почта, флажок «Активен». Неактивный не войдёт.

### Организации

Название, **префикс КП** (ровно две буквы), ИНН (10 или 12 цифр либо пусто), ставка НДС, телефон, почта, адрес, логотип. Последнюю организацию удалить нельзя.

Пустой ИНН в документах остаётся пустым — цифры не выдумываются.

### Единицы измерения

Обозначения для выпадающего списка в КП. Последнюю единицу удалить нельзя.

### Справочник

Кнопки **Загрузить / Продолжить** ZOTA, Вираж, Holodon и **Обновить цены**. Пока идёт загрузка, вверху видно ход работы. Если товары открытых категорий и фото уже на месте, «Продолжить» отключается — цены тогда обновляют кнопкой **Обновить цены**.

Скрытые категории не попадают в работу менеджеров. Остаток товаров в скрытых категориях в статистике указан отдельно.

---

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

**Не могу войти.** Проверьте адрес https://kp.24teplo.ru/, логин без пробелов, раскладку клавиатуры. Если забыли пароль — напишите администратору.

**Нет кнопки «Настройки».** Вы вошли как обычный пользователь — так и должно быть.

**Цена в справочнике не та.** Попросите администратора обновить цены или нажмите в КП **Обновить цены справочника** (обновит позиции этого документа, которые находятся в каталоге).

**PDF без логотипа.** Загрузите логотип организации в Настройках (администратор) и выберите эту организацию в КП.

**Формула не считается.** Строка должна начинаться с `=`. После ввода нажмите Enter.

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

---

Вопросы по порталу: администратор ГК Тепломонтаж, Красноярск, +7 (391) 291-19-09, info@24teplo.ru.
