Уважаемые пользователи! Если не нашли ответ на свой вопрос в базе знаний, пожалуйста, напишите нам на почту support@ecvi.ru

Взаимодействие с внешними интерфейсами

Модуль бронирования на сайте отеля

HMA Ecvi имеет свою форму бронирования, которую можно интегрировать в сайт отеля и предоставить гостям бронировать и оплачивать номера(места) в режиме онлайн.

HMA Ecvi: предварительные настройки

Канал бронирования

Для Экви форма бронирования является, по сути, еще одним “каналом продаж”, как и например стыковка с booking.com. Поэтому прежде всего в разделе Администрирование - Отель - Веб-каналы должен быть включен необходимый канал.

image.png
Рис. 1


Как правило, канал создается и активируется по вашему запросу службой технической поддержки через почту support@ecvi.ru

Типы ресурсов

Все типы ресурсов (типы комнат, коек, коттеджей и т.п.), которые вы хотите представлять в форме на сайте, должны иметь определенные настройки в своих свойствах  в разделе Администрирование - Отель - Типы ресурсов - кнопка image.png Редактировать, в обязательном порядке должны быть указаны следующие параметры:

image.png
Рис. 2

Дополнительно можно указать:

Дополнительные опции и загрузка изображений

Для указания того, какие опции присутствуют в номере (фен, кондиционер, телевизор и т.п.), а также для загрузки галереи изображений, нажмите кнопку image.png в правом верхнем углу:

image.pngРис. 3

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

image.pngРис.4

image.png
Рис. 5

Обратите внимание, что при загрузке изображений есть ограничение на максимальный размер файла: 2 Мб. Однако для ускорения работы формы (и учитывая, что изображения всё равно масштабируются для демонстрации в небольшом окне), рекомендуем ограничить размер фотографий максимум 300-500 кб.

Тарифы и питание

image.png
Рис.6

В свойствах пакетов питания и в свойствах тарифов, которые должны быть представлены в форме бронирования, необходимо установить флажок Экспорт. Также рекомендуется ввести Полное описание, которое поможет гостю сориентироваться в услугах.

Обратите внимание, что пакеты питания следует редактировать в разделе Администрирование - Услуги - Список пакетов услуг, 

а тарифы - в разделе Администрирование - Услуги - Список тарифов.

Модуль бронирования

Модуль бронирования, выполненный по технологии iframe,  состоит из двух основных частей: 

image.pngРис.7 Виджет бронирования


Стартового виджета, который может быть установлен на любой странице вашего сайта и служит “отправной точкой” для начала процесса бронирования.

image.png
Рис.8 Форма бронирования

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

Генерация кода виджета

Задание основных параметров виджета и генерация его кода выполняется в разделе Администрирование - Отель - Настройка модуля бронирования.

image.png
Рис. 9

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

Код виджета

image.png
Рис . 10


Если ранее код виджета не был создан, то необходимо нажать Редактировать, затем заполнить все необходимые поля в форме, нажать Генерировать и затем Сохранить полученный результат.


Поля для заполнения:

Рис. 11

Более подробный пример того, что нужно сделать для получения работоспособных компонентов:

Обратите внимание

После заполнения всех полей необходимо выполнить следующие 4 шага:

Типовые сценарии использования модуля


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


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

2. У отельера есть два раздела на сайте. Предположим, что это Гостевые дома и Гостиница. Задача: что при заходе посетителя сайта в раздел “Гостевые дома” предвыбранными в виджете становятся гостевые дома, а остальные отели (Гостиница) недоступны.


Для этого следует: сгенерировать и сохранить код в “Гостевых домах”, добавить его на соответствующую страницу, указав при этом в параметрах "Не показывать в данном виджете остальные отели в цепочке" и "Сделать предвыбранным в виджете текущий отель".

3. Также вы можете просто сделать предвыбранным отель в рамках цепочки, просто выбрав соответствующую опцию, сгенерировав, сохранив код и вставив его на нужную страницу.

Английский вариант формы бронирования

Для того чтобы заработала англ. версия виджета нужно:

1. В разделе "Администрирование" отеля заполнить английские названия для тарифов, питания и названий ресурсов. Добавить описания на английском для номеров, тарифов и пакетов питания;

2. Сгенерировать новый код виджета, если у вас до этого стояла версия без поддержки английского языка;

3. В html коде страницы, на которой стоит виджет (на английской версии сайта), прописать в теге <html lang="en">.

Фиксированная кнопка “Забронировать”

Если Вы хотите зафиксировать кнопку “забронировать”, т.е. чтобы она всегда была на верху виджета бронирования, то нужно: 

#YourID {

    height: 700px !important; /* здесь настраивается высота формы бронирования */ 

}


#ecvi-booking-container {

    height: 700px !important; /* здесь настраивается высота формы бронирования */

}

Где YourID id блока куда вставляется форма бронирования.

image.png
Рис. 12

Изменение дизайна виджета бронирования

Форма и виджет  бронирования поставляются с базовым дизайном, но если Вы или кто то из ваших сотрудников обладает минимальными навыками web верстки (разработки сайтов), то можно изменить цвета кнопок, полей / шрифты / формы бронирования. А также скрыть ненужные элементы виджета.

Для того, чтобы подстроить виджет под дизайн вашего сайта нужно:


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

image.png

Рис. 13


Виджет в горизонтальном стиле


image.png

  Рис. 14 Виджет (слева) и основная форма бронирования.


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

Первый: просто вставить основную форму бронирования без виджета. тогда при нажатии на кнопку “Новый поиск” основная форма будет раскрываться на той же страничке, где находится.

