Редактирование: настройка-farcards-и-telegram

Путь: 03_Настройка_r-keeper/настройка-farcards-и-telegram.md

Содержимое (Markdown)

# Настройка 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` настроить значения:

```ini
[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` настроить коды скидок (находятся в свойствах скидки):

```ini
[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-бота, удалите запись по нику пользователя в соответствующей таблице БД (см. скриншот в исходной инструкции).

Отмена