Обновление плагина для iiko v.3.х.х

Данные обновления рекомендуются всем клиентам на iiko.

Раздел помеченный значком ⚠️ предназначен к выполнению только профильным специалистом.

Актуальную версию плагина можно скачать на странице инструкции по настройке плагина

3.4.5

Фикс багов

Пофиксили мелкие баги.
Добавили возможность для предоплаты бонусами выбрать счет (основной или дополнительный)

3.4.3.2

Запрет ручного ввода номера карты и телефона

Добавили в настройки плагина возможность запрета ручного ввода номера карты и номера телефона.

Обновление плагина:
· Остановите iikoFront.
· Замените файлами из архива файлы в каталоге C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\MCRM
· Измените настройки плагина в файле конфигурации MCRM_Plugin_Config.xml , он находится в папке
C:\Users\<Имя_пользователя>\AppData\Roaming\iiko\CashServer\PluginConfigs\MCRM
· Запустите iikoFront.

Параметры в конфиге:
· HideSearchGuestByPhoneNumber - убирает ручной ввод номера телефона.
· HideSearchGuestByCardNumber - убирает ручной ввод номера карты.
· HideSearchGuestByQrCode - убирает ручной ввод QR-кода.

Настройка ручного ввода номера карты и телефона в iikoWaiter

Для того чтобы сотрудники могли вручную вводить номер карты или телефона гостя в iikoWaiter, им должно быть предоставлено право "Привязывать заказ к гостю без прокатки карты гостя" (F_BGNC).

Если это право у персонала отсутствует, ручной ввод недоступен, возможна только привязка заказа через сканирование. При попытке ввести данные вручную система iikoWaiter отобразит сообщение о запрете действия:

Таким образом, чтобы ограничить персонал только сканированием, достаточно отозвать право F_BGNC.

3.4.3.1

Масштабное обновление плагина

Перешли на front api v9
В данных о покупке передаем номер стола, название зала и формат оплаты (б/н, наличка)
Списание бонусови отправка заказа теперь происходит в момент закрытия стола, а не печати фискального чека
Если в момент закрытия стола были проблемы с интернетом, то транзакция отправится при возобновлени связи
Заказы доставки и из зала теперь передаются с разными типами транзакций MCRM
Добавили в плагин модуль для продажи Сертификатов
Реализовали работу с предоплатой. Теперь бонусами можно внести предоплату (когда в QR-коде на оплату надо вывести сумму с учетом списанных бонусов)

3.4.1

Капитально переработали плагин.

Избавились от зависимостей версий библиотек используемых Front'ом
Упаковали весь плагин в одну dll-библиотеку.
Улучшили обновление плагина: теперь автоматическое обновление происходит в фоне, без необходимости перезапускать Front и запуска от Администратора. 2 секунды и всё обновлено!

Улучшили настройки макетов пречеков и чеков.

Макет пречека редактировать на Front'е в разделе "Дополнения"

Переменные для шаблона пречеков:

Гость: {guestName}
Номер карты: cardNumber}
Баланс: {balance}
Скидка промокод {promoCode}: {promoSum}
Итого со скидкой: totalWithPromo}
Доступно к списанию: {maxSpendSum}
Итого к оплате*: {totalToPay}

xml-файлы с макетами располагаются тут: \Users\NameUser\AppData\Roaming\iiko\CashServer\EntitiesStorage\Plugins\MCRM

В файле ChequeFooter.xml можно добавить тэг:

    <f1>
        <center>QR код вашей карты:</center>
        <qrcode size="tiny" correction="medium">{qrLink}</qrcode>
    </f1>

он отвечает за вывод QR-кода на скачивание персональной wallet-карты клиента

Улучшили работу с промокодами и отображение информации в заказе на Front'е о применении, ошибках и способе их устранения

Как работают промокоды:
после добавления промокода в заказ добавляется блюдо за полную стоимость
промокод прописался в комментарий
при переходе к оплате плагин чекает наличие промокода и товара по нему
добавляет оплату по товару типом оплаты MCRM
данная сумма бонусов (на скринах 100 руб.) не списывается с баланса карты гостя, а просто закрывается на тип оплаты MCRM

Так делается для того, чтобы не "портить" отчёты и фудкост блюд

Если промокод не применяется, то выводится ошибка и инструкция для исправления:

