ИНТЕГРАЦИИ (взаимодействие с внешними интерфейсами)


Сканирование документов в приложении Макс

Как считать данные в системе?

Добавлена возможность сканирования данных из QR-кода (штрих-кода) документа (паспорта, свидетельства о рождении) в приложении MAX - для автоматического заполнения паспортных данных гостя в АСУ Эдельвейс.

Вам понадобятся:
- версия АСУ Эдельвейс - не ниже 7.26.05 (май 2026-го года)
- отключить программы переключения раскладки (Punto switcher, RuDeskTop и т.п.)
- актуальная версия модуля сканирования C:\EDEL\EdelEx\EdelExTools.exe - СКАЧАТЬ...

- 2D сканер (QR)

Требования к 2D сканеру (QR):
- поддержка формата PDF417
- кодировка UTF8 или CP1251 (Кириллица)
- поддержка режима USB HID (режим эмуляции клавиатуры) 

Порядок действий пользователя для добавления данных в карточку гостя из приложения MAX (МАКС).

1. В карточке резервирования, необходимо перейти на вкладку "Гости" и нажать кнопку "Сканировать документ в МАКС":

изображение.png

2. Откроется окно "Сканирование паспорта - Мессенджер MAX" с курсором в первой строке:

image.png

3. Гостю нужно открыть мессенджер Макс - перейти в "настройки" - "Цифровой ID" - выбрав документ: "Паспорт" или "Семья и дети" - выбрав ребёнка и его Свидетельство о рождении

Сканировать можно и штрих-код, или нажав на этот штрих-код - открывшийся QR-код с данными паспорта.

изображение.png

4. После сканирования производится разбор данных и их заполнение. Проверьте корректность данных. Затем нужно нажать кнопку "Применить" и произойдет заполнение паспортных данных в карточке гостя.

изображение.png

Паспортные данные гостя добавлены в карточку гостя:

изображение.png

Тип документа (паспорт или свидетельство) определяется и устанавливается автоматически.

Обратите внимание - для корректного заполнения адреса используется функция распознавания отсканированного адреса в системе dadata согласно справочника УФМС. При отсутствии доступа в сеть интернет на компьютере
Полный адрес гостя может заполниться одной строкой из паспорта.

image.png

Адрес проходит проверку в сервисе DADATA и должен корректно заполняться по полям таким образом:

image.png

В случае отсутствия приложения - будет выводится сообщение об ошибке его открытия

изображение.png

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

В случае необходимости, проверка правдивости и корректности данных через "Цифровой ID" регламентируется законодательством и может выполняться только аккредитованным сотрудником (проверяющим) при наличии связанной записи на портале Госуслуг.

- Сканеры которые нельзя покупать для работы с МАКС

Сканеры из данного списка не подходят:

Как подтвердить личность гостя?

С 1 сентября 2026 года обеспечение возможности по заселению через мессенджер MAX будет обязательным для отелей с номерным фондом 50+!

Инструкция по проверке личности от разработчиков мессенджера MAX

Интеграция с Emis

Если при попытке зайти в ЛК Emis постоянно спрашивается логин и пароль, то необходимо проверить какую ссылку мы генерируем.

Для этого в cfg.ini проверяем параметр:

Далее при нажатии на

image.png

проверяем, что пишется в \LOGS\Emis.log

должна быть запись:

https://emis.g1sw.com/hms/person/new?hp_id=4617&stay_till=13-12-2024&room_number=105

без логина и пароля.

Если &user и &paswword присутствуют, то это значит, что ранее они были заполнены и их следует удалить (для этого обратитесь в техподдержку АСУ Эдельвейс)

Ссылка такого формата должна генерироваться с версии Эдельвейса 7.25.06 от 26.06.2025

Правила генерирования ссылки от Emis:

1) если указаны email=some@email и passsword=some-password, то авторизация выполнится с указанием переданных значений
2) если указаны email= и password= (без значений), то выполнится принудительный перевод на страницу авторизации
3) если не указаны email и password, то откроется страница с EMIS и последним состоянием пользователя - если авторизован, то он продолжит работать, если токен закончился или не был авторизован, то откроется страница авторизации как обычно

Если в логе видим запись:

https://emis.g1sw.com/hms/person/new?hp_id=4617&stay_till=13-12-2024&room_number=105

значит вопросы к Emis.

Webhook

PUSH при одной учетной записи ожидается к нам:

POST http://localhost:9000/emis/ready?hp_id=3785

Macroscop - управление автомобильной парковкой


Интеграция с системой "Macroscop" - пропуск/блокировка по номеру автомобиля

Интерфейс с системой видеонаблюдения Macroscop  предназначен для реализации управления автомобильной парковкой.

 В интеграции реализована следующая функциональность:

  • Получение списка групп автомобилей из базы автономеров
  • Добавление записи о новой автомашине в базу автономеров
  • Обновление существующей записи об автомобиле в базе автономеров
  • Удаление записи об автомобиле с указанным идентификатором из базы

При указании номера автомобиля в карточке гостя, информация о госте и номере автомобиля автоматически передается
в Macroscop в соответствующую группу автомобилей.
При запросе из Macroscop информации обо всех автомобилях группы “Управление парковкой” (условно), после получения списка происходит загрузка информации о бронированиях за указанный период из АСУ “Эдельвейс”.
Если номер автомобиля есть в обоих списках, отправляется команда на обновление данных.
Если в списке Macroscop нет номера, отправляется команда на добавление записи. По бронированиям, имеющим статус “Выезд” за указанный период, передаётся команда удаления записи в Macroscop.

https://macroscop.com/produkty/programma-dlya-ip-kamer/raspoznavanie-avtonomerov 

Настройка сканера Zebra

изображение.png

изображение.png

Настройка сканера для сканирования в приложении MAX (Макс)

Процесс настройки зависит от конкретной модели сканера.


Например, Zebra 2208 (рекомендуемый) настраивается таким набором штрих-кодов:

 image.png

Результат сканирование в блокнот в кодировке UTF8 с включенной русской раскладкой клавиатуры будет примерно таким:

image.png

Если сканер не поддерживает UTF8 (или настроен на кодировку CP 1251) результат сканирования в блокнот будет примерно таким:

image.png


Работа с другими форматами не поддерживается.

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

 

Учетная запись не подтверждена - MAX (МАКС)

Учетную запись в мессенджере MAX нужно подтверждать через ГОСУСЛУГИ.
Если подтверждение не было выполнено - отсканировать QR-код не выйдет.

image.png