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

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

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

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

Платёжная платформа PayKeeper позволяет принимать оплату по платёжным ссылкам, которые отправляются клиенту. 

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

Это упрощает процесс принятия платежей от клиентов и не требует их непосредственного присутствия у стойки.

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

Для настройки интеграции в ECVI, перейдите в разделе Администрирование -> Разное -> Стыковки -> Платёжная платформа PayKeeper, здесь потребуется заполнить следующие поля:

1) Логин (от личного кабинета PayKeeper)

2) Пароль (от личного кабинета PayKeeper)

3) URL

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

5) Шаблон сообщения - позволяет к динамическим полям с номером заявки {ReservID} и номером счета {OrderID} добавить какой-либо персональный текст с сообщением.

4) Секретное слово, копируется из личного кабинета PayKeeper в разделе Настройки -> Получение информации о платежах:

image.png

В поле "URL, на который будут отправлять POST-запросы" личного кабинета PayKeeper, следует указать одну из ссылок, в зависимости от того, где расположена система с вашим объектом размещения.

Примеры ссылок

Пользователи на сервере hma.ecvi.ru - https://hma.ecvi.ru/paykeeperapi/callback/2/0

Пользователи на сервере apart.ecvi.ru - https://apart.ecvi.ru/paykeeperapi/callback/2/0

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

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

6) Категория платежа - выбирается из списка тот вариант оплаты, который будет использоваться в случае оплаты со стороны гостя. Новая категория платежа может быть создана пользователем в разделе Администрирование -> Разное ->  Справочник типов платежей). Запись активируется по запросу в службу технической поддержки support@ecvi.ru

7) Тип платежа - выбирается доступный Тип платежа, применимый для ранее выбранной Категории. Тип добавляется в разделе Администрирование -> Разное -> Справочник платежей):

image.png

Флаг «Активность» интерфейса устанавливается по запросу пользователей по электронной почте support@ecvi.ru

Работа с PayKeeper в ECVI

После того, как вышеуказанные настройки выполнены в системе, у пользователей появляется возможность сформировать платежную ссылку в системе и отправить ссылку на оплату email (указанный в профайле главного гостя карточки) либо скопировать ссылку и направить любым другим доступным средством связи (мессенджер, СМС и т.д.).

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

image.png

Система откроет окно "Платежные ссылки PayKeeper", в котором будет выводиться информация о ранее сформированных ссылках и так же возможность сформировать новую ссылку по кнопке "Создать ссылку":

image.png

По клику по которой система откроет окно с параметрами платежной операции:

В случае, если галка "Отправить пользователю" будет снята, то платежная ссылка не будет отправлена гостю на email, но эту ссылку можно будет скопировать из списка ссылок и отправить гостю удобным способом

image.png

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

image.png

В случае успешной оплаты в ECVI на счёте отобразится платежная операция:

image.png

При каждой успешно совершенной платежной операции в системе будет выводиться уведомление о факте получения оплаты:

image.png

И в личном кабинете PayKeeper пользователь сможет отслеживать информацию о совершенных платежах с возможностью выполнения возврата:

image.png





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

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

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

Требования

Настройка плагина

Необходимо скачать плагин (плагин предоставлется службой технической поддержки по предварительному запросу через электронную почту support@ecvi.ru), разблокировать файлы и разархивировать
папку с плагином в папку с плагинами iikoFront, располагающуюся по пути  
C:\Program Files\iiko\iikoRMS\Front.Net\Plugins

Лог плагина plugin-Get.Front.Ecvi.log хранится по пути:

C:\Users\User\AppData\Roaming\iiko\CashServer\Logs.

Параметры конфигурационного файла Get.Front.Ecvi.dll.config (хранится по пути C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Get.Front.Ecvi):

"BaseUrl" - Адрес сервиса, куда направляются запросы (без слеша на конце);
"HotelToken" - токен отеля на сервере ECVI;
"EnableSearchByGuestCard" - параметр, отвечающий за возможность поиска гостя по номеру карты. При указании в поле значения "True", в меню выбора способа чекина гостя будут выведены две кнопки для поиска гостя по номеру комнаты и по номеру карты.
"IncreaseProductName" - наименование надбавки, которая отправляется в ECVI

