Настройка интеграции Shelter и CRM (Card System)
Реализуемые функции
| Действие в Shelter | Результат |
| 1. Поиск гостя через список гостей. В списке гостей провести картой | Если в Shelter гость с такой картой уже есть, то в списке появляется найденный гость. Если такого гостя нет, то происходит добавление гостя (в Shelter передаётся ФИО гостя) |
| 2. Поиск гостя при поселении/бронировании в форме поселения/брони провести картой | Поиск осуществляется аналогично, как и в списке гостей |
| 3. Передача в CRM суммы потрат | Потраты передаются на счет потрат со всех платежей, кроме тех типов оплат, где установлен чек-бокс "ПДС" |
| 4. Передача количества ночей | В CRM осуществляется передача количества ночей, проведенных гостем в гостинице (после выезда гостя) |
| 5. Передача количества визитов | В CRM осуществляется передача количества заездов гостя (после выезда гостя) |
| 6. Пополнение депозитного счета через вкладку ПДС в фолио | Происходит пополнение депозитного счета в CRM |
| 7. Списание с депозитного счета через вкладку ПДС в фолио | Происходит списание с депозитного счета в CRM |
| 8. Работа со скидками для гостей при бронировании/послении | Подтягивается скидка гостя при послении/бронировании от стойки |
Для настройки интеграции необходимо обновить Shelter до актуальной версии. Настройки необходимо выполнять через "Сервисы и оборудование" :

Рис. 1
В shelter.ini не должно быть подключенного модуля ПДС CardSystem.
Необходимо убедиться, что в ключе защиты присутствует Проект 3, модуль 6 (ПДС, CRM).
Для интеграции с CRM 5 необходимо запросить "короткий" лицензионный код для интеграции с Shelter :

Рис. 2
Для этого необходимо связаться с отделом лицензирования UCS.
При интеграции с CRM 7 короткий код указывать не нужно.
1. Необходимо перейти во вкладку "Сервисы и оборудование" - нажать кнопку "Добавить" - нажать на "Драйвер", в открывшемся окне выбрать "Персональная Дискнонтная Система (ПДС)" - "Card System" - "Выбрать" :

Рис. 3
2. Нажать кнопку "Настройка" :

Рис. 4
3. В открывшемся окне необходимо настроить следующим образом :
Лицензионный код : Указать "короткий код" (для CRM7 можно оставить это поле пустым)
Логин : Указать логин для входа в CRM
Пароль : Указать пароль для входа в CRM
Хост : Указать IP адрес ПК, где находится база данных CRM
Порт : указать порт для подключения к CRM (сервер авторизации (API) - порт TCP)
Таймаут соединения : время в мс ( можно оставить 0)
Номер терминала : 13
Тип счета : 0
Передача карты (чек-бокс) : возможность передачи дисконтной карты другому гостю
Платежи : код типа счета - депозит
Потраченные средства : код типа счета - потраты
Скидки : код типа счета - скидка
Ночи : код типа счета - ночи
Визиты : код типа счета - визиты


Рис. 6

В параметре "Код операции для платежей" указать тип оплаты, заденный ранее. "Код операции для пополнения" - указать услугу, которые мы заводили ранее (Пополнение CRM).
Чек-бокс "Разрешать ручной ввод номера карты" и "Возможность проведения операции пополнения баланса карты" - указывается по необходимости.
Настройки в CRM (пример)
1. Завести "Классификатор ПО" :
Файл - Классификаторы ПО - Добавить

Рис. 8
2. Завести "Типы счетов" :
Справочники - Типы счетов

Рис. 9
3. Настроить схемы :
Справочники - Схемы.

Рис. 10
4. Добавить типы счетов для классификатора ПО :
Классификаторы ПО (выбрать ранее созданный) - В поле "Типы счетов" ПКМ - "Настройки для работы с типами счетов" :

Рис. 11
5. Выпусть карту :
Владельцы и карты - Выпуск карт

Рис. 12
6. Создать гостя :
Владельцы и карты - Добавить нового владельца. Заполинить согласно скриншоту.

Рис. 13
7. Далее необходимо сопоставить коды скидок в CRM и Shelter. Скидки заводятся в Shelter, код скидки в Shelter = код внешний в схемах CRM

Рис. 14

Рис. 15
Операции в Shelter
1. Настроить считыватель (мануал можно посмотреть тут)
2. В карточке бронирования приложить карту к считывателю, появится окно следующего содержания :

Рис. 16
Если в БД Shelter уже заведен гость с такой фамилией, то при нажатии "ОК" откроется окно поиска гостя, где можно выбрать уже существующего гостя, таким образом мы "привяжем" гостя из CRM к гостю в Shelter.
Если нажать "Отмена", то будет создана новая карточка гостя. После сохранения карточки гостя, появляется следующее окно :

Рис. 17
Нажимаем "Да".
Если гостю положена скидка, то она отобразится в соответствующем поле при послении/бронировании.

Рис. 18
3. Пополнение карты гостя :
Перейти в фолио - Доп.операции - ПДС - Ввести номер или приложить к считывателю карту, должен подтянуться гость из CRM :

Рис. 19
Ввести сумму пополнения
Нажать "Пополнить баланс карты"
В открывшемся окне выбрать типа оплаты, нажать оплата. После оплаты баланс карты гостя увеличится на ту сумму, на которую выполнили пополнение :

Рис. 20
При этом на фолио отобразится сумма пополения карты (услуга + оплата) :

Рис. 21
Баланс счета в CRM :

Рис. 22
4. Списание с карты гостя :
Перейти в фолио - Доп.операции - ПДС - Ввести номер или приложить к считывателю карту, должен подтянуться гость из CRM
Ввести сумму списания
Нажать "Списать деньги на фолио"
После списания баланс карты гостя уменьшится на сумму списания :

Рис. 23
При этом баланс фолио станет положительный, так как мы фактически перенесли часть депозитных средств с CRM на фолио в Shelter :

Рис. 24

Рис. 25
Данную оплату можно отменить стандартныим средствами Shelter (возврат оплаты), при этом баланс фолио гостя изменится, а счет гостя в CRM пополнится на сумму той транзацкции, которую мы отменили.
5. Ночи и заезды передаются в CRM только после выезда гостя!
6. Оплата услуг с депозитного счета CRM :
Начислить услугу на фолио, при оплате этой услуги (в окне оплаты) приложить карту гостя к считывателю - тип оплаты должен измениться автоматически на "Оплата CRM":

Рис. 26
7. Передача "Потрат" выполняется автоматически, при выезде гостя. Потраты - сумма оплат гостя за предоставленные услуги в гостинице.
На примере :

Рис. 27
Общая сумму оплат - 162009 р., однако, оплаты, с помощью депозитного счета (Оплата в CRM), передаваться в CRM не будут!
Баланс счетов гостя в CRM после выезда :

Рис. 28
* В случае использования карт Em-Marine возможна удобная настройка в CRM для привязки карт, а именно:
