Назначение плагина
Плагин позволяет закрыть заказ в кассовом приложении iikoFront, начислив его стоимость на номер проживания гостя в Shelter CLOUD. Это дает возможность гостю оплатить заказ. например, из ресторана или бара, при выезде в составе общего счета за проживание.
Важное ограничение: Выгрузка работает только для номеров, наименование которых состоит из цифр (например, 220). Для номеров, содержащих буквы (например, 220А или 220Ф), функция недоступна.
Требования для интеграции
Перед установкой плагина необходимо приобрести и активировать следующие модули:
-
В iiko: Лицензия на модуль подключения внешних платежей (модуль 21016318);
-
В Shelter CLOUD: Модуль интеграции с iiko (приобретается в личном кабинете Shelter или через менеджера);
-
После выполнения пунктов 1 и 2 обратитесь в техническую поддержку Shelter для получения архива с файлами плагина интеграции.
Установка и настройка плагина
Установка плагина на кассовое приложение iikoFront
-
Найдите на компьютере/моноблоке папку, куда установлено приложение iikoFront;
-
Внутри нее откройте папку Plugins.
Пример пути: C:\Program Files\iiko\iikoRMS\Front.Net\Plugins
-
В папке Plugins создайте подпапку с именем Frontdesk24.iikoPlugin.Payment;
-
Загрузите плагин для iiko здесь: ftp://ftp.shelter.ru/Shelter/Cloud%20(Frontdesk24)/iiko/
-
Распакуйте все файлы плагина из архива.
-
Состав файлов показан на скриншоте ниже. Изменять их вручную не требуется.
- Откройте файл iikoPayment.config. Внесите между ковычками токен полученный от технической поддержки. Сохраните изменения.
Логи плагина, как правило, располагаются в папке Appdata., например «AppData\Roaming\iiko\CashServer\Logs». Они могут потребоваться при возникновении проблем в работе интеграции.
Проверка инициализации
-
Запустите приложение iikoFront;
-
Убедитесь, что в интерфейсе не появляется ошибок, связанных с плагином интеграции и модулем внешних платежей;
-
Если ошибок нет, закройте iikoFront.
Настройка типа оплаты в iikoOffice
-
Откройте офисное приложение iikoOffice;
-
Перейдите в меню Типы оплат;
-
Добавьте новый тип оплаты. Название может быть любым, например, «На номер в отеле»;
-
В поле Тип выберите Внешний тип оплаты;
-
В настройках типа оплаты выберите код интеграции, соответствующий плагину Shelter (см. скриншот).
-
Подробнее о создании типов оплат см. в руководстве пользователя iikoOffice.
Готовность к работе
-
После настройки типа оплаты снова откройте iikoFront;
-
При закрытии заказа в списке способов оплаты появится новый вариант — созданный вами тип («На номер в отеле»);
-
При его выборе система запросит номер комнаты;
-
Если номер существует и в нем заселен гость, заказ в iiko закроется, а начисление автоматически создастся в соответствующем бронировании в Shelter CLOUD.
Важно: Если комната свободна или не существует, операция будет отклонена.
Порядок работы: Закрытие заказа на номер
-
Создание заказа: В iikoFront откройте Быстрый чек, добавьте гостевые позиции и перейдите на экран Касса;
-
Выбор оплаты: В окне оплаты выберите тип оплаты, созданный для закрытия заказа на номер в отеле;
-
Ввод номера: В появившемся окне введите номер комнаты, в которой проживает гость;
-
Проверка и оплата: После успешной проверки номера убедитесь в выбранном типе оплаты и нажмите Оплатить;
-
Подтверждение: Заказ будет закрыт. Начисление появится в карточке бронирования гостя в Shelter CLOUD.
Отмена ошибочного заказа
Ключевой принцип: Отмена должна быть выполнена и в Shelter CLOUD, и в iikoFront. Порядок действий не имеет значения.
В iikoFront:
-
Перейдите на экран Закрытые заказы;
-
Найдите и откройте нужный заказ;
-
Нажмите Вернуть оплату или Удалить заказ — возврат произойдет в обоих случаях.
Важно: У пользователя должны быть соответствующие права на оформление возврата, настроенные в iikoOffice.
В Shelter CLOUD:
- Откройте бронирование гостя;
- В списке начислений найдите нужную услугу и удалите ее.