Артюшкин Всеволод 28 мая, 2019 - 16:39 Последняя редакция: 7 ноября, 2019 - 13:43 Автор редакции: Артюшкин Всеволод

 

 

 

 

Интеграция ПО «Абонемент» с ПДС ISD 

Версии используемого ПО

 ПО "Абонемент"  Версия 1.138
 amPDS_FC.dll  Версия 1.10.0.5

 

Взаимодействие систем происходит через посредника - утилиту FarCards.

Со стороны ПДС ISD, к FarCards подключается библиотека интеграции специалистами ISD.

Со стороны Абонемент, к FarCards подключаются рабочие места по протоколу RTCP (должен быть настроен в FarCards).

 

Версии ПДС ISD, FarCards и библиотеки интеграции известны специалистам ISD, настраивающим интеграцию.

 

Реализуемые функции

Действие в Абонемент

 Результат

 1. В списке гостей проводим карточкой ПДС ISD. Поиск гостя.

Если гость в Абонемент с таким PIN не найден, то происходит добавление гостя. Передается ФИО и текущий код скидки.

Если гость с таким PIN есть, то открывается карточка гостя.

 2. В быстрой продаже нажали на кнопку «ПДС карта»

Произошел запрос в ПДС ISD, отображены данные о ПДС карте: ФИО, сумма доступных к списанию жетонов, полученный код скидки, к заказу автоматически применилась скидка.

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

 3. Передача потрат

Потраты передаются на счет потрат со всех платежей, кроме "Списание с ПДС". Флаг «Бонусы накапливаются во внешней ПДС» значения не имеет.

 4. Оплата со счета жетонов ПДС ISD 

Оплата любых услуг жетонами ПДС ISD. .
 5. Передача суммы скидки

При оплате любой услуги любым типом платежа, при установленном параметре "Карта ПДС", будет передана сумма скидки применённой к позициям чека.

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

 

Конфигурация

С версии Абонемент 137 поставка необходимого для интеграции находится по пути FullVersionVer137\_INTERFACE\PDS\PDS-FC\ 

В поставку входят amPDS_FC.dll и amPDS_FC.ini

Также для отображения данных из ПДС в формате приведённом в статье, необходимо добавить PDS_auto_ISD.frf и PDS_auto_ISD.ini из архива приложенного к данной статье в папку exe/frf.

Для подключения к Абонемент, необходимо скопировать данные файлы в папку exe, а также в abonementmanager.ini заполнить секцию [PDS] следующим образом:

[PDS]
RunPDSDllName=amPDS_FC.dll

QuickSale_PdsCardInfo_Report=PDS_auto_ISD

Далее необходимо заполнить amPDS_FC.ini следующим образом:

[DLL.PDS-FC]
; Тип настроек интеграции (не изменять)
 ProtocolType=2 
 ; Адрес и порт на котором доступен FarCards по протоколу RTCP, настроенный на ПДС ISD
  Host = 192.168.56.105:2025

 ; ID Кассы, для значения 2 в ПДС ISD будет отображаться как 'RC2'
 UnitID = 2

 ; Передавать содержимое чека (0 - не передавать, 1 - передавать, если возможно)
 IsSendCheck=1

 ; Передавать номер оригинального чека для чеков возврата (для корректного сторнирования в ПДС)
 IsFindRootInvoiceForReturn=1

 ; Указатель, что суммы передаются в копейках
 MoneyDivisor=100

 ; Правила трансляции операций (не изменять!)
[DLL.PDS-FC.TranslateKind]
 0=-1
-0=1
 1=2
-1=5
 2=7
-2=-7
 3=8
-3=-8

 ; Правила трансляции счетов (не изменять!)
[DLL.PDS-FC.TranslateSum]
RESTSUM=0
DISCOUNTSUM=4
BONUSSUM=3
SPENTSUM=2

Передача содержимого чека из Абонемент в ПДС ISD

С версий amPDS_FC.dll 1.10.0.5 и Абонемент 1.138 доступна передача содержимого чека в ПДС ISD. Пример отображения содержимого чека, в отчёте ПДС ISD можно увидеть на рис.1