Второй: 

1.Сгенерировать и вставить код основной формы бронирования на страницу бронирования вашего сайта например на www.myhotel.com/bronirovanie 

при этом в коде виджета настройка bookingPath должна сгенерироваться примерно такой : 

bookingPath: ‘www.myhotel.com/bronirovanie‘

2. Вставить этот же код на главную страницу вашего отеля. bookingPath в коде формы будет такой же как и у странички бронирования, тогда форма с главной страницы будет перенаправлять на страницу бронирования.

Не забудьте перед вставкой кода создать <div id=”вашID”> </div> куда будет вставляться виджет/форма.

Не показывать блок с выбором питания

Если у вас нет отдельной услуги с питанием, то эту информацию можно скрыть, для этого можно воспользоваться тем же css файлом, где вносили изменения в цвете и дизайне виджета.
Для начала можно скрыть блок с id  #nutrition прописав в файле #nutrition {display:none}, затем для красоты можно расширить колонку с тарифами. Пропишем там же #rate {width:200%}

В результате получим такой вид см. Рис 15.

image.png
Рис. 15

Промокоды

Настройка промокодов позволяет бронировать клиентам номера со скидкой  только на вашем сайте. Промокоды могут действовать на выбранных вами тарифах в определенный период проведения акций.
Для начала нужно создать сами промокоды, для этого перейдем в раздел Администрирование -> Услуги -> Промокоды (см. рис. 13), в этом разделе по кнопке image.png Добавить промокод можно создать новый промод, необходимо заполнить следующие поля: 

Завершающий этап настройки - для того чтобы активировать промокоды на используемых в модуле тарифах, то нужно в подразделе “Список тарифов” зайти в настройки тарифа по кнопке image.png Редактировать и поставить галочку “Применять промокоды”.

Пример использования - чтобы на новогодние каникулы предоставлялась скидки для клиентов которые будут бронировать номера в начале декабря, то вам нужно указать действителен с 1 декабря до 10 декабря. Заезд с 1 января до 14 января.
Также следует учитывать, что если клиент заезжает 14 января, а выезжает 14 февраля, то клиент получить скидку на весь период проживания, так как дата заезда попадает в период проведения акции.

image.png
Рис. 16


Примеры грамотно настроенных модулей бронирования наших клиентов

Демо:

http://demo.ecvi.ru/form_example/index.html

Сайты отелей:

https://otdih-v-astrakhani.ru/

https://ayvengo45.ru/online-booking 

https://port-inn.ru/en/booking

Подключение ЮKassa

Для того, чтобы дать возможность гостю оплатить заявку в режиме онлайн (с использованием банковских карт, Яндекс.Деньги и пр.), есть возможность подключить форму к платежной системе ЮKassa. Для этого необходимо выполнить следующие действия:

image.png
Рис.17

image.png
Рис.18

image.png
Рис.19

Подключение СБЕР

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


  2. Получить логин/пароль от боевого личного кабинета торговой точки https://securepayments.sberbank.ru/mportal3/auth/login

  3. Из данного кабинета написать в службу тех.поддержки сбербанка и прислать им следующий текст “Здравствуйте, просим прислать нам данные для перехода из тестового режима в рабочий  1. Боевой токен для аутентификации 2. боевой закрытый ключ. 3. боевой логин и пароль для API. Наш url для уведомлений обратного вызова https://hma.ecvi.ru/kassa/sberbank/check"
    Для отелей с адресом apart.ecvi.ru url для уведомлений обратного вызова - https://apart.ecvi.ru/kassa/sberbank/check

Дополнительные параметры не нужны; HTTP-метод - Get; Тип callback - Статический; Тип подписки - Симметричный; Только открытый ключ.

Подключение CloudPayments

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

  1. Зарегистрироваться на сайте https://cloudpayments.ru/

  2. Заполнить анкету юридического лица и заключить договор cloudPayments

  3. В личном кабинете cloudPayments необходимо в разделе сайты добавить сайт с адресом https://hma.ecvi.ru

    image.png
    Рис.20


  4. После этого перейдите в настройка созданного сайта,  отметьте галочку “Pay уведомления”. Для уведомлений пропишите следующий адрес: https://hma.ecvi.ru/kassa/cloudpayments/pay не забудьте включить боевой режим для сайта.

    image.png
    Рис.21

  5. Там же можно скопировать public ID, который необходимо прописать уже в нашей системе в разделе Администрирование->настройка модуля бронирования->Выбор и настройки платежной системы

  6. Не забудьте также в настройках модуля бронирования отметить галочки “Заносить оплату на счет” и “Создать уведомление в системе“


Кассовые чеки и требования 54-ФЗ

Также следует учитывать, что для выполнения требований 54-ФЗ (правил проведения платежей) все оплаты должны проводиться по кассе. 

Яндекс.Касса предлагает дополнительные возможности по передаче данных о произведенном платеже в арендованную у их партнеров онлайн-кассу. Подробнее об этом способе оформления платежей можно прочитать по ссылке:

https://yandex.ru/support/checkout/merchant/online-sales-register.html

Данные для формирования чека таким образом форма бронирования (HMA Ecvi) в Яндекс.Кассу передает. Включить передачу чека через Яндекс.Кассу, указать наименование услуги, которая будет фигурировать в электронном чеке, а также ставку НДС следует в разделе Администрирование - Отель - Настройка модуля бронирования:

image.png
Рис.22

В качестве альтернативы вы можете вручную оформлять данные платежи на своем кассовом аппарате. Для этого в разделе настроек Модуля бронирования перейдите к группе параметров Настройки ОФД. 

