Данная статья является продолжением “Настройка Киноплан CRM”
В ней рассмотрена “поверхностная” настройка РКипер в связке с Киноплан CRM. Подробнее вы можете ознакомится на оригинальном портале документации UCS
Тестирование и написание документации осуществлялось на версии RKeeper 7.7.0.277
¶ Общие настройки
Перейдите в менеджерскую RKeeper.
¶ Параметры
Перейдите в Настройки → Параметры
- Оплата платежной картой - в поле "значение" выберите “Спрашивать”
- ПДС показывать информацию о карте или (ПДС показывать инфо о карте) - в поле "логический" установите флаг
- Бонусы - в поле "логический" установите флаг
- Механизм распределения оплат - в поле "значение" выберите “Пропорционально”
¶ Кассовый сервер
Для каждого кассового сервера необходимо добавить PDS интерфейс, который будет общаться с Farcards
Перейдите в Сервис → Станции и устройства, выберите кассовый сервер
В вкладке “Устройства' нажмите п.к.м. → Список драйверов, в списке найдите "PDS Interface” и перетащите в окно уже существующих интерфейсов у кассового сервера
Выберите добавленный интерфейс и укажите настройки:
- PDS Server Name - KP_CRM
- Look Up Card By Mail Addr - Yes, try as card code on not found
- Pass ALL Receipts XML data - Yes, always (fail if impossible)
- Authorize before transaction - Compatible
- Pass ALL Bills XML data - Yes
¶ Интерфейс
Перейдите в Сервис → Интерфейсы
¶ 1. Бонусы для посетителей и 2. Скидки для посетителей
Нажмите п.к.м. → Новый интерфейс и укажите настройки:
- Главное → Название - Киноплан CRM - Лояльность
- Главное → Статус - Активный
- Интерфейс → Вывод нефискальных платежей - передавать как оплату
- Файлы библиотек → Cтанции → Интерфейс - для всех необходимых станций привяжите, ранее созданные у кассовых серверов, PDS интерфейсы
¶ 3. Сертификаты
Нажмите п.к.м. → Новый интерфейс и укажите настройки:
- Главное → Название - Киноплан CRM - Сертификаты
- Главное → Статус - Активный
- Интерфейс → Вывод нефискальных платежей - передавать как оплату
- Файлы библиотек → Cтанции → Интерфейс - для всех необходимых станций привяжите, ранее созданные у кассовых серверов, PDS интерфейсы
¶ MCR Алгоритмы
В данном справочнике задаётся сопоставление масок карт, количества символом и отправку в определенный интерфейс
Перейдите в Сервис → Обработка сигнала устройств → MCR алгоритмы
¶ 1. Бонусы для посетителей и 2. Скидки для посетителей
MCR для работы по номеру телефона в “Новой универсальной кассе”
Нажмите п.к.м. → Новый MCR алгоритм и укажите настройки:
- Главное → Собственной имя - Киноплан - по номеру телефона (н.ук)
- Главное → Статус - Активен
- Основное → Тип алгоритма - из ниспадающего списка выберите “обработка по маске”
- Основное → Типы устройств → Клавиатура и Магнитная карта - установите флаг
- Объект → Выберите Киноплан CRM - Лояльность, из ниспадающего списка
- Основное → Область - из ниспадающего списка выберите Интерфейс
- Маска - задайте iiiiiiiiiiiiiiii (16 символов i)
Сохраните
MCR для работы по номеру телефона в “Старой универсальной кассе” или когда касса РКипер без Премьеры
Нажмите п.к.м. → Новый MCR алгоритм и укажите настройки:
- Главное → Собственной имя - Киноплан - по номеру телефона (ст.ук)
- Главное → Статус - Активен
- Основное → Тип алгоритма - из ниспадающего списка выберите “обработка по маске”
- Основное → Типы устройств → Клавиатура и Магнитная карта - установите флаг
- Объект → Выберите Киноплан CRM - Лояльность, из ниспадающего списка
- Основное → Область - из ниспадающего списка выберите Интерфейс
- Маска - задайте iiiiiiiiiii (11 символов i)
Сохраните
¶ 3. Сертификаты
Нажмите п.к.м. → Новый MCR алгоритм и укажите настройки:
- Главное → Собственной имя - Киноплан - Сертификат
- Главное → Статус - Активен
- Основное → Тип алгоритма - из ниспадающего списка выберите “обработка по маске”
- Основное → Типы устройств → Клавиатура и Магнитная карта - установите флаг
- Объект → Выберите Киноплан CRM - Сертификаты, из ниспадающего списка
- Основное → Область - из ниспадающего списка выберите Интерфейс
- Маска - задайте iiiiiiiiiiiiiiiiii (18 символов i)
Сохраните
¶ Настройки по типам использования лояльности
¶ 1. Бонусы для посетителей
¶ Типы бонусов
Перейдите в Деньги → Типы бонусов
Нажмите добавить и заполните:
Уровень 1 - 3%
- код - 103
- название - Бонус 3%
- статус - Активный
Уровень 2 - 5%
- код - 105
- название - Бонус 5%
- статус - Активный
Уровень 3 - 7%
- код - 107
- название - Бонус 7%
- статус - Активный
¶ Скидки и наценки
Перейдите в Деньги → Скидки и наценки
Нажмите п.к.м. → Новая скидка и заполните:
Свойства:
Наименование - Бонус
Интерфейс - Киноплан CRM
Код - 799. Это внешний код нулевого уровня дисконтного счёта в системе лояльности
Перейдите в Детализация
нажмите п.к.м. Новая детализация и укажите:
- Процент - 0
- Процент бонуса - 3
- Тип бонуса - выберите Бонус 3% (103), из ниспадающего списка
Сохраните
Добавьте детализацию для Бонус 5% и Бонус 7%
Сохраните
Вернитесь в свойство “скидки”, в параметре Статус выберите Активный
Сохраните
¶ Средства оплаты
Перейдите в справочник Деньги → Валюты
В блоке Платежные карты, нажмите п.к.м. и выберите Новая валюта, укажите:
- Название - Бонусы
- Статус - Активный
- Предоплаты - снимите флаг
- Не в сдаче - установите флаг
- Без сдачи - установите флаг
- Макс. процент - максимальный процент оплаты бонусным средством оплаты, если 100, то можно оплатить заказ бонусами полностью
- Возврат блюд - установите флаг
- Печатать в пречеке - установите флаг
- Как скидка - выберите 1114 Оплата как скидка, из ниспадающего списка
- Резервировать фискальную часть - Для новой уни.кассы - снимите флаг (Если флаг не будет снят, то касса Премьеры будет падать в ошибку при закрытии заказа, т.к. РК не вернёт налоги.). Для старой уни.кассы или отдельной кассы РК - установите флаг! В этом случае РК будет требовать оплатить 1, в случае 100% оплаты бонусами
- Способ ввода доп.информации - Карта или клавиатура
- Код транзакции - 0
- Не учитывать в потратах ПДС - установите флаг
- Процент бонуса - укажите 0. Процент начисления бонусов за оплату средством оплаты Бонусы
- Правило округления - 1.00
- Учитывать в отчётах - Да
- Интерфейс - Крайне важная настройка! Если интерфейс привязан, то РКипер будет осуществляться списание бонусов! Если используется связка Новая универсальная касса, то заполнять не требуется. Если используется Старая универсальная касса или Касса РКипер, то необходимо привязать интерфейс Киноплан CRM.
! Важно. В режиме новой универсальной кассы привязывать интерфейс не требуется, т.к. при оплате бонусами списание будет осуществлять Премьера. Если интерфейс будет привязан, то тогда будет двойное списание и Премьерой и РКипер
¶ Типы цен
Перейдите в справочник Меню → Типы цен
Если величина бонуса должна рассчитываться как процент от цены блюда, тогда в свойствах типа цены необходимо выставить флаг Бонус-процент.
- Бонуc-процент - установите флаг
- Бонус по-умолчанию (%) - укажите 100
Сохраните
¶ 2. Скидки для посетителей
¶ Скидки и наценки
Перейдите в Деньги → Скидки и наценки
Нажмите п.к.м. → Новая скидка и заполните:
Свойства:
Наименование - Скидка 5%
Не вручную - установите флаг
Интерфейс - Киноплан CRM
Код - 205. Это внешний код скидки в системе лояльности
Перейдите в Детализация
нажмите п.к.м. Новая детализация и укажите:
- Процент - 5
- Процент бонуса - 0
Сохраните
Вернитесь в свойство “скидки”, в параметре Статус выберите Активный
Сохраните
По аналогии добавьте Скидка 10% - код 210 и Скидка 15% - код 215
¶ 3. Сертификаты
Возможны 4 режима работы для “старой универсальной кассы или самостоятельной кассы РКипер” и 4 режима для “новой универсальной кассы”. Определитесь с типом универсальности кассы: Старая или самостоятельная/Новая, после, определитесь с режимом. Режим зависит от признака предмета расчёта для Бара/Кино и количества фискальных принтеров.
¶ Новая универсальная касса
|
Режим интеграции |
Новая универсальная касса |
|||
|---|---|---|---|---|
|
Количество фискальных принтеров |
Один фискальный принтер, на бар и билеты |
Два фискальных принтера, один на бар, второй на билеты |
||
|
Признак способа расчёта при продаже товара или услуги (билета) |
Полный расчёт | Билеты - 100% предоплата Бар - Полный расчёт |
Полный расчёт | Билеты - 100% предоплата Бар - Полный расчёт |
| Обмен сертификата на: | Товар или Билет: будет напечатан чек с средством оплаты “Предварительная оплата (аванс)” - гашение аванса |
Товар - Не поддерживается! Билет - будет напечатан чек с средством оплаты Встречное предоставление (Иное). Далее, после оказания услуги необходимо сделать гашение. |
Товар или Билет: будет напечатан чек с средством оплаты “Предварительная оплата (аванс)” - гашение аванса |
Товар - будет напечатан чек с средством оплаты “Предварительная оплата (аванс)” - гашение аванса. Билет - будет напечатан чек с средством оплаты Встречное предоставление (Иное). Далее, после оказания услуги необходимо сделать гашение. |
¶ Средства оплаты
Перейдите в справочник Деньги → Валюты
Создайте новый тип валюты “Сертификат”, укажите:
- Название - Сертификат
- Способ оплаты - Платежная карта
- Тип фискальности - Суммарно с вычитанием
! Важно! Параметр Тип фискальности отображается и доступен для редактирования только если вы авторизованы в менеджерской РКипер под дилером!
- Статус - Активный
Сохраните
Перейдите в вкладку Валюты и создайте новую валюту, укажите:
- Название - Сертификат н.ук.
- Статус - Активный
- Счет ДДС - 16 Аванс
- Статья ДДС - 4 Поступление от реализации продукции
- Учитывать в отчётах - Да
- Предоплаты - снимите флаг
- Не в сдаче - установите флаг
- Без сдачи - установите флаг
- Макс. процент - 100
- Возврат блюд - установите флаг
- Печатать в пречеке - установите флаг
- Тип фискальности - Суммарно с вычитанием. Данный параметр доступен ТОЛЬКО при авторизации, в менеджерской РКипер, под дилером
- Интерфейс - НЕ привязываем!
Сохраняем
¶ Старая универсальная касса или самостоятельная касса РКипер
¶ Блюдо “Сертификат”
Если используется “старая универсальная касса” или самостоятельная касса РКипер, то использовать механизм активации сертификата не получится! Но чтобы как-то продать и распечатать авансовый чек, то нам придётся создать “авансовое блюдо” Сертификат.
Если используется “новая универсальная карта”, то создавать блюдо не требуется!
¶
Налоговые группы
Переходим в справочник Налоговые группы, проверяем, что у нас существует налоговая группа с способом оплаты “Аванс 6003”, если отсутствует, то необходимо создать.
Нажмите п.к.м. → Новая налоговая группа, укажите:
- Название - Аванс Без НДС
- Статус - Активный
- Для аванса - установите флаг
Сохраните
Перейдите в вкладку “Налоговые политики”
В среднем блоке нажмите п.к.м. и выберите Новая налоговая политика, укажите:
- НДС - из ниспадающего списка выберите налог Без НДС
- Способ оплаты - из ниспадающего списка выберите 6003 Аванс
- Тип налогообложения - укажите корректный
- Статус - Активный
Сохраните
¶ Модификаторы
Переходим в справочник Модификаторы, создаем новую группу “Сертификат”, активируйте её
Перейдите в вкладку Модификаторы и создайте новый модификатор в этой группе, укажите:
- Название - Номер:
- Добавить к имени - установите флаг
- Ввод имени - установите флаг
- Макс. для 1 блюда - установите флаг и укажите 1
- Вес - 1
- Печатать в чеке - установите флаг
- Статус - Активный
Сохраните
¶ Схемы модификаторов
Переходим в справочник Схемы модификаторов, создаем новую схему модификаторов “Сертификат”, активируйте её
Перейдите в вкладку Группы модификаторов и создайте новый модификатор в этой схеме, укажите:
- Минимальное кол-во - установите флаг и укажите 1
- Число бесплатных - 1
- Максимальное кол-во - установите флаг и укажите 1
Сохраните
¶ Меню
Переходим в справочник Меню, создаем новую группу меню “Сертификат”, активируйте её
Создаём новые блюда Сертификат 1000 и Сертификат 3000, указываем:
- Название - Сертификат 1000
- Тип товара - 5010 Платёж
- Налоговая группа - Аванс Без НДС
- Схема модификаторов - из ниспадающего списка выберите Сертификат
- Цена - 1000
- Статус - Активный
Сохраните
¶ Настройки оплаты Сертификатом
|
Режим интеграции |
Старая универсальная касса или самостоятельная касса РКипер |
|||
|---|---|---|---|---|
|
Количество фискальных принтеров |
Один фискальный принтер, на бар и билеты |
Два фискальных принтера, один на бар - подключен к РКипер |
||
|
Признак способа расчёта при продаже товара или услуги (билета) |
Полный расчёт | Билеты - 100% предоплата Бар - Полный расчёт |
Полный расчёт | Билеты - 100% предоплата Бар - Полный расчёт |
| Обмен сертификата на: | Товар или Билет: будет напечатан чек с средством оплаты “Предварительная оплата (аванс)” - гашение аванса |
Товар - будет напечатан чек с средством оплаты “Предварительная оплата (аванс)” - гашение аванса. Билет - не поддерживается! |
Товар или Билет: будет напечатан чек с средством оплаты “Предварительная оплата (аванс)” - гашение аванса |
Товар - будет напечатан чек с средством оплаты “Предварительная оплата (аванс)” - гашение аванса. Билет - будет напечатан чек с средством оплаты Встречное предоставление (Иное). Далее, после оказания услуги необходимо сделать гашение. |
| Режим работы: |
Режим 1 |
Режим 2 |
Режим 3 |
Режим 4 |
¶ Режим 1 и 3:
¶ Скидки и наценки
Перейдите в Деньги → Скидки и наценки
Нажмите п.к.м. → Новая скидка и заполните:
Свойства:
Наименование - Сертификат 1000
Интерфейс - Киноплан CRM - Сертификаты
Код - 300
Перейдите в Детализация
нажмите п.к.м. Новая детализация и укажите:
- Процент - 0
- Процент бонуса - 0
Сохраните
Вернитесь в свойство “скидки”, в параметре Статус выберите Активный
Сохраните
Создайте, по аналогии, Сертификат 3000 с внешним кодом 301
¶ Средства оплаты
Запускаем менеджерскую РКипер и авторизовываемся под дилером!
Перейдите в справочник Деньги → Валюты
Создайте новый тип валюты “Сертификат”, укажите:
- Название - Сертификат
- Способ оплаты - Платежная карта
- Тип фискальности - Фискальный чек
! Важно! Параметр Тип фискальности отображается и доступен для редактирования только если вы авторизованы в менеджерской РКипер под дилером!
- Статус - Активный
Сохраните
Перейдите в вкладку Валюты и создайте новую валюту, укажите:
- Название - Сертификат ст.ук.
- Статус - Активный
- Счет ДДС - 16 Аванс
- Статья ДДС - 4 Поступление от реализации продукции
- Учитывать в отчётах - Да
- Предоплаты - снимите флаг
- Не в сдаче - установите флаг
- Без сдачи - установите флаг
- Макс. процент - 100
- Возврат блюд - установите флаг
- Печатать в пречеке - установите флаг
- Тип фискальности - Фискальный чек. Данный параметр доступен ТОЛЬКО при авторизации, в менеджерской РКипер, под дилером
- Интерфейс - из ниспадающего списка выберите "Киноплан CRM - Сертификат"
- Код транзакции - 0
- Фискальные типы - в данной настройке необходимо указать номер регистра средства оплаты, в ФР, который равен средству оплаты “Предварительная оплата (аванс)”
В примере указан 14, этот регистр равен средству оплаты “Предварительная оплата (аванс)”, для ФР Штрих
Сохраняем
¶ Режим 2:
Этот режим отличается от 1 или 3 только тем, что нам потребуется запретить оплачивать билеты сертификатом
¶ Скидки и наценки
Перейдите в Деньги → Скидки и наценки
Нажмите п.к.м. → Новая скидка и заполните:
Свойства:
Наименование - Сертификат 1000
Интерфейс - Киноплан CRM - Сертификаты
Код - 300
Перейдите в Детализация
нажмите п.к.м. Новая детализация и укажите:
- Процент - 0
- Процент бонуса - 0
Сохраните
Вернитесь в свойство “скидки”, в параметре Статус выберите Активный
Сохраните
Создайте, по аналогии, Сертификат 3000 с внешним кодом 301
¶ Классификация блюд
Перейдите в справочник Меню → Классификация блюд
Создайте новую классификацию “Сертификат”, укажите:
- Название - Сертификат
- Статус - Активный
Сохраните
Нажмите п.к.м по классификации “Сертификат” и выберите Новая категория, укажите:
- Наименование - Бар
- Статус - Активный
Сохраните
Перейдите в вкладку Блюда и перенесите сюда ВСЕ блюда, что относятся к категории БАРА, т.е. все, кроме блюда “Билет”
¶ Средства оплаты
Перейдите в справочник Деньги → Валюты
Создайте новый тип валюты “Сертификат”, укажите:
- Название - Сертификат
- Способ оплаты - Платежная карта
- Тип фискальности - Фискальный чек
! Важно! Параметр Тип фискальности отображается и доступен для редактирования только если вы авторизованы в менеджерской РКипер под дилером!
- Статус - Активный
Сохраните
Перейдите в вкладку Валюты и создайте новую валюту, укажите:
- Название - Сертификат - БАР (ст.ук)
- Статус - Активный
- Счет ДДС - 16 Аванс
- Статья ДДС - 4 Поступление от реализации продукции
- Учитывать в отчётах - Да
- Классификация - выберите классификацию Сертификат → Бар
- Предоплаты - снимите флаг
- Не в сдаче - установите флаг
- Без сдачи - установите флаг
- Макс. процент - 100
- Возврат блюд - установите флаг
- Печатать в пречеке - установите флаг
- Тип фискальности - Фискальный чек. Данный параметр доступен ТОЛЬКО при авторизации, в менеджерской РКипер, под дилером
- Интерфейс - из ниспадающего списка выберите "Киноплан CRM - Сертификат"
- Код транзакции - 0
- Фискальные типы - в данной настройке необходимо указать номер регистра средства оплаты, в ФР, который равен средству оплаты “Предварительная оплата (аванс)”
В примере указан 14, этот регистр равен средству оплаты “Предварительная оплата (аванс)”, для ФР Штрих
Сохраняем
¶ Режим 4:
¶ Скидки и наценки
Перейдите в Деньги → Скидки и наценки
Нажмите п.к.м. → Новая скидка и заполните:
Свойства:
Наименование - Сертификат 1000
Интерфейс - Киноплан CRM - Сертификаты
Код - 300
Перейдите в Детализация
нажмите п.к.м. Новая детализация и укажите:
- Процент - 0
- Процент бонуса - 0
Сохраните
Вернитесь в свойство “скидки”, в параметре Статус выберите Активный
Сохраните
Создайте, по аналогии, Сертификат 3000 с внешним кодом 301
¶ Средства оплаты
Перейдите в справочник Деньги → Валюты
Создайте новый тип валюты “Сертификат”, укажите:
- Название - Сертификат
- Способ оплаты - Платежная карта
- Тип фискальности - Фискальный чек
! Важно! Параметр Тип фискальности отображается и доступен для редактирования только если вы авторизованы в менеджерской РКипер под дилером!
- Статус - Активный
Сохраните
Перейдите в вкладку Валюты и создайте первую новую валюту, укажите:
- Название - Сертификат - БАР (ст.ук)
- Статус - Активный
- Счет ДДС - 16 Аванс
- Статья ДДС - 4 Поступление от реализации продукции
- Учитывать в отчётах - Да
- Предоплаты - снимите флаг
- Не в сдаче - установите флаг
- Без сдачи - установите флаг
- Макс. процент - 100
- Возврат блюд - установите флаг
- Печатать в пречеке - установите флаг
- Тип фискальности - Фискальный чек. Данный параметр доступен ТОЛЬКО при авторизации, в менеджерской РКипер, под дилером
- Интерфейс - из ниспадающего списка выберите "Киноплан CRM - Сертификат"
- Код транзакции - 0
- Фискальные типы - в данной настройке необходимо указать номер регистра средства оплаты, в ФР, который равен средству оплаты “Предварительная оплата (аванс)”
В примере указан 14, этот регистр равен средству оплаты “Предварительная оплата (аванс)”, для ФР Штрих
Сохраняем
¶ FarCards
Для подключения кассы к системе лояльности будет использоваться шлюз FarCards, его может скачать дилер UCS, с официального ресурса (ftp://ftpint.ucs.ru/R-Keeper.CRM/versions/FС_604.zip).
К Farcards необходимо подключить библиотеку для связи с Киноплан CRM
¶ Настройка
- Скачайте и распакуйте дистрибутив FarCards,
- Cкачайте библиотеку DSI_Kinoplan и конфиг их распакуйте в корневой каталог FC
¶ Откройте, через блокнот, файл FARCARDS.INI
В блоке [FarServer]
- DLL - укажите dsi_Kinoplan.dll
В блоке [pds_netk]
- NetServerName - укажите KP_CRM
Сохраните
¶ Откройте, через блокнот, файл netk.ini
- port - укажите 2243 или любой другой свободный
Сохраните
¶ Откройте, через блокнот, файл dsi_Kinoplan.json
- token - ваш токен
- checkPIN: mode - укажите payBonus
- codePayBonus - укажите код средства оплаты, при оплате которым требуется проверять ПИН-код(смс)
- additionalCodePayBonuses - если средств оплаты, для которых требуется запрашиваеть ПИН-код(смс), больше чем одно и оно уже указано в параметре codePayBonus, то перечислите, в этом параметре, все необходимые коды средств оплаты. Разделитель ","(запятая)
Сохраните
¶
Пример конфига с описанием параметров
{
"log": {
"cntFiles": 4,
"logLevel": 100,
"maxSizeMB": 4
},
"processingURL": "https://crm-api.kinoplan.io", "comment_processingURL": "Адрес подключения к Kinoplan CRM",
"token": "0bda9414-6d78-4b64-99b0-2cb0a5a64324", "comment_token": "Ключ доступа, генерируется в настройках ЛК KP CRM",
"farcards": {
"transactionKind": {
"pay": 0, "comment_pay": "Платежный бонусный",
"discount": 1, "comment_discount": "Скидочный",
"reward": 2, "comment_reward": "Вознаграждение бонусный (кешбек)",
"cost": 3, "comment_cost": "Траты клиента"
},
"checkPIN": {
"mode": "payBonus", "comment_mode": "режим проверки ПИН кода: disable - не проверяется, payBonus - проверяется только если есть оплата бонусами, always - всегда проверяется, при оплате бонусами и при авторизации карты",
"codePayBonus": 5, "comment_codePayBonus": "Код средства оплаты БОНУСЫ (имеет смысл указывать для режима payBonus)"
"additionalCodePayBonuses": [124,120,121], "comment_additionalCodePayBonuses": "необязательный дополнительный массив с кодами средств оплаты, которые также (вместе с codePayBonus) считаются БОНУСАМИ (имеет смысл указывать для режима payBonus)"
}
}
}
Запустите Farcards с ключом /install. Он установится в виде службы windows, после, запустите установленную службу.