Структурная схема

Описание

Shelter настроен на первую базу данных и отвечает за автоматизацию гостиничного сектора. Абонемент настроен также на отдельную базу данных и отвечает за автоматизацию СПА сектора заведения. Две базы одновременно возможно использовать на одном физическом сервере под управлением одной СУБД FireBird.

Схема обслуживания клиента

Гость первоначально заселяется в Shelter, и ему автоматически создается фолио поселения. В случае, если гость не планирует использовать СПА услуги, то система Абонемент о нем ничего не узнает.  

Если гость заселен по тарифу с услугами СПА комплекса, то необходимо на карточке гостя (бумажный носитель) отметить эту информацию. Затем гость проходит на ресепшен СПА, где гостя должны повторно зарегистрировать - уже в Абонемент - вручную, и добавить гостю предопределенный абонемент с нулевой стоимостью на срок проживания гостя. В следующих версиях появится интерфейс  для автоматической регистрации гостя при заселении  в Shelter по тарифу для СПА. В Абонемент будет переноситься информация по анкетным данным гостя и создаваться абонемент на посещение. Так же будет автоматически проверяться, не выехал ли ещё гость, для своевременной деактивации абонемента на посещение СПА. Для такой ситуации, отдельная касса для Абонемента не нужна, но желательно подключить ролловый чековый принтер.

Если гость не планирует посещать гостиницу и оплачивать свои услуги там, то все данные о нём будут храниться в ПО Абонемент (со своей отдельной кассой). 

Механизм работы

1. Регистрируем клиента в гостинице и создаем его фолио поселения в программе Shelter (рис.1).
2. Клиент приходит в Фитнес и регистрируется в Абонемент. При оплате услуг выбираем специальный тип платежа - Закрытие на номер (рис.2).
3. В поле номер карты вводим номер комнаты в котором проживает гость (рис.3), затем необходимо выбрать одного из проживающих в номере - (рис.4).
4. После успешной транзакции в программе Shelter появится дополнительная услуга и эта сумма будет отображаться как "неоплаченные услуги" (рис.5).
5. В программе Абонемент услуги стали оплачены специальным платежем (рис.6).

Рис.1 - Создание фолио в Шетлер (поселение гостя)

Рис.2 Выбор типа оплаты

Рис.3 Выбор номера\фолио - Вводим номер комнаты/Прикладываем карту (в случае, если требуется использовать ключ от номера (идентификатор в Shelter) для закрытия из Абонемента) - Для выбора фолио, нужно перед номером поставить точку "." или букву F ("F" или "f").

Рис.4 Выбор гостя из проживающих в номере.

Рис.5 Фолио гостя в Гостинице после закрытия на номер.

Рис.6 Фолио гостя в Абонементе после закрытия на номер.

Настойки

1. Устанавливаем сервер блокировок версии 2.3 вместо 2.1 (переводим работающие программы на него). Инструкция по настройке LockServer.
2. Устанавливаем connecter (из базовой поставки FullVersion).
3. Заводим в абонементе новый тип оплаты (см.рис.5)

Рис.7 Создание вида платежа

4. abonentmanager.ini

[HotelInterface] 
UseConnecter=1
; Ссылка на connecter
UrlConnecter=http://127.0.0.1:7780
; Идентификатор транзакции. По умолчанию = -1. Если TransactionID меньше нуля, то передаются ID (идентификатор) типа оплаты.
TransactionID=5
useutf=1

TransactionID в данном случае - это та же переменная, возможные значения которой указаны слева от знака равно в секции [TranslateOperation] ShelterConnect.ini - справа от знака равно там указан соответствующий тип операции в Shelter (бар, ресторан, тд). TransactionID это ID, а не КОД типа оплаты (в данном случае - Закрытия на номер). Если соответствие не задано, возникает ошибка SCRK6/5.3: Error 208. Unsubstituted client operation 77 (тут 77 - айди типа оплаты).

5. Connecter.ini

Параметры секции [charset] вкупе с useutf=1 выше отвечают за настройки кодировки и могут меняться - подробнее об этом - в конце статьи. Для подключения к интерфейсу Фиделио нужно использовать PMS_Ifc.dll (настройка производится по аналогии с настройкой интеграции Fidelio и R-Keeper, более подробно см. статью "Интеграция RK6 с гостиничной системой "Opera" ("Fidelio")": http://support.ucs.ru/ru/node/4469).

[LOCK.SERVER]
Project = 4
Module = 3
[HotelInterface] 
; Использовать dll гостиничных интерфейсов в connecter'е 
enabled=1 
; Путь к dll гостиничного интерфейса (должна быть в каталоге запуска connecter.exe) 
HotelInterFaceDllname=D:\_UCS\Connecter\SCRK6530.dll 
[charset] 
encoding=UTF-8 
dbencoding=windows-1251 
UseUrlEncode=0

6. ShelterConnect.ini

Внимание! При изменении ini файлов shelterconnect, необходим перезапуск обеих утилит (АМ и Connecter).

Для работы требуется libiconv2.dll - можно найти в папке LIB базовой поставки FullVersion

[SCRK6]
 UseDetails = 0
 UseSuperDetails = 1
 RoomInfoMode = 3
[ExternalClient]
 ClientID      = 1
 IdentPhysType = 200
 ConvertOperationNeed = 1
 ToOEM = 1
 NeverRestrictTransaction = 1
 FolioMask = $04
 ShowBalance = 1
 ShowBalanceFirst = 1
[Database]
;путь до базы
  dbname = 127.0.0.1/3080:D:\_UCS\IBDATA\SHELTER.FDB
[TranslateOperation]
   909 = 301

В секции [TranslateOperation] необходимо задать строку XX=YYY где XX это код (id) типа оплаты "Закрытие на номер", который задаётся внутри программы (рис.7 в инструкции). В случае, если Вы хотите передавать именно его, нужно выставить в abonementmanager.ini TransactionID=-1. Иначе, нужно выставить любую цифру от нуля до 90, не_соответствующую другим типам оплаты, и в ShelterConnect.ini выставить соответствие ей. 

Использование идентификатора гостя из Shelter

[ExternalClient]
  IdentPhysType = 200

Настройка кодировки

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

connecter.ini :

[charset]
encoding=UTF-8
dbencoding=windows-1251
UseUrlEncode=0

Для данных целей всегда должно быть UseUrlEncode=0

ShelterConnect.ini:

[ExternalClient]
  ToOEM = 1

abonementmanager.ini:

[HotelInterface]
useutf=1

Встречающиеся ошибки и их решения