Флажок Заносить оплату на счет определяет, будет ли система автоматически создавать платеж на лицевом счете гостя. В случае, если регистрируете платежи автоматически с помощью онлайн-кассы партнеров Яндекса или Сбербанка, платеж можно заносить автоматически (флажок должен быть установлен). Если вы планируете проводить платежи вручную - снимите флажок “Заносить оплату на счет”. А для того, чтобы не пропустить факт проведения гостем онлайн оплаты и знать её характеристики, вы можете установить флажки:

Создавать уведомление в системе - информация появится в списке уведомлений на иконке в верхнем правом углу рабочего экрана;

Создавать напоминание по заявке - сообщение о платеже появится в подразделе Напоминания в карточке заявки и в разделе Заявки - Напоминания.

После выполнения этих шагов можно принимать платежи.





Выгрузка данных в 1С

Видео-уроки по работе интеграции доступны по ссылке.
Подробная текстовая инструкция доступна по ссылке.

Общая информация

Интеграция между ECVI и 1с реализована с помощью подключаемой в 1с внешней обработки, которая предоставляется по запросу через электронную почту support@ecvi.ru (в запросе укажите название отеля).

Перед началом работы следует прописать настройку "1C ID" для используемых в работе типов оплат: наличные, карта и БН, для этого переходим в модуль Администрирование - Разное - Справочник типов платежей - поочередно вызываем режим редактирования и прописываем в поле 1С ID (проверяем если значения уже были прописаны):

Выгрузка данных из ECVI осуществляется через XML-файлы, которые можно сформировать по кнопке из интерфейса ECVI - Операции - Выгрузка в 1С v3:

image.png

С помощью дополнительных полей пользователь указывает:
- период выгрузки (по умолчанию с начала месяца до заданной даты в поле "по");
- тип данных (реализации и оплаты / только реализация / только оплаты);
- признак "Выгружать уже выгруженные данные" - используется в том случае, если в текущем месяце уже производилась выгрузка данных и, по усмотрению пользователя, необходимо повторно включить в выгрузку данные, которые выгружались ранее.

По кнопке Выгрузить система начнет процесс формирования данных (до 1-2 минут в зависимости от объема), после чего станет доступна кнопка image.png, после скачивания архив будет по умолчанию сохранен в папке Загрузки. Распаковывать архив не требуется, в интерфейсе 1с следует прочитать данные из файла и указать локальный путь к архиву либо после скачивания перенести архив в рабочий каталог с выгрузками.

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

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

image.png

Выгрузка на юр. лицо/физ. лицо

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

Работая со счетом по прежнему можно переключиться на счет гостя - физического лица, но в таком счете услугу нужно будет начислять вручную.

Принудительная выгрузка данных до установки статуса Выезд

По кнопке в счете гостя предусмотрена возможность произвести выгрузку специально отмеченных услуг в 1с вне зависимости от того, установлен ли статус Выезд по заявке:

image.png

Таким образом могут быть прогружены услуги для заявок под статусом Временная, Подтвержденная, Заезд.
В случае, если в счете гостя установлен принудительный флаг выгрузки в 1с и при этом услуги ранее не прогружались - следует предварительно снять этот признак для учета такого набора услуг при выгрузке.

Как исключить выгрузку безналичных платежей

Если в ECVI проводится оплата безналичным способом и такие операции при загрузке в 1С загружаются в оплаты по платежным картам, то для исключения таких операций следует в изменить настройку в Справочнике типов платежей в поле "1С ID" для данного вида оплат с 3 или 5 например на цифру 6 (безнал), в таком случае оплаты не будут выгружаться в файл.

Как добавить признак иностранной компании при выгрузке

Для правильной передачи данных по иностранному контрагенту должен быть заполнен специальный реквизит - идентификатор иностранного контрагента, доступен для заполнения в Карточке компании в разделе Реквизиты счета:

image.png

Как обрабатываются возвращенные услуги

Если в счете проводился возврат услуг, то при формировании XML файла для таких возвращенных услуг будет использоваться специальный статус ("3") для того, чтобы внешняя обработка 1с учитывала такие услуги как "корректировка реализации".

Важно! Комментарий разработчика - для того, чтобы загрузился статус "3" (корректировка реализации), нужно чтобы сначала был загружен документ со статусом "2" (реализация). Корректировка создается на основании реализации, созданной в предыдущем закрытом периоде. В остальных случаях, и так гораздо проще, нужно загружать реализацию. Старый документ предварительно надо пометить на удаление.

Банковский терминал

ECVI имеет интеграцию с  процессингом от Сбербанка (PILOT NT) и INPAS DualConnector 1.13.X

Подключение к терминалу от Сбера

Для связи банковского терминала и ECVI необходимо установить на рабочем месте драйвер терминала (папка sc552) и настроить параметры соединения с терминалом. Как правило, эти действия выполняются специалистами банка.

После того, как банковский терминал подключен к ПК и настроен драйвер (проверка связи с терминалом выполняется успешно), то далее следует обратиться в нашу службу технической поддержки support@ecvi.ru для интеграции ECVI с банковским терминалом - потребуется удаленный доступ к рабочему месту через утилиту AnyDesk, будет настроена специальная утилита обмена EdelCardModule.

Утилита должна быть всегда запущена на рабочем месте с подключенным терминалом (добавляется в Автозагрузку Windows):

image.png


При оплате с помощью типа оплаты "Кредитные карты" - оплата будет сначала передана на терминал для снятия средств с гостя:

image.png

И в случае успешного списания денежных средств оплата будет фискализирована через кассовый аппарат с печатью банковских слип-чеков.

