Различия
Показаны различия между двумя версиями страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
external:smspds:main [2021/02/10 09:30] – shurigin | external:smspds:main [2021/09/26 14:41] (текущий) – удалено Александр Ильин | ||
---|---|---|---|
Строка 1: | Строка 1: | ||
- | ====== SMS PDS - двухфакторная СМС авторизация карт персональной дисконтной системы ====== | ||
- | |||
- | ---- | ||
- | |||
- | **Описание: | ||
- | С версии PDSSMS.exe v1.0.2.99 появилась возможность авторизации карты по номеру телефона БЕЗ использования СМС кода. | ||
- | |||
- | **Стоимость: | ||
- | Лицензируется подключение к базе CardServ.\\ | ||
- | При использовании технологии SynCard лицензируется подключение либо к Head (требуется 1 лицензия), | ||
- | |||
- | *Отправка СМС тарифицируется дополнительно [[https:// | ||
- | |||
- | **Скидки** для дилеров UCS и сетевых объектов. | ||
- | |||
- | **Скачать: | ||
- | [[http:// | ||
- | [[https:// | ||
- | [[https:// | ||
- | |||
- | ---- | ||
- | |||
- | // | ||
- | |||
- | * // | ||
- | * // | ||
- | * // | ||
- | * // | ||
- | // | ||
- | |||
- | * PDSSMS.exe - Модуль, | ||
- | * Скрипт PDS_Activate - Скрипт на встроенном языке r-keeper для активации карты | ||
- | * Скрипт PDS_Authorize - Скрипт для запуска авторизации карты в заказе | ||
- | * MCR Алгоритм - Для распознавания кода авторизации и добавления карты в заказ | ||
- | |||
- | ---- | ||
- | |||
- | **Описание механизма работы** | ||
- | |||
- | **Активация НОВОЙ карты на кассе** | ||
- | |||
- | **Внимание!** | ||
- | |||
- | * Через групповые операции создать диапазон новых карт с конкретными номерами, | ||
- | |||
- | После нажатия на функциональную клавишу в главном меню RK7, запустится скрипт, | ||
- | |||
- | **Авторизация карты (применение карты в заказ)** | ||
- | |||
- | После нажатия на функциональную клавишу в открытом заказе, | ||
- | |||
- | В зависимости от настроек ПДС в кипере гость получит скидку/ | ||
- | |||
- | ---- | ||
- | |||
- | ===== Установка и конфигурация ===== | ||
- | |||
- | ==== PDSSMS ==== | ||
- | |||
- | Поставляется в виде архивированной сборки всех необходимых для работы файлов: | ||
- | |||
- | * cardimp.exe - Модуль для активации карты в системе ПДС | ||
- | * cardimp.ini - Файл конфигурации модуля CardImp | ||
- | * CscLink.dll - Библиотека для соединения с CARDSERV | ||
- | * CscLink.ini - Файл конфигурации CscLink | ||
- | * RTCP.dll - Библиотека сетевого протокола для связи с CARDSERV | ||
- | * *sms.dll* - Библиотека, | ||
- | * *sms.ini* - Файл конфигурации sms.dll | ||
- | * PDSSMS.exe - Исполняемый файл главного модуля | ||
- | * config.ini - Файл конфигурации главного модуля | ||
- | * LicSystem.dll - Библиотека системы лицензирования | ||
- | * Server.bin - Служебный файл. | ||
- | |||
- | * **sms.dll** | ||
- | Интеграция с другими SMS провайдерами возможна, | ||
- | |||
- | === CscLink.ini и cardimp.ini === | ||
- | |||
- | В двух этих файлах необходимо задать значения одних и тех же параметров: | ||
- | |||
- | Пример структуры файла с комментариями: | ||
- | |||
- | [Settings] \\ CSLinkDLL = RTcp ; | ||
- | |||
- | [RTcp] \\ Server1=127.0.0.1 ;IP адрес компьютера, | ||
- | |||
- | После настройки CscLink.dll и cardimp.exe можно перейти к конфигурации PDSSMS | ||
- | |||
- | === config.ini === | ||
- | |||
- | Содержит в себе конфигурационные параметры для модуля PDSSMS.exe | ||
- | < | ||
- | |||
- | [SERVER] | ||
- | ; | ||
- | LocalPort=11000 | ||
- | ;Имя файла библиотеки для отправки смс (может отличаться в зависимости от провайдера) | ||
- | SmsDll=sms_smsc.dll | ||
- | |||
- | [PDS] | ||
- | ;имя пользователя для подключения к CARDSERV. Должен иметь доступ к редактированию счетов в Pcards! | ||
- | ; | ||
- | User=ucs | ||
- | ; | ||
- | Pass=ucs | ||
- | ;время жизни невостребованного ПИН кода в минутах | ||
- | PinLifeTime=10 | ||
- | ; | ||
- | ; | ||
- | ;Текст может быть как до " | ||
- | ; | ||
- | |||
- | Message=Ваш код авторизации: | ||
- | |||
- | [LOG] | ||
- | ; | ||
- | LogLevel=1 | ||
- | ;Срок хранения .log файлов в днях | ||
- | OldLogs=7 | ||
- | |||
- | </ | ||
- | |||
- | **Пример значения параметра Message** | ||
- | |||
- | < | ||
- | **Значение параметра** | ||
- | |||
- | Message=Ресторан " | ||
- | |||
- | **Сообщение для гостя** | ||
- | |||
- | Ресторан " | ||
- | Ваш код авторизации: | ||
- | Хорошего дня! | ||
- | |||
- | </ | ||
- | |||
- | **Помните, | ||
- | |||
- | Помимо конфигурации выше описанных модулей, | ||
- | |||
- | ---- | ||
- | |||
- | ==== Лицензирование ==== | ||
- | |||
- | Модуль SMSPDS распространяется на условиях LifeTime лицензии с использованием системы лицензирования ГК " | ||
- | |||
- | **ВАЖНО!** \\ Дальнейшее **продление лицензии** | ||
- | |||
- | ---- | ||
- | |||
- | ==== Настройки RK7 ==== | ||
- | |||
- | Установка модуля SMSPDS подразумевает, | ||
- | |||
- | Исходя из этого настройка RK7 для работы с SMSPDS сводится к добавлению двух скриптов и одного MCR алгоритма. | ||
- | |||
- | === Скрипт PDS_Activate === | ||
- | |||
- | - В менеджерской станции перейти в меню " | ||
- | - В группе скриптов " | ||
- | - Добавить содержимое скрипта: | ||
- | < | ||
- | |||
- | var | ||
- | card_num: String; | ||
- | fio, fio2 : String; | ||
- | date : String; | ||
- | tel: String; | ||
- | flag, i: Integer; | ||
- | res: String; | ||
- | addr: | ||
- | begin | ||
- | flag:=0; | ||
- | addr := ' | ||
- | card_num := gui.InputBox(' | ||
- | fio := gui.InputBox(' | ||
- | date := gui.InputBox(' | ||
- | |||
- | while flag = 0 do | ||
- | begin | ||
- | tel := gui.InputBox(' | ||
- | if Length(tel) <> 11 then | ||
- | gui.ShowMessage(' | ||
- | flag:=1; | ||
- | end; | ||
- | |||
- | flag := gui.MessageDlgEx(' | ||
- | ' | ||
- | if flag = 6 then // это " | ||
- | begin | ||
- | fio2 := ''; | ||
- | for i := 1 to Length(fio) do | ||
- | begin | ||
- | fio2 := fio2 + IntToStr(Ord(fio[i]))+' | ||
- | end; | ||
- | if HttpGet(' | ||
- | begin | ||
- | if pos('<? | ||
- | gui.showmessage(res) | ||
- | else if pos(' | ||
- | gui.showmessage(' | ||
- | else | ||
- | GUI.ShowMessage(' | ||
- | end; | ||
- | end; | ||
- | end; | ||
- | |||
- | </ | ||
- | |||
- | После создания скрипта нужно отредактировать значение переменной addr, заданное в начале скрипта. \\ Необходимо ввести IP адрес и listen порт модуля PDSSMS.exe через двоеточие. | ||
- | |||
- | === Скрипт PDS_Authorize === | ||
- | |||
- | Повторить действия 1-3 из PDS_Activate, | ||
- | |||
- | Содержимое скрипта: | ||
- | |||
- | < | ||
- | var | ||
- | card: String; | ||
- | tel : String; | ||
- | pin0: String; | ||
- | pin1: String; | ||
- | flag: Integer; | ||
- | addr: string; | ||
- | begin | ||
- | addr: | ||
- | flag:=0; | ||
- | while flag = 0 do | ||
- | begin | ||
- | tel := gui.InputBox(' | ||
- | if tel = '' | ||
- | flag := 2; | ||
- | if Length(tel) <> 11 then | ||
- | gui.ShowMessage(' | ||
- | else | ||
- | flag:=1; | ||
- | end; | ||
- | |||
- | if Flag = 2 then | ||
- | Exit; | ||
- | |||
- | if HttpGet(' | ||
- | begin | ||
- | if pos('<? | ||
- | GUI.ShowMessage(pin0) | ||
- | else if pos(' | ||
- | | ||
- | else | ||
- | | ||
- | end | ||
- | else | ||
- | GUI.ShowMessage(' | ||
- | |||
- | if Parameter = 1 then | ||
- | begin | ||
- | pin1 := gui.InputBox(' | ||
- | | ||
- | end; | ||
- | end; | ||
- | |||
- | </ | ||
- | |||
- | **ВНИМАНИЕ!** | ||
- | |||
- | Не в быстром чеке - тоже проверьте эти параметры, | ||
- | |||
- | {{: | ||
- | |||
- | === MCR Алгоритм === | ||
- | |||
- | - Перейти в справочник " | ||
- | - Создать копию MCR Алгоритма, | ||
- | - Переименовать его содержательно (например " | ||
- | - Выставить тип алгоритма " | ||
- | - Поставить галки типов устройств " | ||
- | |||
- | Содержимое скрипта: | ||
- | |||
- | < | ||
- | var | ||
- | | ||
- | | ||
- | begin | ||
- | if Length(Parameter) <> 4 then | ||
- | begin | ||
- | Result: | ||
- | end | ||
- | else | ||
- | begin | ||
- | url: | ||
- | res: | ||
- | httpget(url, | ||
- | if pos('<? | ||
- | begin | ||
- | | ||
- | | ||
- | end | ||
- | else if Length(res)> | ||
- | begin | ||
- | | ||
- | | ||
- | end; | ||
- | end; | ||
- | end; | ||
- | |||
- | </ | ||
- | |||
- | В строке, | ||
- | |||
- | === Настройка СМС сообщений === | ||
- | |||
- | В стандартной поставке программного обеспечения используется интеграция с СМС провайдером [[https:// | ||
- | Для работы системы необходимо зарегистрировать у провайдера личный кабинет. После подтверждения номера телефона, | ||
- | |||
- | После того, как Вы зарегистрировали личный кабинет у провайдера, | ||
- | |||
- | 1. Запустите исполняемый файл IniCrypt_Project.exe, | ||
- | |||
- | {{: | ||
- | |||
- | 2. В поле " | ||
- | |||
- | {{: | ||
- | |||
- | 3. Вставьте логин и пароль Вашего личного кабинета в соответствующие поля, затем нажмите кнопку " | ||
- | |||
- | {{: | ||
- | |||
- | 4. Закройте программу IniCrypt_Project.exe | ||
- | |||
- | **С версии PDSSMS.exe v1.0.2.99 появилась возможность авторизации карты по номеру телефона БЕЗ использования СМС кода** | ||
- | |||
- | Для использования такого функционала необходимо: | ||
- | |||
- | - Перейти в справочник " | ||
- | - Создать копию MCR Алгоритма, | ||
- | - Переименовать его содержательно (например " | ||
- | - Выставить тип алгоритма " | ||
- | - Поставить галки типов устройств " | ||
- | - Вставить в скрипт алгоритма следующий код: | ||
- | < | ||
- | |||
- | var | ||
- | | ||
- | | ||
- | begin | ||
- | if Length(Parameter) <> 11 then // | ||
- | begin | ||
- | Result: | ||
- | end | ||
- | else | ||
- | begin | ||
- | url: | ||
- | res: | ||
- | httpget(url, | ||
- | if pos('<? | ||
- | begin | ||
- | | ||
- | | ||
- | end | ||
- | else if Length(res)> | ||
- | begin | ||
- | | ||
- | | ||
- | end; | ||
- | end; | ||
- | end; | ||
- | |||
- | </ | ||
- | |||
- | Аналогично с предыдущим MCR алгоритмом, | ||
- | |||
- | **ЗЫ При использовании такого механизма, | ||
- | |||
- | === Использование скриптов === | ||
- | |||
- | Для активации скриптов необходимо назначить их на функциональные клавиши и добавить на экранные формы кассы. | ||
- | |||
- | В справочнике " | ||
- | |||
- | В справочнике " | ||
- | |||
- | Перейти в справочник " | ||
- | |||
- | Сделать копию селектора главное меню, добавить в него клавишу " | ||
- | |||
- | Сделать копию селектора операций для **быстрого чека**, добавить в него клавишу " | ||
- | |||
- | Сделать копию селектора операций для чека ресторана, | ||
- | |||
- | Добавить графическое отображение созданных клавиш в макеты скопированных селекторов, | ||
- | |||
- | ---- | ||
- | |||
- | ===== Запуск ===== | ||
- | |||
- | PDSSMS.exe является desktop приложением и не требует специальных ключей для запуска. В случае возникновения ошибок во время запуска необходимо в файле config.ini установить значение LogLevel=5 и добиться повторения ошибки. В этом случае в папке Log директории приложения можно будет найти файл с подробным описанием возникшей ошибки. | ||
- | |||