Инструкция по настройке интеграции
Ознакомьтесь также с Инструкция по проведению оплат в R-keeper 7 по UDS.
Возможности интеграции:
Проведение стандартных операций UDS (списание и накопление бонусов).
При списании бонусов UDS в пречеке отображается “Итого к оплате” с учетом бонусов, бонусы применяются как скидка.
Шаг 1. Для настройки скидок откройте справочник «Скидки и наценки» (Деньги->Скидки и наценки). И создайте группу скидок, например с названием «UDS»
Шаг 2. В группе скидок «UDS» создайте скидку UDS_DISCOUNT со следующими свойствами:
Добавьте для нее детализацию:
Шаг 3. Точно так же добавьте в группу «UDS» скидку UDS_BONUSES с детализацией.
После этого в обеих скидках поменяйте статус на «АКТИВНЫЙ».
Шаг 4. Скрипты UDS_MCR и UDS_CASH_CONTROL необходимо скачать с InformAPI.ru
Cкрипт для MCR алгоритма, который позволяет регистрировать данные гостя (код, сертификат, номер телефона) и, в зависимости от настроек системы лояльности UDS, рассчитывать скидки и допустимые к списанию бонусные баллы.
Настройте скачанные скрипты в соответствии с данными вашего предприятия.
В окне редактирования каждого скрипта найдите раздел:
//==== ПАРАМЕТРЫ ДЛЯ РАБОТЫ СКРИПТА
В этом разделе указаны настройки, которые необходимо настроить для вашего предприятия, основные это API_Key и Company_ID .
//Параметры регистрации заведения, берутся из настроек в личном кабинете UDS
API_Key :=''; // API ключ из личного кабинета UDS (Наcтройки->Интеграция)
Company_ID :=''; // ID компании из личного кабинета UDS (Наcтройки->Интеграция)
По умолчанию, скидки даются на все категории без исключения, но вы можете их настроить под свое предприятие.
Внимание! Номера категорий в обоих скриптах должны быть одинаковыми. Иначе это может повлиять на начисление бонусов по заказу.
// параметры для расчета скидок
Categ_Num_In := 0; // Код категории в которую входят товары на которые действуют операции с бонусами UDS / если 0 - фильтр по категории отключен
Categ_Num_Out := 0; // Код категории в которую входят товары, исключенные из операций с бонусами UDS / если 0 - фильтр по категории отключен
Шаг 5. Откройте справочник «MCR алгоритмы» (Сервис->Обработка сигналов устройств-> MCR алгоритмы). В открывшемся окне правой клавишей откройте окно действий и выберите «Новый MCR алгоритм».
Шаг 6. Для нового MCR алгоритма заполните свойства:
- Собственное имя: UDS_МCR
- Статус: Активный
- Тип алгоритма: Скрипт вер. 7.0
- Типы устройств: Клавиатура (обязательно), Штрих-код (если планируете работу со сканером
- Область: Скидка
Шаг 7. Откройте свойство «Скрипт» и удалите в нем все строки, кроме первой, как показано ниже:
Вставьте, начиная со второй строки содержимое скрипта UDS_MCR с сайта InformAPI.ru с данными ID компании и API Key
Шаг 8. Нажмите кнопку ОК. Сохраните настройки. Если будут ошибки, или при нажатии на OK окно не закроется, нажмите ОТМЕНА и повторите действия по настройке.
По умолчанию в системе R_Keeper установлено время таймаута на срабатывание MCR алгоритма 10 секунд. То есть, если за это время алгоритм не отработает, он прекращает обработку, поэтому необходимо изменить это значение.
Шаг 9. Для редактирования времени срабатывания MCR алгоритма откройте справочник «Параметры» (Настройки->Параметры). Выберите раздел «Параметры работы станции», подраздел «Времена», параметр «Таймаут выполнения MCR алгоритма» . Установите значение в секундах, которое подходит вашему предприятию. Например, 60. Это значение применится ко всем MCR- алгоритмам, которые работают в вашем предприятии. Если необходима более тонкая настройка, используйте работу с исключениями. (см. Руководство пользователя R_Keeper)
Шаг 10. Cкрипт типа «Контроль кассовых операций», который при закрытии чека регистрирует в UDS рассчитанные ранее скидки и бонусы к списанию. Откройте справочник «MCR алгоритмы» (Сервис -> Скрипты). Выберите раздел «Контроль кассовых операций». В открывшемся окне правой клавишей откройте окно действий и выберите «Новый скрипт».
Шаг 11. Для нового скрипта заполните свойства:
- Название: UDS_CASH_CONTROL
- Статус: Активный
Шаг 12. Установите скрипт для алгоритма: Откройте свойство «SomeScrip» и вставьте со второй строки содержимое скачанного UDS_CASH_CONTROL с сайта InformAPI.ru с данными ID компании и API Key
Шаг 13. Нажмите кнопку ОК. Сохраните настройки. Если будут ошибки, или при нажатии на OK окно не закроется, нажмите ОТМЕНА и повторите действия по настройке.
Шаг 14. Включите скрипт в схему форм: Откройте справочник Схемы форм (Настройки-> Графический интерфейс-> Схемы форм)
Шаг 15. Скопируйте предустановленную схему форм. Установите имя, например «Схема для кассовых операций» и переведите статус в «Активный».
Шаг 16. Добавьте на закладке «Ссылки на скрипты» с помощью правой клавишей мыши ссылку на скрипт UDS_CASH_CONTROL.
Откройте параметры использования схем форм.
Добавьте созданную схему форм в использование.
Шаг 17. Откройте справочник «Расширенные свойства» (Настройки-> Настройка-> Расширенные свойства). И выберите группу «Свойства для заказов».
Шаг 18. Добавьте свойства UDS_CODE и UDS_TRANSACTION с параметрами, показанными ниже:
1. Версия операционной системы: не ниже Windows 10
2. Версия программы r_keeper: не ниже 7.7.0.390
3. Настройка осуществляется от пользователя с ПОЛНЫМИ правами (доступ Дилера).
Если версия R-keeper не соответствует указанным, то необходимо произвести обновление, обратившись к специалистам R-keeper, сопровождающих компанию
У пользователей ( кассиры, официанты и т.п.) для работы с UDS должны быть права “Скидка” и “Редактирование суммы скидки”
тел.: 8(4912) 90-42-42
e-mail: inform062@mail.ru, help904242@mail.ru
Оплата производится разработчику интеграции по расчетному счету по реквизитам:
Индивидуальный предприниматель Жукова Валентина Петровна
Юр. адрес 390035 г. Рязань, ул. Березовая, д.1, корп.1, кв.42
ИНН 623412452811
ОГРНИП 310623434300010
Р/счет 40802810702530000414
АО «АЛЬФА-БАНК» г. Москва
К/счет 30101810200000000593
БИК 044525593
Стоимость модуля интеграции для оплаты бонусами UDS:
Наименование | Разовый | За 12 месяцев |
Основная поставка - один объект, до | 5000 р | |
Установка и настройка основного | 5000 р. | |
Установка и настройка модулей | По ценам дилера | |
Предоставление инструкции по | Бесплатно |