Улучшили работу с доп.счетами, в том числе пофиксили некоторые баги из-за которых мог требоваться повторный чекин карты в заказ.

Добавили в настройки (Дополнения) 2 пункта:

возможность скрыть вывод информации о клиенте (перс.данные) на фронте
возможность скрытия кнопки: поиск клиента по телефону

Добавили поддержку английского языка.
При переводе Front'а на английский язык, плагин автоматически тоже переходит на EN. Требуется перезапуск Fronta

3.3.3

Добавили обработку ошибки, которая могла возникать при использовании разных версий библиотек в iikoFront и MCRM Plugin

3.3.2

Что добавилось:

Плагин передает в запросе с заказом discount_code (код скидки).

Передается только скидка, которая ранее была добавлена клиенту в MCRM, иные не передаются.

Решена проблема автоматического обновления плагина при опубликовании новой версии в git-MCRM
Добавили вывод ошибки при отключенных комментариях. Отключенные комментарии мешали нормальной работе промокодов

3.3.1

Что добавилось:

Обработка составных блюд (OrderCompoundItem)

3.3.0

Что добавилось:

В iikoWaiter при чекине гостя теперь:

выводятся балансы всех счетов (основного и дополнительных);
показывается полная информация по клиенту, аналогично iikoFront;
показываются специальные акции, доступные гостю, аналогично iikoFront;

настроена регистрация клиентов с iikoFront, в полном соответствии с основной формой регистрации в программе лояльности. Список обязательных полей клиентской анкеты помечается *;
размер скидки передается в поле discount. Поэтому стала доступна настройка правил процессинга, связанных со скидкой;

в разделе Дополнения добавилась возможность настройки макета пречека и вывода информации о дополнительных счетах.

⚠️ Настройка макета пречека

Используются 2 шаблона: AfterFooter.xml и BeforeFooter.xml.

Шаблон пречека лежит по пути: AppData\Roaming\iiko\CashServer\EntitiesStorage\Plugins\Debug

Основное тело написано в BeforeFooter.xml

ФАЙЛЫ:

AfterFooter.xml

BeforeFooter.xml

BeforeFooter и переменные, которые можно использовать в макете:

<justify> 
<table> - таблица 
<columns> - настройки колонок таблицы 
<column autowidth=""/> 
<column align="right"/> 
</columns> 
<cells> 
<linecell/> - линия 
<c colspan="2">MCRM</c> - заголовок таблицы 
<guestblock> - блок информации по гостю. Вся инфа по гостю должна быть обернута в такие блоки, содержимое этих блоков не печатается, если гость не привязан к заказу
<ct>Гость:</ct>  
<ct>{guestName}</ct> - переменная, имя гостя 
<ct>Номер карты:</ct> 
<ct>{cardNumber}</ct> - переменная, номер карты 
<ct>Баланс:</ct> 
<ct>{balance}</ct> - переменная, баланс 
**<additionalWallets/> - этот тэг отвечает за печать всех счетов клиента** 
</guestblock> 
<promocodeblock> - блок информации о промокоде, если промо-кода нет в заказе, то блок игнорируется, для этого эти строки и выделены в спец блок. 
<ct>Скидка промокод {promoCode}:</ct> - promoCode переменная с названием промокода
<ct>{promoSum}</ct> - сумма промокода 
<ct>Итого со скидкой:</ct> 
<ct>{totalWithPromo}</ct> - переменная итогов 
</promocodeblock> 
<guestblock> 
<ct>Доступно к списанию:</ct> 
<ct>{maxSpendSum}</ct> - переменная макс. суммы к оплате 
<ct>Итого к оплате*:</ct> 
<ct>{totalToPay}</ct> - переменная, остаток к оплате 
</guestblock> 
<linecell/> 
</cells> 
</table> 
</justify>

Все переменные заключены в скобки { }
Можно использовать только те переменные, которые есть в шаблоне. Можно что-то убрать или переместить.
Все слова, которые не являются переменными, это простой текст, который можно менять.
Если шаблон удалить из папки, в которой они лежат, то плагин создаст его заново по умолчанию.

👉🏻 Обрати внимание:
additionalWallets - этот тэг отвечает за печать всех счетов клиента, если его убрать, то будет только основной баланс.