Пример отправки в api IncreaseProductName = "Надбавка"
{
   "OrderID": "35950",
   "DepartCode": "RS",
   "InvoiceDate": "2024-10-14 15:06:56",
   "ServiceDate": "2024-10-14 15:06:56",
   "Count": "1",
   "Discount": 0,
   "Amount": 44.00,
   "Price": 44.00,
   "AmountWithoutDiscount": 44.00,
   "Comments": "1",
   "NDS": "0",
   "NdsAmount": "0",
   "Items": [
    {
       "Name": "Сахар10",
       "Amount": 1,
       "Price": 10.00,
       "DiscountPrice": 0,
       "Total": 10.00,
       "Tax": null,
       "Comment": null
    },
    {
       "Name": "Сахар15",
       "Amount": 2,
       "Price": 15.00,
       "DiscountPrice": 0,
       "Total": 30.00,
       "Tax": null,
       "Comment": null
    },
    {
       "Name": "Надбавка",
       "Amount": 1,
       "Price": 4.00,
       "DiscountPrice": 0,
       "Total": 4.00,
       "Tax": null,
       "Comment": null
    }
  ]
}

Пример:

<userSettings>
        <Get.Front.Ecvi.Properties.Settings>
            <setting name="BaseUrl" serializeAs="String">
                <value>https://demo2.ecvi.ru/iikoapi</value>
            </setting>
            <setting name="HotelToken" serializeAs="String">
                <value>k6K5Acz1Ib-vxT5j0-FaEZWwoqicyLpn</value>
            </setting>
            <setting name="EnableSearchByGuestCard" serializeAs="String">
                <value>True</value>
            </setting>
             <setting name="IncreaseProductName" serializeAs="String">
                <value>Надбавка</value>
            </setting>
        </Get.Front.Ecvi.Properties.Settings>
    </userSettings>

Создание типа оплаты ECVI

После настройки конфигурационного файла плагина необходимо запустить iikoF ront с правами администратора для регистрации плагином нового типа оплаты. После запуска iikoF ront необходимо авторизоваться в iik oOffice и создать новый тип оплаты, который будет использоваться для списания в заказах.

Настройка типа оплаты (обязательные поля выделены желтым):

image.png

Шаблон пречека

В шаблоне пречека должны присутствовать строки:
<center><split><whitespace-preserve>@Model.CommonInfo.CafeSetup.BillFooter</whitespace-preserve></split></center>
Если используется стандартный шаблон, эти строки присутствуют по умолчанию. В случае с кастомным шаблоном необходимо вручную добавить их в блок Footer, пример:

Функциональное описание

Функциональная схема реализации

image.png

Функциональное описание реализации

Плагин стартует вместе с запуском IIKOFront. При успешном старте плагина на iikoFront отобразится сообщение "Плагин успешно запущен".

Сообщение при успешном запуске плагина

image.png

В случае ошибки настроек плагина, будет выведено соответствующее уведомление.

Сообщение при неуспешном запуске плагина

image.png

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

image.png

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

image.png

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

image.png

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

image.png

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

image.png

Результат поиска гостя будет выведен кассиру в виде сообщения:

Гость не найден

image.png

Гость добавлен в заказ и у него положительный баланс

image.png

Гость добавлен, но у него отрицательный баланс

image.png

Отсутствует интернет-соединение или сервер не отвечает

image.png

Закрытие заказа в системе IIKO происходит нативными механиками работы с IIKOFront в блоке кассы.
При переходе в блок кассы заказ проверяется на наличие в нем гостя Ecvi, а далее - на доступность закрытия заказа с помощью баланса гостя. В случае, если баланс гостя позволяет полностью покрыть итоговую сумму заказа, в заказ автоматически будет добавлен платеж на полную сумму заказа с тем типом, который был зарегистрирован при настройке плагина. 

image.png

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

image.png

При закрытии заказа с типом оплаты, добавленным плагином, в сервер Ecvi будет отправлен запрос, содержащий основные данные по заказу.

Модель запроса:

{
 "OrderID": "35954", - OrderID, полученный при чекине гостя
 "DepartCode": "Демо", - Название группы, в которой зарегистрирован
терминал, из iikoOffice
 "InvoiceDate": "2024-09-12 14:15:30", - дата и время закрытия заказа
 "ServiceDate": "2024-09-12 14:15:30", - дата и время закрытия заказа
 "Count": "1", - всегда "1"
 "Discount": 0.5, - доля суммы скидки по каждому блюду в заказе к общей
сумме заказа. Если в заказе результирующей является надбавка, в поле
передается "0".
 "Amount": 12.00, - итоговая сумма заказа. Если в заказе результирующей
является надбавка, в поле передается итоговая сумма заказа.
 "Price": 12.00, - - итоговая сумма заказа. Если в заказе
результирующей является надбавка, в поле передается итоговая сумма
заказа.
 "AmountWithoutDiscount": 24.00, - сумма заказа без учета скидок. Если
в заказе результирующей является надбавка, в поле передается итоговая
сумма заказа.
 "Comments": "1", - всегда "1"
 "NDS": "0", - всегда "0"
 "NdsAmount": "0", - всегда "0"
 "Items": [
  {
     "Name": "Блюдо 1", - название блюда из iikoOffice
     "Amount": 1, - количество позиции в заказе(может быть нецелым
числом)
     "Price": 42.0000, - цена блюда из iikо Если в заказе
результирующей является надбавка, в поле передается итоговая цена за
единицу позиции с учетом надбавки.
     "DiscountPrice": 30.0000, - сумма скидки на позицию(с учетом
количества) Если в заказе результирующей является надбавка, в поле
передается "0".
     "Total": 12.00, - итоговая сумма по позиции
     "Tax": {
       "Name": "20%", - наименование налоговой ставки из iikoOffice
       "Percent": "20", - процент налоговой ставки из iikoOffice
       "Calculated": "False" - признак рассчетности
    },
     "Comment": null - комментарий к позиции
  }
]
}

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

image.png

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


Если в заказе есть гость Ecvi, при печати пречека на нем будет выведена информация о госте: номер комнаты, имя гостя и место для подписи. Печать информации о госте не зависит от баланса гостя.

image.png

Выгрузка данных в 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 - F.Doc

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

Безбумажный офис F.Doc — это сервис для подписания документов в электронном виде с клиентами компании — физическими лицами.

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

Для подключения сервиса F.Doc перейдите по ссылке.

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

Список печатных форм для подписания добавляется специалистами поддержки ECVI (по предварительному запросу на электронную почту support@ecvi.ru) в раздел «Прочее»:

image.png

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

Для интеграции с системой F.Doc в разделе «Администрирование -> Разное -> Стыковки -> Безбумажный офис FDoc» пользователю необходимо заполнить следующие поля:

image.png

Инструкции системы F.Doc представлены по ссылке - https://fdoc.ru/instructions

Флаг «Активность» интерфейса устанавливается по запросу пользователей по электронной почте support@ecvi.ru

Дополнительных пользователей F.Doc можно добавлять самостоятельно «Добавить», предварительно зарегистрировав всех сотрудников в F.Doc по ссылке https://fdoc.ru/f/register

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

В разделе «Админ -> Пользователи системы -> Редактировать», в поле «Пользователь системы F.Doc» можно указать у учетной записи соответствие пользователя F.Doc, который будет применяться при отправке документа на подписание.

image.png

Если в настройках учетной записи пользователя пользователь F.Doc не выбран (установлено значение «выбрать»), это означает, что пользователь, работающий из под такой учетной записи не имеет права отправлять на подписание документы через систему электронного документооборота.

В разделе «Разное -> Отчеты» представлен список печатных форм, доступных отелю при работе в системе, однако сама настройка возможна только с помощью специалистов технической поддержки (по предварительному запросу на электронную почту support@ecvi.ru). Поэтому для документа, который будет отправляться на подписание, потребуется задать правила подписания: указать в письме службе поддержки (support@ecvi.ru) информацию о том, какие ограничения будут применяться для такого документа и кто имеет права на подписание того или иного документа.

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

image.png

«Не выбрано» - значение по умолчанию, означает, что такой документ отправлять на электронное подписание нельзя;

«Текущий пользователь» - означает, что в качестве подписанта такого документа будет выступать пользователь F.Doc, который установлен в настройках учетной записи «Администрирование -> Админ -> Пользователи системы -> Редактировать»:

image.png

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

«Выбор вручную» - означает, что в качестве подписанта от отеля в FDoc можно выбрать любого добавленного Пользователя FDoc при условии, что в настройках учетной записи «Администрирование -> Админ -> Пользователи системы -> Редактировать» - установлено сопоставление с одним из записей Пользователей системы F.Doc.
Если в настройках учетной записи не выбрано соответствие в поле «Пользователь системы F.doc», то такой шаблон документа с настройкой «Выбор вручную» отправить на подписание от имени такого пользователя будет невозможно (нет прав).

«Конкретная учетная запись на выбор» - позволяет однозначно установить единственного подписанта печатной формы с невозможностью изменения в диалоге Отправки на подписание, однако отправлять на подписание такой документ сможет любой пользователь при наличии сопоставления в поле «Пользователь системы FDoc»!

Опция «Сохранение перед отправкой» - позволяет в обязательном порядке использовать локально сохраненный шаблон с возможными корректировками от пользователей. Т.е. если при отправке документа на подписание требуется вычитка формы со стороны пользователя, то при такой настройке у отчета выбор документа с локального диска будет обязательным:

image.png

Допустимые форматы: .pdf, .doc, .docx, .xls, .xlsx, .png, .jpg, .jpeg

Также возможно указать пользователя F.Doc для отправки уведомления о предстоящем подписании документа и подтверждения согласия на подпись:

image.png

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

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

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

В диалоге «Документы F.Doc» можно выбрать из списка на кого из гостей заявки будет направлен документ для подписания:

image.png

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

Отслеживать статус документа возможно из ECVI с помощью кнопки «Обновить»:

image.png

Маршрут подписания

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

image.png

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

Система сканирования 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 будут сохраняться отсканированные изображения в разделе Документы.

image.png

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

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

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

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

image.png

ВАЖНО! Для корректной выгрузки иностранных граждан нужно заполнить обязательные реквизиты, а именно указать адрес принимающей стороны в разделе Администрирование - Отели - свойства отеля - Иностранцы - данные принимающей стороны:

image.png

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

image.png

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

image.png

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

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

image.png

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

image.png

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

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

image.png

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

image.png

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


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

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

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

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

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

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

image.png


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

image.png

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

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

Интеграция с 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

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

image.png

1. Загрузить новые документы

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

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


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

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

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




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

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

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

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

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

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

SberDevices

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

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

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

Яндекс Алиса

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

Выгрузка данных в систему Скала (миграционный учет)

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

ECVI имеет интеграцию с системой миграционного учета "СКАЛА-ЕПГУ". Для интеграции с сервисом следует отправить запрос в службу технической поддержки на почту support@ecvi.ru и указать наименование вашего объекта размещения, а так же логин и пароль (для настройки интеграции, можно уточнить у специалистов по системе "Скала").

Порядок работы

После произведения настройки в системе появится новый раздел ФМС:

image.png

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

При переходе в который пользователю будет доступен раздел с гостями, которые выводятся в таблице по определенным условиям:
- статус заявки "Заезд" или "Выезд";
- дата заезда <= текущая дата+1 день (т.е. завтра);
- дата выезда >= текущая дата -1 день (т.е. вчера).

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

image.png

Обновления по этим сведениям будут поступать по формату PUSH из системы СКАЛА.

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

Выгрузка в систему миграционного учета ФГУП ПВС

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

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

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

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

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

o   Пол

o   Документ

o   Номер

o   Выдан с

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

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

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

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

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

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

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

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

o   Серия

o   Номер

o   Рег.№

o   Категория

o   Кратность

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

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

Интеграция системы 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 код и оплачивает, при успешной оплате будет распечатан фискальный чек и оплата сохранится в счете гостя.

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

На текущий момент (версия 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.

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

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

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

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


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

  2. Из данного кабинета написать в службу тех.поддержки сбербанка и прислать им следующий текст “Здравствуйте, просим прислать нам данные для перехода из тестового режима в рабочий  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.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 возможно только на гостевые счета! Если в Карточке заявки подключена компания-плательщик (юридическое лицо), то в качестве номера счета для переноса следует использовать номер счета гостя-клиента.