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

Данный модуль защищён ключом и является платным. Подробнее про лицензирование

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

 ПО "Абонемент"  Версия 1.135
amPDS_UDSGame.dll  Версия 1.2.0.8

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

Работа с данной ПДС в Абонемент напрямую зависит от режима работы магазина, настроенной в UDS Game.

Доступны две опции: "Начислять cashback" и "Применять скидку к счету".

 

Возможности

Начисление cashback по коду из мобильного приложения UDS Game

В интерфейсе быстрой продажи/быстрого чека перед оплатой необходимо осуществить поиск по ПДС-карте (см. рис. 1.1).
                      Рис.1.1
 
 
                                                                        Рис.1.2
 
 

Если рабочее сотрудника оборудовано сканером для считывания QR кодов, то необходимо считать QR код, который формируется в приложении UDS Game на вкладке «скидка» (см. рис. 1.3). Если сканер отсутствует, то необходимо выставить галку «ручной вод номера карты» и в появившемся поле вручную вбить шестизначный код (см. рис.1.4) и нажать «ок».

                          Рис.1.3

 

                                                                        Рис.1.4

После нажатия на кнопку «ок» из UDS Game подтягивается информация о клиенте (ФИО, текущий процент cashback, текущее количество баллов ), которую можно посмотреть по кнопке «i» в поле с номером карты (см. рис.1.5 - 1.6).

                          Рис.1.5
 
 
                                                 Рис.1.6
 
После оплаты данного чека сумма покупки будет передана в UDS Game и также будет начислен cashback согласно правилам магазина.
 
 

Начисление cashback по номеру телефона

В интерфейсе быстрой продажи/быстрого чека перед оплатой необходимо осуществить поиск по ПДС-карте (см. рис. 1.1) и выставить галку «ручной вод номера карты». В появившемся поле необходимо вбить номер телефона в международном формате (Для России – «79991112233»)(см. рис. 2.1.)

                                                                         Рис.2.1

 

Информация о клиенте в данном случае будет недоступна (см. Рис.2.2)

                                                  Рис.2.2

После оплаты данного чека сумма покупки будет передана в UDS Game и также будет начислен cashback согласно правилам магазина.

 

Оплата баллами UDS Game

Оплату баллами можно произвести только с использованием кода UDS Game. После выбора позиций в чеке необходимо на вкладке «оплата» в разделе «безналичный расчет» выбрать тип платежа «Баллами UDS Game» (см. рис.3.1).

                                                                                                    Рис.3.1

При выборе данного способа оплаты поднимается окно для ввода кода UDS Game. Доступная сумма баллов для оплаты ограничивается балансом клиента в UDS Game и также максимальным процентом для списания.

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

 

Применение скидки к чеку

В настройках магазина UDS Game должен быть выставлен способ предоставления скидки - применять скидку по счету. В ПО «Абонемент» действия пользователя аналогичны действиям, описанным в пункте 1. Начисление cashback по коду из мобильного приложения UDS Game.

После оплаты чека сумма покупки будет передана в UDS Game для увеличения суммы потрат клиента.

 

Настройка

Для корректной работы в папке exe должны быть следующие файлы: amPDS_UDSGame.dllamPDS_UdsGame.ini. (Файлы можно найти в поставке 135 версии по пути  \_INTERFACE\PDS\PDS-UdsGame)
А также необходимо настроить следующие ini файлы:
 
 
Пример amPDS_UdsGame.ini:
 
[DLL.PDS-UdsGame]
;API-ключ из кабинета магазина в UDS Game
key_api = QyhBYml-NXMjQEMxXXFOQGNtTm1PcF5KTyR1VUd6RHVHLWVVN22WY4BOMXFrVzppe1g=
DefaultDiscountCode = UDSG

 

Добавить секцию в abonementmanager.ini:

...
[PDS]
RunPDSDllName=amPDS_UdsGame.dll

 

 

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

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

 

 

Создание платежа "Баллами UDS Game"

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

 

Важно! Если магазин в UDS Game работает в режиме скидки, а не cashback, данный платёж будет отрабатывать некорректно.

 

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

Создаём новую скидку, с кодом, указанным в udsgame.ini - по умолчанию - "UDSG"
Для вышеуказанной скидки создаём содержание, величина скидки может быть установлена любая, и будет переопределена при получении информации от UDS Game.
 

Рис.6 Добавление скидки

Рис.7 Пример содержания скидки

Важно! Если в чеке будут также применены и другие скидки, информация о транзакции в UDS Game будет распознана не совсем корректно.

(Если на часть позиций скидка не распространилась, то информация будет передана только по позициям, на которые скидка распространяется)

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

 

 

 

Настройка (устаревшее)

Для корректной работы в папке exe должны быть следующие файлы: URunPDS.dll, runpds.iniudsgame.dll, udsgame.ini. (Файлы можно найти в поставке 132 версии по пути  \_INTERFACE\PDS\urunpds)
 
Пример runpds.ini:
[LOCK.SERVER]
;Параметры сервера блокировок
TCPHost=192.168.1.1
TCPPort=1119
[Main]
ClientDLL = udsgame.dll

 

Пример udsgame.ini:
[Main]
;API-ключ из кабинета магазина в UDS Game
key_api = QyhBYml-NXMjQEMxXXFOQGNtTm1PcF5KTyR1VUd6RHVHLWVVN22WY4BOMXFrVzppe1g=
;Код применяемой скидки
DefaultDiscountCode = UDSG
;Передавать id кассира, в качестве внешнего идентификатора в UDS Game (с версии Абонемент 133, udsgame.dll версии 1.0.1.55)
enableSendCasher=1

Добавить секцию в abonementmanager.ini:

...
[PDS]
RunPDSDllName=URunPDS.dll

 

Обновления

Абонемент 133

Добавлена возможность передавать кассира в UDS Game

В качестве "внешнего идентификатора" в UDS Game передаётся id пользователя, зарегистрировавшего транзакцию

(Можно посмотреть в настройках -> пользователи)