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

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-файлы для запуска