При открытом диалоге процессинга "Используйте карту или QR код" нельзя обновлять страницу браузера, т.к. при успешной оплате оплата может быть не занесена в счет гостя! Но при этом деньги будут списаны

Интеграция с СКД (выписка ключ-карт)

На текущий момент (версия 2.5) HMA Ecvi имеет интерфейс с замковыми системами:

Если в списке нет нужной СКД, то отправьте запросу на почту службы поддержки support@ecvi.ru, укажите название отеля и название используемой системы контроля доступа.

Возможности системы

Основное преимущество автоматической стыковки системы автоматизации отеля с замковой системой заключается в том, что сотрудники службы приема и размещения имеют возможность выдать гостю ключ от номера только после того, как внесут его данные в систему. Это исключает ошибки и злоупотребления, и конечно ускоряет обслуживание, так как все действия выполняются только в одной программе - HMA Ecvi. Для того, чтобы запрограммировать ключ-карту, сотрудник отеля нажимает кнопку “ключ” в карточке заявки в Ecvi:

image.png

Появляется диалоговое окно, где можно выбрать тип ключ-карты и отметить зоны отеля, куда гость может получить доступ:

image.png

Здесь следует заметить, что гостям могут выдаваться карты двух типов: во-первых, “основная” карта от номера, которая всегда существует в единственном экземпляре. При выдаче новой основной карты предыдущая автоматически прекращает действие. Такая карта выдается при заезде в номер нового гостя. Во-вторых, могут выдаваться карты-копии, которые позволяют открывать дверь номера, например, нескольким членам одной семьи.

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

 

image.png

Так же предусмотрена возможность считывания ранее выписанных ключ-карт и очистка ("отменить карту") данных с ранее закодированного ключа.

image.png

Настройки системы

image.png

Первоначальные настройки системы, которые делаются в разделе Администрирование, помогают выполнить сотрудники службы технической поддержки по предварительному запросу на почту support@ecvi.ru

В разделе Устройства - Замки - пользователи могут так же настроить зоны доступа, которые могут быть запрограммированы в ключ-карту вместе с доступом в номер.

Особенности интеграции с замковыми системами
Интеграция с IronLogic

Для интеграции на рабочем месте с подключенным энкодером должны быть запущены две утилиты:

  1. ELocks (устанавливается специалистами поддержки ECVI), путь по умолчанию C:\EDEL\ELocks\Elocks.exe
  2. Iron Logic SDK - утилита кассового ПО, которая позволяет взаимодействовать замковой системе с внешними PMS системами. Как правило устанавливается в той же директории, где и утилита LockCommander.

Обе утилиты должны быть всегда запущены в фоновом режиме и располагаться в трее Windows (добавить в автозагрузку):

image.png

В утилите Iron Logic SDK адаптер должен быть соединен.

image.png

Мастер-ключи выписываются только через утилиту LockCommander, ECVI кодирует только гостевые ключ-карты!

iLocks

По состоянию на июнь 2024 - при выписке ключ карты с активацией доступа к какой-либо общественной зоне - выписка ключ карты не производится, так как в протоколе обмена передача сведений по общественной зоны не была регламентирована.

Bitrix24

В HMA Ecvi имеется возможность включить автоматический обмен данными с CRM Bitrix24, который позволяет оперативно передавать в Bitrix основные данные по гостям, компаниям, бронированиям. Таким образом у вас появляется возможность использовать все возможности CRM для построения коммуникаций с клиентами и всегда “иметь под рукой” данные об их заказах (бронированиях, сделанных в Ecvi). Стыковка работает в том числе с бесплатной версией CRM Bitrix24.

Ниже этот интерфейс обмена данными будет описан более подробно.

Общие сведения о стыковке

В текущей версии интерфейс обмена данными является односторонним: данные передаются из HMA Ecvi в Bitrix24, но не обратно. После первоначальной настройки и включения выполняется синхронизация данных: из Ecvi в Bitrix24 выгружаются все имеющиеся гости, компании и брони. После этого в процессе работы из Ecvi в Bitrix24 выгружаются изменения по существующим и все новые гости, компании и брони.

Обмен данными происходит с периодичностью 3-5 минут.

ECVI транслирует в Битрикс статусы бронирования как этапы сделки. Поэтому, если Вы вручную что-то поменяете в Битриксе, а затем скорректируете бронь в ECVI – измененные данные вместе со статусом снова поступят в Битрикс. Сами статусы следующие: временная бронь – подтвержденная бронь – проживание – выезд. Либо отмена брони или статус «не прибыл». По умолчанию этим статусам ставятся в соответствие стандартные этапы сделки Битрикс.

В ECVI у каждой сущности (гость, компания, бронь) используется поле – CRM_ID, id соответствующего объекта в Битрикс. Этот ID получается от Битрикс как результат операции создания сущности (гость-контакт, бронь-сделка, компания-компания). Создание происходит тогда, когда модуль стыковки выполняет анализирует данные (раз в 3-5 мин) и обнаруживает запись с пустым CRM_ID. Тогда данные отправляются в Битрикс командой создания сущности. В ответ Битрикс присылает ID. Этот ID сохраняется в поле CRM_ID. С этого момента операции создания для этого объекта из Экви уже не отправляются. Но если система обнаружит, что изменилось поле «Дата-время последнего изменения» - будет отправляться команда модификации объекта с данным CRM_ID.

При этом каждый анализ модуля стыковки начинается с анализа списка гостей и компаний. И только после этого анализируются брони. Таким образом, к моменту обнаружения новой брони гость этой брони, если он новый, уже должен быть отправлен в Битрикс и у нас в ECVI есть его ID. Cделка к брони создаётся со ссылкой на гостя/контакта с указанием его существующего CRM_ID.

