Сканирование карт и плейсхолдеры печати

Инструкция описывает настройку автоматического сканирования карт, удаление префикса «RM», а также плейсхолдеры для печати данных гостя на чеке и пречеке (API v2) и шаблон пречека.

Автоматическое сканирование карт

1. В конфигурации плагина включить параметр «Использовать автоматическое сканирование карт».
2. В настройках приложения «API Системы лояльности Remarked» выставить параметр «Метод сканирования» в значение «Префикс».
3. В настройках серии карт в поле «Содержимое баркода» (по умолчанию трек карты) дописать префикс RM для карт.

Удаление префикса «RM» в мобильном приложении

Клиент может обратиться с запросом убрать префикс «RM» с карты в мобильном приложении.

1. Перейти в настройки серии карт гостя.
2. Найти поле «Содержимое баркода (по умолчанию трек карты)».
3. Заменить его на:

   RM#CARD_NUMBER#

После внесения изменений кассу перезагружать не нужно.

Плейсхолдеры для печати на чеке / пречеке (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} — Бонусы к списанию

Шаблон пречека (если перестала печататься информация о госте)

Если в пречеке перестала печататься информация о госте, проверьте шаблон чека в iikoOffice.

1. В iikoOffice перейти в раздел «Администрирование» → «Шаблоны чеков».

2. Найти шаблон с проставленной галочкой «Основной» и открыть его.

3. В открывшемся окне найти «Разметку шаблона».

4. Найти блок между @* Footer (begin) *@ и @* Footer (end) *@ (см. скриншот в исходной инструкции — выделено красной рамкой) и заменить его на разметку ниже:

   <np />
   @if (Model.AdditionalServiceChequeInfo == null)
   {
   <whitespace-preserve>@Raw(string.Join(Environment.NewLine, Model.Extensions.BeforeFooter))</whitespace-preserve>
   }
   <center><split><whitespace-preserve>@Model.CommonInfo.CafeSetup.BillFooter</whitespace-preserve></split></center>
   <np />
   <np />
   @if (Model.AdditionalServiceChequeInfo == null)
   {
   <whitespace-preserve>@Raw(string.Join(Environment.NewLine, Model.Extensions.AfterFooter))</whitespace-preserve>
   }
   <np />

5. Сохранить изменения: сначала кнопку «Сохранить», затем кнопку «Сохранить изменения».

6. Попросить клиента напечатать тестовый пречек, чтобы убедиться, что всё работает корректно.