Редактирование: плейсхолдеры-и-выгрузка-меню

Путь: 09_Справочник_API/плейсхолдеры-и-выгрузка-меню.md

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

# Плейсхолдеры печати и выгрузка меню

## 1. Плейсхолдеры для печати на чеке / пречеке (API v2)

Плейсхолдеры подставляются в макет чека или пречека и заменяются данными гостя и заказа во время печати.

```
{$guest.surname}                  — Фамилия
{$guest.name}                     — Имя
{$guest.patronymic}               — Отчество
{$guest.fio}                      — ФИО
{$guest.card_number}              — Номер карты
{$guest.categories}               — Категории гостя (через запятую)
{$order.sum}                      — Сумма заказа
{$order.bonus_limit}              — Лимит оплаты бонусами
{$order.sum-$order.bonus_limit}   — Сколько платить при макс. списании
{$bonuses_balance.before}         — Баланс до
{$bonuses_balance.after}          — Баланс после
{$bonuses_balance.refill_sum}     — Бонусы к начислению
{$bonuses_balance.withdrawal_sum} — Бонусы к списанию
```

> Для печати данных о карте в пречеке R-Keeper в макете пречека должен присутствовать бэнд субсчёта; без него информация о карте не печатается. Версия стенда должна быть 1.2.6 и выше.

## 2. Модуль выгрузки меню (R-Keeper)

Модуль `remarked_menu_dump.exe` передаёт меню из R-Keeper в CRM ReMarked: выполняет первоначальную выгрузку всего доступного меню кассового сервера, затем периодически выгружает меню и стоп-листы при изменении справочников. Синхронизированное меню поступает в Loyalty API через методы группы **LoyaltyData** (`category/update`, `nomenclature/update`, `remaining-amounts/change`).

### Поставка

- ПО поставляется в ZIP-архиве; установка — распаковка в любую папку на диске.
- Не оставляйте номер версии в имени папки (помешает обновлению).
- Рекомендуется устанавливать на той же машине, где расположен кассовый сервер (мид).

### Настройка XML-интерфейса R-Keeper

XML-интерфейс даёт доступ к информации R-Keeper 7. Для работы на чтение лицензировать его не нужно.

**HTTP XML-интерфейс кассового сервера:**
1. `Сервис → Станции и устройства` → выбрать кассовый сервер → вкладка «Свойства».
2. Группа «HTTP ограничения» — проставить значения для всех пунктов (можно стандартную привилегию, например «HTTP Access»).
3. Группа «HTTP Server» → параметр `HTTP Data Port` — свободный порт на машине кассового сервера. Параметр `Use Free Listen Port` рекомендуется отключить.
4. Сохранить и перезапустить кассовый сервер.

**Пользователь для HTTP XML-интерфейса:**
1. `Персонал → Работники` → роль `XML-Editing` (именно её) → дать привилегию на объект «HTTP Access» в «Менеджерских ограничениях».
2. Создать пользователя с именем строго из ЛАТИНСКИХ букв (регистр важен), задать пароль (цифры и латинские буквы).
3. Выдать роли полные кассовые права.
4. Имя и пароль пользователя потребуются при настройке модуля.

**Проверка:** в браузере `https://127.0.0.1:8026/webgui/iservxmltest.htm` (адрес и порт кассового сервера). При корректной настройке браузер запросит логин/пароль и откроет страницу проверки с готовым XML-запросом.

### Настройка модуля синхронизации

1. Запустить `remarked_menu_dump.exe` в режиме `/desktop` — сгенерируется файл настроек `settings.yaml`.
2. Закрыть программу, открыть `settings.yaml` (в папке запуска) и заполнить параметры:
   - IP-адрес кассового сервера;
   - порт HTTP XML-интерфейса;
   - имя пользователя и пароль для XML-интерфейса;
   - идентификатор классификации R-Keeper для выгрузки категорий и блюд (по умолчанию `2560`);
   - уровень логирования от 3 до 10 (10 — максимальный, для первого запуска);
   - срок хранения логов (рекомендуется 7);
   - код станции, стола и категорий (для корректной стоимости блюд, важно для сетей);
   - **раздел «настройки api»** (данные от CRM ReMarked): токен API, URL API CRM ReMarked, таймаут ответа сервера (по умолчанию 10 сек), интервал повторной синхронизации в минутах (рекомендуется 10).
     - *Токен и URL API получаются от CRM ReMarked; в документацию не выносятся (доступы — раздел 18 внутренней БЗ).*
3. Сохранить файл, запустить `remarked_menu_dump.exe`, проверить выгрузку.

### Bat-файлы для запуска

| Файл | Действие |
|---|---|
| `desktop.bat` | Запуск в режиме `/desktop` |
| `install.bat` | Установка службы |
| `uninstall.bat` | Удаление службы |

Отмена