Если в Битрикс производилось объединение дубликатов, то ECVI ничего не знает о том, что какие-то контакты в Битрикс были объединены и поэтому может продолжаться обмен к сделкам с неактуальными CRM_ID. 

Гости (Контакты)

Гости в HMA Ecvi при выгрузке в Bitrix24 превращаются там в Контакты. Для гостя/контакта выгружаются следующие данные:

При создании нового гостя в ECVI, информация о нём выгружается в Битрикс как команда на создание нового контакта. В ответ Битрикс присылает ID, который он присвоил этому контакту. ECVI сохраняет этот ID за профайлом конкретно этого гостя и при создании новых бронирований с этим гостем отправляет в Битрикс данные по брони и указывает ID этого гостя в Битриксе для подстановки в сделке.

Компании

Понятие компании есть и в Ecvi, и в Bitrix24, так что в этом случае всё достаточно однозначно. Для компании в CRM выгружаются следующие данные:

Заявки (Сделки)

Заявки(бронирования) Ecvi выгружаются в CRM как сделки. Поскольку, к сожалению, в стандартной версии Bitrix24 CRM у сделки отсутствуют многие привычные для гостиничного бизнеса атрибуты (даты заезда и выезда, тариф, питание и т.п.), при сопоставлении брони и сделки приходится идти на ряд допущений. В связи с этим при выгрузке заявок в Bitrix24 они превращаются в сделки по следующим правилам:

Сделке в CRM соответствует именно заявка в Ecvi, т.е. для групповой заявки, в которой забронировано 10 номеров для 20 гостей, в Bitrix24 будет создана только одна сделка (со списком всех 20 контактов-гостей).

При полном удалении заявки в Ecvi сделка в Bitrix24 также удаляется.

На скришоте ниже показан пример, как выглядит сделка в CRM, созданная из заявки Ecvi (текущий статус заявки - отменена).

image.png

Настройка интеграции

Стыковка Ecvi и CRM выполняется на основе технологии “вебхуков” Bitrix24. Для работы стыковки сначала необходимо создать такой “вебхук” в настройках CRM. Для этого в разделе CRM перейдите в раздел меню “Интеграции” - Rest API::

image.png

В появившемся окне выберите пункт “Другое”.

Система сгенерирует для вас новый вебхук, для которого в поле “Настройка прав” следует указать: CRM:

image.png

Адрес вебхука надо скопировать и самостоятельно или с помощью специалистов нашей службы техподдержки вставить в настройки стыковки с Bitrix24 в следующем разделе Экви: Администрирование - Разное - Стыковки - поле URL в свойствах стыковки с CRM Bitrix24.

Система сканирования Regula

В ECVI предусмотрена функциональность по сканированию и распознаванию данных с помощью программного обеспечения, входящего в состав сканера Regula 7027. Функция позволяет значительно упростить и ускорить оформление заезжающих гостей, так как при её использовании не надо вручную вводить данные паспорта. Обрабатываются как российские паспорта, так и паспорта иностранных граждан.

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

После прикладывания страниц документа - Regula передает набор распознанных текстовых данных в ECVI, после чего пользователю становятся доступными эти полученные распознанные данные в разделе Гости по кнопке image.png

image.png

image.png

Индикация image.png и image.png сообщает о качестве распознавания документа, получаемая от системы Regula, так, на примере выше, распознавание первой страницы с данными гостя (ФИО, кем выдан, серия/номер и т.д.) были распознаны с некоторыми неточностями, а штамп регистрации считается что распознан системой Regula без ошибок. ECVI не влияет на качество при распознавании документов.

При нажатии на кнопку image.png соответствующие в строчке данные будут применены в Карточке гостя. 

На текущий момент место рождения гостя по умолчанию добавляется в Примечание:

image.png


СБП (Система быстрых платежей)

Общее описание

Интеграция системы Ecvi с системой быстрых платежей (СБП) позволяет предлагать гостям отеля альтернативный метод безналичной оплаты услуг (помимо оплаты банковскими картами).

При его использовании гость оплачивает услуги через мобильное приложение банка на своём смартфоне, считав QR-код, который будет автоматически сформирован при начале операции оплаты в Ecvi. После оплаты гостем в приложении данные об успешной оплате достаточно быстро (в течение максимум десятков секунд) поступают в Ecvi. Таким образом, такой способ оплаты для гостя похож на оплату картой, достаточно быстрый и надежный, а отель может получить заметную экономию на размере банковской комиссии.

Обращаем ваше внимание, что для отображения гостям QR-кодов для оплаты через СБП Росбанк дополнительно требуется приобретение дисплея QR-кодов от компании Mertech: https://mertech.ru/qr-code-display/

Порядок настройки интеграции
На стороне Росбанк

Для подключения партнера к системе необходимо получить от специалиста Росбанка пару логин/пароль для доступа к Личному кабинету.

Подписка на проект

Перед началом работы с API банка Вам необходимо перейти на сайт системы по адресу:
Production: https://developer.rosbank.ru/devportal/apis
Необходимо авторизоваться, нажав на кнопку «Sign In» и ввести предоставленные сотрудником Банка логин/пароль.
После авторизации Вы увидите список доступных для Вас проектов:

image.png

Необходимо выбрать в списке или при помощи поисковой строки проект «faster-payment-system» и войти в него, нажав на карточку проекта (при поиске проекта необходимо выбирать самую актуальную версию проекта). В открывшемся окне Вы увидите данные проекта, его название и версию:

image.png

