Редактирование: сканирование-карт-и-плейсхолдеры

Путь: 02_Настройка_iiko/сканирование-карт-и-плейсхолдеры.md

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

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

Инструкция описывает настройку автоматического сканирования карт, удаление префикса «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) *@` (см. скриншот в исходной инструкции — выделено красной рамкой) и заменить его на разметку ниже:

```html
   <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. Попросить клиента напечатать тестовый пречек, чтобы убедиться, что всё работает корректно.

Отмена