# Настройки Раздел содержит профиль лаборатории, параметры нарядов и печати, периоды начисления ЗП, SMTP, настройки MAX-бота и матрицу прав доступа. На вкладке `Параметры лаборатории` настройки разнесены по внутренним вкладкам: `Реквизиты`, `Наряды и печать`, `ЗП`, `Почта`, `MAX-бот` и `Комментарий`. Кнопка сохранения общая для всех этих вкладок. ## Профиль и общие настройки Во вкладке `Реквизиты` заполняются данные лаборатории для счетов, актов и печатных форм: - название лаборатории, юридическое название и короткое название; - юридический и почтовый адрес; - телефон, e-mail, ИНН, КПП, ОГРН; - банк, БИК, расчетный и корреспондентский счет; - руководитель, главный бухгалтер и режим НДС. Эти поля используются в шапке счета на оплату: получатель, ИНН, КПП, банк, БИК, расчетный и корреспондентский счета берутся из профиля лаборатории. Поле `Название базы / интерфейса` задает название, которое показывается в шапке приложения, заголовке вкладки браузера и используется как рабочее название лаборатории. В блоке общих настроек задаются валюта интерфейса, время сдачи по умолчанию и параметры нумерации нарядов. `Автоматически присваивать номер` включает генерацию номера нового наряда. Если переключатель выключен, номер нужно вводить вручную при создании наряда. `Единая нумерация нарядов` управляет тем, как выбирается следующий номер: - включено - номера идут единой последовательностью по всей лаборатории; - выключено - у каждого заказчика своя последовательность номеров. По умолчанию используется отдельная последовательность по каждому заказчику. Префикс и длина номера задают внешний вид автоматически созданного номера. Пример показывается рядом с настройкой. `Отображение сумм в Наряде у Операций` включает или скрывает суммы в списке операций наряда. Если настройка включена, в карточке наряда и в агрегированном списке операций показываются ставка, сумма операции и итог по операциям. Если выключена, остаются только производственные данные операции без денежных сумм. `Печать реквизитов в наряде и реестре выполненных работ` включает блок реквизитов лаборатории в печатной форме наряда и в печатной форме отчета `Реестр выполненных работ`. Данные берутся из заполненных полей профиля лаборатории. `Печать логотипа в наряде, акте и печатных отчетах` включает логотип лаборатории в печатных формах. Логотип загружается в этом же блоке настроек; поддерживаются JPG, PNG, WebP и SVG до 2 МБ. Если логотип удален, печатные формы выводятся без него, даже если переключатель включен. ## Периоды начисления ЗП Поле `Начало расчетных периодов ЗП` задает дни месяца, с которых начинаются зарплатные периоды. Можно выбрать один день, например `1`, или несколько дней, например `10` и `25`. После сохранения система показывает текущий и предыдущие расчетные периоды. Зарплатные отчеты используют эти периоды для быстрого выбора дат: `1` дает период с 1 числа до конца месяца, `10` - с 10 числа до 9 числа следующего месяца, `10` и `25` - два периода: с 10 по 24 и с 25 по 9. ## SMTP Блок `SMTP и почтовая отправка` используется для отправки счетов и актов заказчикам: - `SMTP host` и `SMTP port` задают адрес SMTP и порт; - `SMTP логин` задается полным e-mail; форма не сохраняет логин без e-mail-формата. Если поле `E-mail отправителя` не заполнено, этот адрес используется как отправитель; - `Новый пароль SMTP` меняет сохраненный пароль; - `E-mail отправителя`, `Имя отправителя` и `Reply-To` попадают в исходящие письма; - `STARTTLS` и `SSL` включаются в зависимости от настроек почтового сервиса. Если пароль уже сохранен, поле пароля можно оставить пустым. ## MAX-бот для техников Блок `MAX-бот для техников` настраивает подключение бота, через который техник может работать с операциями нарядов: - `Включить MAX-бота` включает обработку webhook-запросов от MAX; - `Токен бота` используется для отправки сообщений и проверки подписи контакта при привязке телефона; - `Webhook secret` проверяется по заголовку `X-Max-Bot-Api-Secret`; - `MAX API URL` задает адрес API MAX; - `Публичный webhook URL` хранит внешний HTTPS-адрес webhook, который нужно указать при настройке подписки бота. Для рабочей системы по адресу `https://dental.maharram.ru` публичный webhook URL: `https://dental.maharram.ru/api/v1/max-bot/webhook`. Токен и webhook secret после сохранения не отображаются в открытом виде. Если значение уже сохранено, поле можно оставить пустым. Переключатели сброса удаляют сохраненные секреты. Для привязки техник запускает бота, делится телефоном и подтверждает найденную учетную запись. Телефон должен совпадать с телефоном сотрудника или связанного техника в системе. ### Что умеет MAX-бот После привязки учетной записи техник может: - открыть `Делаю` и увидеть операции, которые уже взяты в работу; - открыть `Очередь` и увидеть операции по найденным нарядам; - отправить номер или код наряда текстом, чтобы найти наряд и добавить его операции в очередь; - нажать `Взять`, чтобы закрепить доступную операцию за собой и перевести ее в работу; - нажать `Готово`, чтобы завершить свою операцию; - открыть `Готово`, чтобы увидеть завершенные операции за текущий период; - открыть `Статистика`, чтобы увидеть количество операций в работе, завершенные операции и начисленную сумму; - нажать `Отвязать`, чтобы убрать связь MAX-аккаунта с учетной записью. Команда `/start` начинает работу с ботом и повторно показывает привязку, если аккаунт еще не связан. Команда `/help`, `help`, `помощь` или `справка` показывает справку внутри бота. Бот не меняет справочники, пользователей, права, платежи, настройки, состав наряда и завершенные операции. Смена исполнителя и отмена завершения выполняются в web-интерфейсе. ### Как настроить MAX-бота 1. Создайте бота в MAX и получите токен. 2. В разделе `Настройки` включите `Включить MAX-бота`. 3. Вставьте токен в поле `Токен бота`. 4. Укажите `Webhook secret` и используйте такое же значение при настройке подписки webhook на стороне MAX. 5. Оставьте `MAX API URL` равным `https://platform-api.max.ru`, если не требуется другой адрес. 6. В поле `Публичный webhook URL` укажите `https://dental.maharram.ru/api/v1/max-bot/webhook`. 7. Сохраните настройки. 8. На стороне MAX настройте webhook-подписку на этот публичный URL. ## Права доступа Во вкладке `Права доступа` права назначаются в двух режимах. `По правам`: - выберите право в левом поле; - в среднем списке нажмите сотрудников, которым нужно выдать или снять это право; - сотрудники с выбранным правом подсвечиваются синим; - справа отображаются сотрудники, у которых право выбрано; - двойной клик по сотруднику справа снимает право; - нажмите `Сохранить`, чтобы применить изменения. `По сотрудникам`: - выберите сотрудника; - в среднем списке нажмите права, которые должны быть у сотрудника; - выбранные права подсвечиваются синим; - справа отображаются права сотрудника; - двойной клик по праву справа снимает его; - нажмите `Сохранить`, чтобы применить изменения. Переключатель `Сотрудники с логином` оставляет в списке только сотрудников с заполненным e-mail-логином. ## Основные права доступа - `Настройки (2)` - доступ к настройкам лаборатории. - `Справочники РОМТ (3)` - работы, операции, материалы и техники. - `Склад (4)` - наличие материалов, приходы, расходы и инвентаризация. - `Наряд. Создание (5)` - создание наряда. - `Наряд. Операции (6)` - операции внутри наряда и подстановка главного техника в операции. - `Наряд. Закрытие (7)` - закрытие наряда. - `Наряд. Работы (8)` - добавление, изменение и удаление работ внутри наряда. - `Отчеты (9)` - аналитика и отчеты. - `Наряд. Изменение (10)` - изменение шапки и общих параметров наряда без управления составом работ. - `Платежи (12)` - платежи и распределение оплат. - `Удаление (13)` - удаление, возвраты из нарядов и откаты закрытия. - `Справочники ЗВ (20)` - заказчики и врачи. - `Готов. Отправлен (21)` - признаки готовности и отправки. - `Статус операций (24)` - смена статуса операций в наряде.