Далее переходим в раздел «Subscriptions»:

image.png

На открывшейся странице нажать кнопку «Subscribe» и в появившемся окне вести название Вашего приложения:

image.png

Ваше приложение появится в списке подписок

image.png

Нажимаем «Prod keys» и далее кнопку «Generate keys».

У данного приложения появляется связка «Customer key» и «Customer secret»

image.png

Которые в последствии необходимо вписать в соответствующие поле в ECVI. Зайдите в ECVI в Администрирование – Устройства – Кассы СБП нажмите на редактирование уже существующей кассы, либо нажмите на прямоугольник с карандашом справа наверху «Создать» и впишите «Customer key» и «Consumer-secret».

Запросы в Росбанк

image.png

Авторизация

Получение временного токена

image.png

Здесь требуется нажать GET TEST KEY

Вызов API-методов

Для дальнейшей работы с СБП Росбанк необходимо зарегистрировать кассу.
Для этого понадобится следующий метод:

image.png

Нужно указать ОГРН, idempotence-key, который генерируется в ECVI. Чтобы его сгенирировать вам необходимо в ECVI:

Зайдите в Администрирование – Устройства – кассы СБП, нажмите на прямоугольник с карандашом в правом верхнем углу «создать». В появившемся окне предварительно вы можете вписать название (потом его вы измените), номер (обязателен для заполнения, он всегда будет 1) и напротив “idempotence-key” нажмите на «Генерировать» (нажать нужно один раз и больше не трогать), скопируйте его и вставьте в соответствующее поле в ЛК Росбанка, как указано на скриншоте ниже. После этого в ECVI нажмите кнопку создать. К настройкам кассы в ECVI вернёмся чуть позже в этой инструкции. Обратите внимание на то, что больше не надо нажимать кнопку «генерировать», иначе придётся данный ключ снова прописывать в ЛК Росбанка.

image.png

image.png

Так же заполнить необходимо поля: «address», «brandName», «city», «contactPhoneNumber», «countrySubDivisionCode», «mcc», «zip». Для того, чтобы правильно заполнить нажмите на Schema, как указано на скриншоте раскроется поле в котором все данные расписаны.

image.png

Настройка в ECVI

1. Необходимо добавить во все существующие Юридические лица новые счета, с пометкой «Расчетный счет для СБП» для этого
Перейдите в Администрирование – Отель – Юридические лица


image.png

Напротив каждого Юр лица нажмите на карандаш. Обязательно проверьте чтобы было заполнено ИНН. Нажмите на «прямоугольник с карандашом» (создать) в появившемся окне создания нового счета заполните все данные и обязательно поставь галочку «Расчетный счет для СБП». Нажмите «сохранить» и «сохранить и вернуться к списку».

image.png

2. Создание типов платежей и платежей.
Перейдите в Администрирование – Разное – справочник типов платежей
Справа наверху нажмите на «прямоугольник с карандашом» (создать) в появившемся окне заполните: 
     1. Название (пример: СБП и (Юр лицо, по которому проводятся данные оплаты))
     2. 1С ID
Поставьте галочки 
     1. Платеж
     2. Возврат
     3. Быстрый платеж
     4. Проводить по кассе
     5. Включен
После этого нажмите внизу кнопку «создать».

image.png

image.png

Перейдите в Администрирование – Разное – справочник типов платежей. Справа наверху нажмите на «прямоугольник с карандашом» (создать) в появившемся окне заполните: 
     1. Наименование (пример: СБП и (Юр лицо, по которому проводятся данные оплаты))
     2. «тип платежа», тот, который вы только что создали для СБП.
     3. Поставьте галочку «Включен».
Нажмите кнопку создать.

image.png

image.png

3. Создание Кассы СБП.
Перейдите в Администрирование – устройства – Кассы СБП.
Нажмите справа наверху на «прямоугольник с карандашом»(создать).

image.png

В появившемся окне вам необходимо заполнить:
     1. Название (пример «Росбанк СБП (и указать Юр лицо)» для удобства пользования)
     2. Юр лицо
     3. Выбрать платёж, который вы создали ранее.
     4. Указать номер (всегда 1)
     5. Логин в банке
     6. Идентификатор кассы 
     7. Consumer-key
     8. Cosumer-secret
Галочка Активности ставится тех поддержкой ECVI после проверки правильности настройки всех пунктов указанных в данной инструкции, которые указываются в ECVI.

image.png

 

Порядок работы интерфейса

При использовании соответствующего типа платежа (с признаком Быстрый платеж):

image.png

По кнопке Сохранить будет генерироваться QR код с соответствующим диалоговым окном:

image.png

Гость считывает сгенерированный на экране QR код и оплачивает, при успешной оплате будет распечатан фискальный чек и оплата сохранится в счете гостя.

Памятка по заполнению данных гостя для выгрузки в систему миграционного учета ФГУП ПВС

При подготовке данных к выгрузке система Ecvi проверяет ряд обязательных условий (заполнение полей) в карточке гостя. Если данные условия не выполнены, строка с гостем в таблице (раздел ФГУП ПВС) выделяется красным цветом и выгрузка по гостю не производится. В этом случае проверьте следующее:

·         Поля Фамилия и Имя гостя (в т.ч. иностранного!) на закладке Гость в карточке клиента должны быть заполнены русскими буквами (ФИО иностранного гостя «как в паспорте» вносите в поля Фамилия и Имя на закладке Виза);

·         На закладке Гость должны быть обязательно заполнены поля:

o   Дата рождения

o   Гражданство

o   Пол

o   Документ

o   Номер

o   Выдан с