Рис.1 Отображение содержимого чека в отчёте ПДС ISD

В силу того что в протоколе FarCards все "Коды" являются строго целочисленными полями, необходимо и в Абонемент привести поле "Код" к целочисленному виду, иначе чеки не будут отправлены в в FarCrads, для предотвращения внутренних ошибок ПДС.

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

[TranslateCodes.Code]
; Код услуги/абонемента/платежа аналогично коду блюда RK7
@12=12100
USL14=14000
VISA=999
MCARD=998

[TranslateCodes.CategCode]
; Код группы услуг/абонементов аналогично коду категории меню RK7
ONL=775
БАР=777
ЗАЛ=776

Таким образом, даже при не целочисленном коде в Абонемент чек будет успешно передан, с подменой кода согласно настройке.

Если абонемент не принадлежит ни в одной группе, чек также не будет передан. 

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

 

Настройка ПО "Абонемент"

После проверки и настройки файлов, запускаем  ПО «Абонемент».
 
Прежде всего устанавливаем флаг, указывающий, что бонусы у нас будут накапливаться во внешней ПДС. 
 
Настройки - > Общие параметры -> Двойной клик на названии объекта -> Закладка “Скидки”
 
 
Рис. 2 Установка флага
 
 

Создание платежа "Списывать с PDS"

«Настройки-->Услуги и платежи-->Платежи -->Безналичный расчет»
 
Добавляем новую карточку платежа и указываем типа платежа «Списывать с ПДС». Пример – на рисунке 3:
 
 
Рис. 3 Пример настройки новой карточки платежа 
 

Создание скидки “Скидка PDS”

Создаём новую группу скидок. Например, с кодом PDS и наименованием “Скидка PDS”.
Для вышеуказанной группы создаём состав. 
 
ВНИМАНИЕ!  Необходимо ПРАВИЛЬНО указать КОД.  (коды скидок необходимо использовать те же, что заведены в ПДС ISD)
 
Для созданного состава указываем содержание скидки. Для примера выбираем услугу “Бар” и определяем для неё скидку в 10%. 
 
 
Рис.3  Добавление группы скидок, её состав и содержание
 
 

Работа в ПО "Абонемент" (в связке с ПДС ISD)

Рассмотрим поэтапно несколько случаев использования карты ПДС ISD.
Клиент заведён в ПДС ISD, но его нет в Абонементе.
Заходим в “Быструю продажу” и делаем поиск:
 
 

Рис.4 Поиск клиента по карте
 
 
ПО «Абонемент» не отобразил данные, поэтому заходим в “Список клиентов” и добавляем клиента (и переходим к ситуации, когда есть клиент и в ПО "Абонемент", и в ПДС ISD): 
 
 
Рис.5 Добавление информации по клиенту из ПДС ISD 
 
 
Клиента в ПО «Абонемент» мы добавили, теперь проверяем и определяем, какая скидка ему положена согласно ПДС ISD. Для этого возвращаемся в “Быструю продажу” и нажимаем на “Поиск по карте” и получаем №ФОЛИО, №Клиента, ФИО. После этого нажимаем на кнопку "i"  и получаем данные полученные от ПДС ISD по карте, с помощью которой был создан клиент.
 
  
 
Рис.6. Кнопка информации по ПДС карте и окно информации
 
Клиента в Абонемент можно и не создавать. Достаточно в быстрой продаже используя кнопку троеточие в графе ПДС-карта, считать карту. В таком случае, вся необходимая информация в ПДС будет передана, но гость будет создан без привязки к данной ПДС-карте.
 
После этого добавляем услугу (обратите внимание, за пример взята услуга, на которую была заведена скидка – см. рис.4). Затем Вы можете выбрать разные способы оплат, в том числе и списание жетонов со счёта ПДС ISD.
 
 
Рис.7 Оплата услуг
 
 
 
Как Выглядят транзакции переданные из Абонемент в отчёте по движению карты ПДС ISD можно посмотреть на рис.8.

Рис.8 Отчёт ПДС ISD по движению карты

 

ВложениеРазмер
Печатная форма информации по карте3.05 КБ