📚 RM.Loyalty.docs
➕ Новая статья

настройка farcards и telegram

✏️ Редактировать

Настройка FarCards и отключение от бота Telegram

Инструкция описывает настройку модуля взаимодействия FarCards (DLL) между r-keeper и ReMarked, агента мониторинга, а также принудительное отключение пользователя от Telegram-бота.

Назначение модуля FarCards

Модуль remarked_farcards предназначен для интеграции кассы r-keeper с внешней CRM ReMarked посредством FarCards.

Скачать последнюю версию:

https://drive.google.com/drive/folders/1SnopVZWAQO5BUGhQq3glyimQ7knCy9zB

Поставка и установка. Модуль поставляется в zip-архиве. Для установки распакуйте архив с FarCards в любую пустую папку. Для запуска запустите файл Farcards.exe с ключом /desktop.

Настройки в r-keeper

Подключение к FarCards

  1. Перейти в «Сервис → Кассовые станции и устройства», выбрать кассовый сервер.
  2. Во вкладке «Устройства» нажать ПКМ → «Список драйверов». Найти «PDS interface» и перетащить его в список устройств сервера.
  3. Выбрать созданный интерфейс, в поле «PDS Server Name» ввести строку remarked_farcards. Чтобы работало создание пре-транзакции при печати пречека, в поле «Pass ALL Bils XML data» установить значение Yes.
  4. Перейти в «Сервис → Интерфейсы», создать новый интерфейс (ПКМ → «Новый интерфейс»). В группе «Файлы библиотек (DLL)» найти нужный кассовый сервер и выбрать созданный интерфейс.

MCR алгоритм

  1. Перейти в «Сервис → Обработка сигналов устройств → MCR алгоритмы», создать новый MCR алгоритм.
  2. Настроить «Тип алгоритма» в зависимости от используемых карт — чаще всего «Префикс». Если используется другой тип (например, «Маска») — уточнить у заведения.
  3. Если используется «Префикс» — обязательно использовать префикс RM.
  4. В «Типы устройств» выбрать необходимые типы устройств, с которых обрабатываются карты гостей.
  5. В параметре «Объект» выбрать созданный ранее интерфейс.

Скидки

  1. Создать скидку «Авторизация карты» с детализацией: процент 0; в свойствах скидки в группе «Ограничения» проставить галочки «На заказ» и «Не вручную».
  2. Создать скидку «Скидка remarked» с детализацией 100%. В ограничениях поставить галочку только в пункте «На блюдо», снять «На заказ» (если включено), отключить «Не вручную».
  3. Создать скидку «Подарок remarked», настроить так же, как «Скидка remarked».

Композиции скидок

Перейти в «Деньги → Композиции скидок»:

  1. Создать композицию: свойство «Операция» = «Суммировать»; «Скидка 1» и «Скидка 2» — «Авторизация карты» и «Скидка remarked».
  2. Создать ещё одну композицию: «Операция» = «Суммировать»; «Скидка 1» и «Скидка 2» — «Авторизация карты» и «Подарок remarked».

Валюты

  1. Перейти в «Деньги → Валюты», в группе «Платёжные карты» создать копию оплаты «ПДС оплата».
  2. В свойствах созданной оплаты указать «Автозаполнение» = «Без автозаполнения», в «Интерфейс» — созданный интерфейс.

Важно — «Тип фискальности». Параметр влияет на отражение валюты в ККТ и налоговой:

  • «Фискальный чек» — как валюта, увеличивая выручку и налоговую базу;
  • «Фискальная скидка» — как скидка, не увеличивая выручку.

Роли

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

Настройка файла remarked.ini (FarCards)

Открыть файл remarked.ini. В группе COMMON настроить значения:

[COMMON]
base_url = https://app.remarked.ru/api/v1/api   ; адрес API ReMarked
api_auth_key = <ключ доступа к API ReMarked>
timeout = <таймаут запросов к API>
log_level = <уровень логирования от 1 до 10>
deferred_transaction_interval = <интервал проверки отложенных транзакций, сек>
auth_phone_numb = 0   ; авторизация по номеру телефона (0 — нет, 1 — да)
auth_card_numb = 1    ; авторизация по номеру карты (0 — нет, 1 — да)

Внимание. Одно из полей auth_phone_numb или auth_card_numb должно быть включено обязательно. Можно включить оба — тогда при длине передаваемого номера карты 11 символов FarCards выполняет авторизацию по номеру телефона.

В группе DISCOUNTS настроить коды скидок (находятся в свойствах скидки):

[DISCOUNTS]
for_order = <код скидки «Авторизация карты»>
for_dish = <код скидки «Скидка remarked»>
for_gift = <код скидки «Подарок remarked»>

После внесения изменений в файл (remarked.ini / farcard_linkos.ini) требуется перезапустить FarCards, если он был запущен.

Настройка агента мониторинга

Агент мониторит состояние подключения FarCards к r-keeper через XML-интерфейс кассового сервера.

Скачать последнюю версию:

https://drive.google.com/drive/folders/1EdXRHjlcwhizNDvTI1Eh-OiLfOgHcNOn

Подключение к r-keeper

  1. В браузере перейти на хост агента (по умолчанию порт 11201, например http://127.0.0.1:11201/).
  2. В параметрах подключения к кассовому серверу указать адрес и порт сервера, логин — имя работника, созданного для модуля, и пароль его менеджерской станции.

Подключение к серверу мониторинга

В разделе «Настройка API» заполнить:

  • ключ доступа к серверу мониторинга (из поля «Ключ доступа к серверу», сгенерированного при создании агента);
  • ссылку на сервер мониторинга:
    http://fcmonitor.remarked.ru:11200/api/v1/

Настройки FarCards в агенте

В группе «Настройки farcards» заполнить:

  • Имя службы — имя службы, которой установлен FarCards (агент работает только со службой; нужно именно имя службы, а не отображаемое имя — смотреть в свойствах службы);
  • GUID интерфейса в r-keeper для FarCards — GUID логического интерфейса (Менеджерская → «Сервис → Интерфейсы» → выбрать интерфейс → поле GUID);
  • Номер тестовой карты — любая карта для проверки подключения к серверу (проверка идёт через запрос GetCardInfo);
  • Имя ini-файла, связанного с DLL — имя файла в папке FarCards (скорее всего remarked.ini).

Не забыть сохранить настройки.

Принудительное отключение от бота Telegram

Чтобы принудительно отключить пользователя от Telegram-бота, удалите запись по нику пользователя в соответствующей таблице БД (см. скриншот в исходной инструкции).