·         В случае, если гражданство гостя – Россия, также обязательно должны быть заполнены поля:

o   Код (подразделения)

o   Место рождения – страна

o   Место рождения - субъект федерации

o   Адрес – субъект федерации

o   Адрес – город (населенный пункт)

·         В случае, если заполняются данные иностранного гражданина, имеющего визу, на закладке Виза должны быть заполнены поля:

o   Тип документа

o   Серия

o   Номер

o   Рег.№

o   Категория

o   Кратность

Выгрузка данных Контур.ФМС

В системе реализована автоматическая электронная выгрузка данных по российским и иностранным гостям в Федеральную Миграционную Службу. Для передачи данных используется сервис Контур.ФМС (https://kontur.ru/fms). Для того, чтобы воспользоваться этой новой возможностью, гостинице необходимо заключить договор с компанией Контур на использование сервиса передачи данных в ФМС, а также выполнить некоторые настройки в системе Ecvi.

Настройки Ecvi для выгрузки данных по гостям

Первое, что необходимо сделать для включения выгрузки - написать в нашу службу технической поддержки ( support@ecvi.ru ) запрос на включение данной функции. После этого в разделе Администрирование - Админ - Отели в свойствах своего отеля в последней секции Иностранцы - данные принимающей стороны следует внести настройки, полученные от ФМС (на скриншоте ниже - пример из демо-версии):

image.png

Выгрузка данных

Если в настройках у отеля включена выгрузка данных, то соответствующий пункт появляется в выпадающем меню в правом верхнем углу экрана:

image.png

После его вызова программа формирует файл выгрузки и показывает ссылку на него в отдельном диалоговом окне:

image.png

Кликните мышкой на ссылку-название файла и сохраните его на своем компьютере в любой временной папке. После этого перейдите на сайт сервиса Контур.ФМС и загрузите туда данные: нажмите кнопку Принять данные из файла и укажите файл, ранее выгруженный из Экви и сохраненный на вашем компьютере:

image.png

После успешной загрузки данных вы увидите список гостей, информация по которым готова к отправке в ФМС:

image.png

Для получения описания дополнительных возможностей - редактирования списка уведомлений, печати документов и других операций в системе Контур.ФМС обратитесь к руководству по этому сервису.

Признак “выгружено в ФМС” у гостя

У гостей, информация по которым уже выгружена в ФМС, в карточке заявки появляется специальный индикатор:

image.png

Обратите внимание: у второго гостя нет этого признака, поскольку он был добавлен в заявку уже после выполнения выгрузки. Чтобы его информация тоже выгрузилась, потребуется снова вызвать функцию Выгрузка в ФМС из меню. Если по какой-то причине данные гостя надо выгрузить в ФМС повторно (например, файл выгрузки был случайно удален) - следует кликнуть на пункт меню Повторно выгрузить в ФМС (меню вызывается кликом на иконке “принтер”):

image.png

На что обратить внимание

Из Экви выгружаются данные только по проживающим гостям (то есть статус заявки должен быть установлен в Заезд). Система “запоминает”, по каким гостям информация уже была выгружена, поэтому каждый раз при вызове функции выгрузки будет формироваться файл, содержащий сведения только по новым заехавшим. В любом случае при работе с выгрузкой следует внимательно относится к проставлению статусов заявок: своевременно отмечать заезд и выезд гостей. Кроме того, по словам специалистов Контур, на текущий момент существует заметное неудобство при оформлении продления проживания гостя. В настоящее время при первой выгрузке данных по гостю в системе ФМС сразу фиксируется его дата выезда, и понятия “продление” не существует. Для корректного оформления в этом случае надо оформлять “выезд” и повторный “заезд” гостя на новые даты. К счастью, в Экви не обязательно оформлять полный выезд, можно воспользоваться функцией добавления периода проживания в ту же заявку (новый период на новые даты, но в том же номере и с тем же гостем). По заверениям Контура, ФМС планирует в будущем решить эту проблему, но пока мы считаем необходимым сообщить вам о наличии такого неудобства, требующего выполнять дополнительные действия.

Интеграция с системами аналитики

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

Бонусные баллы Контур

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

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

Активация стыковки находится в Администрирование - разное - стыковки "ППС КОНТУР".

контур 1.jpg

Активация интеграции с Контуром выполняется сотрудником технической поддержки ECVI по предварительному запросу через электронную почту support@ecvi.ru

Настройка платежей

Для работы с баллами вам необходимо создать новые "платежи" для оплаты баллами. Для этого в администрировании зайдите в Разное - справочник платежей. Нажмите справа наверху на прямоугольник с карандашом (создать).

контур 2.jpg

В появившемся окне укажите:

контур 3.jpg

1) Новое наименование платежа, например ("Бонусные баллы Контур (бонусы)"),

2) В поле "Тип платежа" выберете "Бонусы Контура",

3) Выберете тип валюты в ППС Контур, там могут быть как обычные баллы, так и рубли, и Белорусские рубли, и т.д.

4) В поле "Оплачивать баллами не более, %" впишите количество процентов, которое можно оплатить с помощью баллов в нашей системе. рассчитываются они от отрицательного сальдо в счёте гостя. По умолчанию там стоит 0%.

5) Обязательно поставьте галочку "Включен".

Нажмите кнопку "Сохранить". 

Если у вас возможна оплата не только бонусами, но и бонусными рублями, Белорусскими рублями и т.д., то повторите процедуру создания платежа с п.1 по п.5.

Проведение оплаты баллами

Для проведения оплаты баллами вам необходимо зайти в счёт гостя и начислить услуги по заявке стрелочкой направо">>" (начислить услуги по заявке).

Бонусными баллами можно оплачивать только в том случае, если сальдо по заявке будет отрицательное, в противном случае, система не даст вам возможности провести оплату баллами.

контур 4.jpg

После того, как вы начислите услуги и у вас появится отрицательное сальдо, для оплаты бонусами Контура вам необходимо нажать на кнопку "Контур", в появившемся окне необходимо указать:

контур 5.jpg

1) Введите Номер бонусной карты гостя в поле "Бонусная карта клиента"

2) Нажмите на кнопку "Запросить" (в нижнем поле появятся бонусы доступные гостю).

контур 7.jpg

После нажатия на кнопку запросить у вас появится баланс баллов гостя. Далее вам необходимо :

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

4) В поле "Доступные для списания баллы" система вычисляет количество баллов, которое возможно списать с гостя, относительно сальдо, которое начислено в счете (сальдо должно быть обязательно отрицательным!), учитывая настройки, которые вы сделали ранее.

5) В поле "Оплатить баллами" - впишите количество баллов, которое гость хочет списать со своей карты (количество списываемых баллов не может превышать количество баллов указанных в окне "Доступные для списания баллы").

6) Нажмите кнопку "Сохранить".

В окне счёта у вас появится запись о проведении оплаты баллами.

контур 8.jpg


Интеграция с ресторанной системой iiko

ECVI имеет интеграцию с ресторанной системой iiko, которая позволяет "закрывать" счета в iiko на счет гостя в ECVI.

Часть настроек выполняется специалистами технической поддержки ECVI, для этого следует отправить запрос на электронную почту support@ecvi.ru, в письме указать название отеля и причину обращения - "Подключить iiko".
В результате будет создана специальная запись в модуле Администрирование - Отель - Точки продаж с кодом по умолчанию "RS":

image.png

А так же создана системная учетная запись (логин-пароль), которые вместе с HotelID (ID отеля в системе ECVI) следует переслать специалистам по ресторанной системе. 

Со стороны iiko требуется подключение и настройка специального плагина интеграции с системой ECVI, который предоставляется и настраивается специалистами ресторанной системы с учетом полученных параметров отеля.

При работе с карточкой заявки предусмотрено специально поле "Лимит кредита":

image.png

Которое ограничивает передаваемую сумму из iiko в ECVI, при этом будет использоваться общая формулировка услуги, к примеру, "Услуги ресторана":

image.png


Перенос задолженности на счета ECVI возможно только на гостевые счета! Если в Карточке заявки подключена компания-плательщик (юридическое лицо), то в качестве номера счета для переноса следует использовать номер счета гостя-клиента.


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

Общее описание

Регистрацию гостей в отеле и подготовку документов для передачи данных в миграционную службу теперь можно сделать эффективнее и удобнее как для гостей, так и для персонала с помощью интеграции ECVI и системы обработки документов EMIS Service для дальнейшей подачи электронного уведомления о прибытии гостя в такие системы как Элпост, Контур.ФМС, ГКУ «Московская безопасность», Скала и другие.

Система обработки документов EMIS Service представляет собой приложение с web-интерфейсом. В качестве аппаратной части используются сканеры производства Regula. EMIS Service используется в большом количестве отелей по всей стране. Система EMIS Service полностью соответствует законодательству в сфере обработки персональных данных гостей отеля, имеются все необходимые документы и сертификаты.

Использование ECVI в комплекте с EMIS Service позволит:

 
Настройка интеграции

Для интеграции с системой EMIS переходим в модуль Администрирование - Отель - Юридические лица - Добавить юридическое лицо - создаем запись с юр лицом. После сохранения записи открываем в режиме редактирования созданное юридическое лицо и запоминаем ID юр лица в системе:

image.png

Специалистам EMIS следует отправить в письме отмеченный выше ID и адрес сервера (apart.ecvi.ru - hma.ecvi.ru - ...), в ответе специалист EMIS предоставит авторизационные данные для web приложения и авторизационные данные для интеграции, итого 4 поля.

Переходим в раздел Разное - Стыковки - в строке с EMIS вызываем кнопку Редактировать, вводим предоставленные параметры в полях и активируем стыковку:

image.png

Использование интеграции

Для работы интеграции используется отдельная кнопка, которая расположена в режиме редактирования профайла гостя:

image.png

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

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

Нажимая на кнопку "Сохранить" введенные (или отсканированные) данные по гостю будут сохранены и переданы в профайл гостя в ECVI.


2. Получить данные

При выборе этого диалога будет отправлена команда на запрос изменений по гостю, которыe в автоматическом режиме "подтянутся" в профайл гостя в ECVI.




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

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

Для получения учетных данных (логин, пароль, API-KEY) следует обратиться в службу технической поддержки через электронную почту support@ecvi.ru и указать название вашего отеля.

SberDevices

ECVI имеет возможность передавать сведения по заехавшим гостям для последующей обработки со стороны системы SberDevices, интеграция осуществляется путем предоставления необходимых параметров специалистам в СБЕР:

  1. Логин
  2. Пароль
  3. API-KEY
  4. Endpoint

Для запроса этих параметров следует обратиться в службу технической поддержки по адресу support@ecvi.ru

Яндекс Алиса

Возможна интеграция с колонками Яндекс Алиса в следующем формате - периодически на определенный email компании Яндекс производится отправка сведений по занятым номерам. Суть данной выгрузки – колонки должны быть своевременно сброшены после выезда гостя, чтобы новые постояльцы номера не наткнулись на историю и предпочтения предыдущего проживающего. Вот эту информацию Яндекс и вылавливает из периодически получаемой информации о занятых номерах.