- Инстркуия к интеграции системы iiko v7 и выше с POS терминалами
- Создание Скидки
- Настройки в кабинете
- Редактирование макета:
- Установка плагина
- Создание Бонуса или Подарочного сертификата
- Создание MCR алгоритма
- Создание Бонуса или Подарочного сертификата
- Установка плагина
- Настройки FARCARDS
- Создание API Token сканера для карты
- Создание API token сканера для карты
- Активация 2D канера
- Создание Купона
- Создание Скидки
- Активация сканирования в iiko waiter
- Настройка PDS
- Создание Купона
- Настройки плагина
- Настройки в кабинете
- Редактирование макета:
- Настройки плагинa
Инстркуия к интеграции системы iiko v7 и выше с POS терминалами
Как можно решить данную проблему ?
Добрый день.
Попробуйте метод AddExternalPaymentItem
у IOperationService
. Необходимо учитывать, что для такого метод CanPaySilently
у IExternalPaymentProcessor
добавляемого типа должен возвращать true
,
Теперь выдает . Payment item of type Банковская карта cb0ac227-a559-4258-b743-88f6315d3555 cannot be added as external processed. PaymentType should be CanBeExternalProcessed.
Но у этого типа оплаты я никак не поставлю «Может приниматься извне» Так как это оплата внешняя и данные параметры просто серые в офисе.
OperationspaymentItemSum additionalData paymentType submittedOrder _credentials Operations_credentials submittedOrder paymentItem
Ну да, послав isProcessed = false получил Cannot process external payment item that is not processed externally and doesn't support silent processing.
Есть еще варианты решения ?
Если тип оплаты внешний плагинный, то единственный вариант закрыть заказ из апи с таким типом — это поддержка этим типом тихой оплаты. Тихая оплата подразумевает отсутствие взаимодействия с пользователем на фронте, чтобы работающему на фронте официанту с одним заказом в произвольное время не выплыл попап с подтверждением действия оплаты совершенно другого заказа. Если же внешний плагинный тип оплаты не поддерживает тихую оплату, то единственный способ закрыть заказ с таким типом — это закрыть его с экрана кассы фронта.
Метод PayOrder
начиная с версии 7.4.6 (RMS-50049) стал поддерживать закрытие заказа с внешними плагинными тихими типами наравне с ProcessPrepay
. Вот новость об этом: https://iiko.github.io/front.api.doc/2020/11/09/silent-plugin-payments.html
интеграция с Лайм платная — 1500р/мес
чтобы лицензия работала корректно, нужно заменить номер id на 82055718.
Главное условие, для возможности пробития чеков Лайма в iiko — это одинаковые названия товаров и типов оплаты.
Также типы оплаты в iiko office должны быть настроены на прием извне
Для чистоты отчетов лучше делать настройки как можно схожими по смыслу.
Возвраты в системе iiko автоматически провести невозможно, так что для правильности отчетов это нужно делать вручную в iikoFront, на котором запущен плагин
Также, если при отправке чека была закрыта смена на iiko, то появившиеся открытые заказы следует удалить, так как они пройдут при следующем нажатии кнопки Провести в окне статуса плагина
Заполнить файл PluginSettings.json следующим образом:
Login - Логин вашей учетной записи в системе Лайм Password - Ваш пароль от это учетной записи Address - Для пользователей нашего сервера "https://admin.lime-it.ru/" или адрес вашего локального сервера InstalationId - Id вашей инсталляции(можно посмотреть в адресной строке) Pin : Пин пользователя в iiko, от имени которого будут пробиваться чеки Port - Свободный порт, на который будут приходить чеки от касс Лайм
Id инсталяции можно увидеть здесь:
Для того, чтобы получать чеки нужно дать разрешение на прослушивание порта
Для это в командной строке, от имени Администратора, нужно выполнить следующую команду:
netsh http add urlacl url=http://+:6666/api/CashdeskServer/ user=YOURUSER
YOURUSER - имя пользователя Windows, работающего с iikoFront 6666 - Порт из настроек плагина Если при выполнение этой команды возникла ошибка 183 Невозможно создать файл, так как он уже существует, то, скорее всего, это разрешение уже было добавлено ранее
Для начала, проверяем, включен ли брандмауэр(найти его можно в панели управления) Если он включен, то переходим в Дополнительные параметры
В открывшемся окне выбираем Правила для входящих подключений. Нажимаем Создать правило
Выбираем правило для Порта
Протокол TCP
Определенный порт: Порт из настроек плагина
Разрешить подключение
Выбрать доменный, частный и публичный
Ввести говорящее имя, чтобы случайно не удалить и не забыть, зачем оно нужно
Заходим в кассу с учетной записи администратора
Заходим в настройки
В окне настроек нажимаем кнопку Плагины
Из появившегося списка выбираем Отправление чеков в iiko
Ставим галочку в поле Разрешить
В поле Адрес плагина iiko адрес компьютера в локальной сети с запущенным плагином в iiko в формате:
http://(ip компьютера в локальной сети):(Порт из настроек плагина iiko)
=== iikoCloud for WooCommerce === Contributors: makspostal Tags: iiko, woocommerce, delivery, restaurant Requires at least: 5.5 Tested up to: 5.7 Requires PHP: 7.2 Stable tag: 1.3.2 License: GPLv3 License URI: https://www.gnu.org/licenses/gpl-3.0.html iikoCloud API (iikoTransport API) is a single point to use the functionality provided by iiko. == Description == This plugin provides the integration of the basic functionality of the iikoCloud API into WooCommerce: 1. Import of organizations, terminals, nomenclature (categories of dishes, goods, and dishes with sizes and modifiers), payment types, cities, and streets. 2. Export of orders. 3. Auto import using WP CRON (PREMIUM). [iiko](https://iiko.ru/) – a convenient and reliable solution used by a wide variety of establishments: from tiny bars and coffee houses to large restaurant chains with hundreds of outlets and a developed franchise, from food court cafes to gourmet restaurants, from ready-to-eat food delivery projects to gastro-markets. [Documentation iiko](https://ru.iiko.help/) [iikoTransport. API description](https://api-ru.iiko.services/) = How to work with the plugin = 1. Enter apiLogin on the plugin settings page (Main tab). Click the "Save Changes" button. 2. Go to the plugin page and click the "Get Organizations" button. 3. Select the required organization and click the "Get Terminals" button. 4. Select the required terminal and click the "Get nomenclature" button. 5. Select the desired groups and click the "Import Selected Groups and Products" button. The selected groups and the products / products they contain will be uploaded to the site. 6. Click the "Get Cities" button. 7. Select the city for which you want to load streets and click the "Get streets" button. 8. Click the "Get Payment Types" button. 9. Enter the default street name in the plugin settings. It will be used when the client enters a street name that is not in iiko. This street must be added to iiko. 10. Fill in the WooCommerce payment method designations corresponding to the iiko payment types in the plugin settings. For example, the settings for the standard Cash payment method are available at /wp-admin/admin.php?page=wc-settings&tab=checkout§ion=cod, where `cod` stands for the Cash payment method. 11. Orders are exported to iiko automatically when placing orders on the website. 12. Check 'Import nomenclature automatically' and set recurrence period on 'Auto import' plugin settings page if you want to use it. = Notes = 1. You can upload an item to the site without selecting a terminal, but it is impossible to export orders to iiko without specifying a terminal. 2. Groups highlighted in green are optional to load, since these are modifier groups loaded as individual attributes of goods. Strikethrough groups - marked for deletion in iiko. 3. The plugin settings contain the names and IDs of the selected organization, terminal and city, as well as the number of loaded streets. These fields are not available for editing in the plugin settings and are filled in automatically: - the name and ID of the organization and the terminal - by clicking on the "Get the item" button; - city name and ID, as well as the number of loaded streets - by clicking on the "Get streets" button. 4. When placing an order, the fields "Name", "Phone", "Address", and "Supplement to the address" must be required. 5. The phone number must start with the "+" symbol and be at least 8 digits long. 6. To change the customer's phone when exporting an order, you can use the `skyweb_wc_iiko_order_phone` filter. 7. To add the date and time of order preparation when exporting orders, you can use the `skyweb_wc_iiko_order_complete_before` filter. 8. To add additional address data when exporting orders, you can use the `skyweb_wc_iiko_order_delivery_point` filter. 9. To add additional data to the comment when exporting orders, you can use the `skyweb_wc_iiko_order_comment` filter. 10. To add the number of guests when exporting orders, you can use the `skyweb_wc_iiko_order_guests` filter. 11. To add payment methods when exporting orders, you can use the `skyweb_wc_iiko_order_payments` filter or use the logic implemented by the plugin. 12. Supports downloading a list of streets for one city. = Working with iiko = * [Connection iikoCloud API](https://ru.iiko.help/articles/#!api-documentations/connect-to-iiko-cloud) * [Dishes categories](https://ru.iiko.help/articles/#!iikooffice-7-6/topic-35) * [Nomenclature elements](https://ru.iiko.help/articles/#!iikooffice-7-6/topic-41) * [Modifiers](https://ru.iiko.help/articles/#!iikooffice-7-6/topic-3100) * [Size scale](https://ru.iiko.help/articles/#!iikooffice-7-6/topic-3080) * [Modifier schemes](https://ru.iiko.help/articles/#!iikooffice-7-6/topic-224) * [Orders to change the price list](https://ru.iiko.help/articles/#!iikooffice-7-6/topic-801) * [Payment types](https://ru.iiko.help/articles/iikooffice-7-6/topic-103) = Support for themes = **This plugin works great with the shipping theme [Skyweb Delivery](https://rudelivery.skyweb.team)** = PREMIUM version = **PREMIUM version includes:** * Lifetime license. * Free updates. * Direct support. * Installation support. * Additional services. To get it please email to **hi@skyweb.team** == Frequently Asked Questions == = Where can I get apiLogin? = Read the documentation [iikoCloud API connection](https://ru.iiko.help/articles/#!api-documentations/connect-to-iiko-cloud) or contact your personal iiko manager / integrator. = Is import of nested iiko product groups supported? = No, but you can manually nest WooCommerce product categories through the Products - Categories section. = Is WooCommerce variable product import supported? = Yes, with the following features: 1. Supports loading iiko dish sizes (one size scale per dish - iiko limitation) as individual attributes of a WooCommerce product. 2. Supports loading only group modifiers (one group of modifiers - plugin restriction) as individual attributes of a WooCommerce product. 3. Price / quantity / conditions of modifiers are not taken into account when creating variations of a WooCommerce product. The variation price is formed as follows: * If the loaded dish has only sizes, then for each size its own variation with the price of the size is created. * If the loaded dish has only a group of modifiers, then for each modifier its own variation with the price of the dish is created. * If the loaded dish has both sizes and a group of modifiers, then for each size several variations are created (depending on the number of modifications) with the price of the size. 4. The modifier schema is not supported in menu unloading, that is, modifier schemas are not transferred via the iikoCloud API. Use only custom modifiers for the dish. = Is the "Default" attribute of iiko sizes supported (specified when creating the size scale)? = Not. = Is the "Available" attribute of iiko sizes supported (specified when editing a dish)? = Yes. = Is import iiko modifiers supported as WooCommerce products? = No, product modifiers are loaded only as attributes, see the question above. = Is import of iiko products supported as WooCommerce products? = Yes. = What data is being imported? = **Categories (groups):** - name; - description; - image; - iiko ID; - SEO title (SeoTitle); - SEO description (SeoText). Modifier groups that are removed and excluded from the group menu are not imported or updated. SEO data is imported for the Yoast SEO plugin. **Products (dishes):** - name; - description; - short description (technical information); - main image; - image gallery (not supported by iiko API); - SKU; - price; - weight; - tags (labels), filled in iiko BackOffice separated by semicolons `;` without spaces; - iiko ID; - SEO title (SeoTitle); - SEO description (SeoText). Deleted dishes are not imported or updated. Dishes excluded from the menu are imported with the "hidden everywhere" status. SEO data is imported for the Yoast SEO plugin. = What does the 'Error while getting iiko nomenclature from the cache.' mean? = It means that you need to update the item from iiko on the plugin page. = What if I want additional features? = Email **hi@skyweb.team** = How do I get the PREMIUM version? = Email **hi@skyweb.team** == Installation == = Using The WordPress Dashboard (Recommended) = 1. Go to `Plugins` → `Add New`. 2. In a search field type **iikoCloud for WooCommerce** and hit enter. 3. Click `Install Now` next to **iikoCloud for WooCommerce** by SkywebSite. 4. Click `Activate the plugin` when the installation is complete. = Uploading in WordPress Dashboard = 1. Go to `Plugins` → `Add New`. 2. Click on the `Upload Plugin` button next to the **Add Plugins** page title. 3. Click on the `Choose File` button. 4. Locate **skyweb-wc-iiko.zip** on your computer. 5. Click the `Install Now` button. 6. Click `Activate the plugin` when the installation is complete. = Using FTP (Not Recommended) = 1. Download **skyweb-wc-iiko.zip**. 2. Extract the **iikoCloud for WooCommerce** directory to your computer. 3. Upload the **skyweb-wc-iiko** directory **/wp-content/plugins/** 4. Go to `Plugins` → `Installed Plugins`. 5. Click `Activate` under **iikoCloud for WooCommerce** plugin title. = Requirements = 1. For the plugin **iikoCloud for WooCommerce** to work, you must have installed and activated plugin **WooCommerce**. 2. Plugin settings are located in the menu: `WooCommerce -> Settings -> iikoCloud`. 3. If the apiLogin field is empty, then the plugin will not work. == Changelog == = 1.3.2 = * Added auto import using WP CRON (PREMIUM). * Minor fixes. = 1.3.1 = * Added order checking from order list in admin panel. * Improved order export comment. * Improved logs. * Fixed known issues. = 1.3 = * The export of the order is sent once when the order is created. * If the order is successfully exported, a corresponding notification is added to it. * Added the ability to manually export an order from the admin panel. * Added a filter to change the customer's phone number when exporting an order. * Added 'Complete before' field to indicate order time. * Added processing of address fields on the checkout page. * Added new import settings. * The settings page is grouped into blocks by separate tabs. * And something more. = 1.2 = * Added notifications to the administrator's mail in case of problems with exporting orders. = 1.1 = * Support for WooCommerce and iiko payment methods. * Increased minimum PHP version to 7.2 (for compatibility with the nearest WooCommerce versions). = 1.0 = * The first version of the plugin. == Screenshots == 1. Plugin settings (tab General). 2. Plugin settings (tab Import). 3. Plugin settings (tab Export). 4. Plugin settings (tab Payment types). 5. Plugin settings (tab Auto import). 6. Plugin settings (tab Checkout). 7. Plugin page. 8. Imported products (front). 9. Checkout page (example). 10. Orders page (additional order actions: export to iiko and check status).
Создание Скидки
Откройте систему r_keeper и зайдите в неё
Пройдите в меню в раздел «Деньги» и откройте «Скидки и Наценки»
- Откроется окно управления скидок и наценок, наведите мышь на поле «All» и с помощью правой кнопки мышки создайте новый тип скидок
- Откроются «Свойства», в них введите Название своей скидки и поменяйте статус на Активный
- Пройдите в окно «Скидки/Нацинки» вашей новой скидки и создайте новую скидку (Нажмите правой кнопки мышки на свободое поле, из возникших опций выберите «Новая скидка»)
- Введите название вашей скидки, пока что не меняйте статус на активный
- Откройте детализацию вашей скидки двойным кликом на иконку
- Создайте новую детализацию (Нажмите правой кнопки мышки на свободое поле, из возникших опций выберите «Новая детализация»)
- Откройте поле настроек детализации, и поменяйте процент скидки на проценты скидок настроеные в кабинете
- Сохраните изменения
- Пройдите обранто в «Свойства» вашей скидки и поменяйте статус на активный «Active»
Повторите все пункты по созданию новой детализации для каждого уровня скидок имеющихся в вашем кабинете
Сохраните изменения, но еще не закрывайте окно «Скидки и Надбавки»
Настройки в кабинете
Редактирование макета:
Для использования скидок, подарочных сертификатов и бонусов в системе iiko штрихкод на карте должен содержать Номер Карты. Для настройки штрихкода на Номер Карты:
Зайдите в ваш личный кабинет Loona
Перейдите в раздел Макеты
Зайдите в
редактирование того макета на который хотите настроить сканер
Перейдите в секцию Дизайн
Нажмите на штрихкод, в настройках поля откроются настройки штрихкода
Поменяйте значение на Номер Карты
Для использования купона:
В значении штрихкода поменять значение на “своё значение”
Использовать карты Loona
Установка плагина
Скопируйте папку LoonaPluginSettings в C:\ProgramData
Скопируйте папку LoonaPlugin (и iikoWaiter5 при необходимости) в директорию iikoFront/Plugins (в нашем случае C:\Program Files\iiko\iikoRMS\Front.Net\Plugins)
Пройдите в свойства папки, зайдите в Безопасность, и дайте полный контроль Пользователю с которого вы заходите в систему
- Запускаем iiko Front (помним что для данного метода необходима лицензия типа iikoFrontPaymentPlugin)
Создание Бонуса или Подарочного сертификата
Зайдите в r_keeper менеджер
Пройдите в типы бонусов
Создайте новый бонус и назовите его LoonaBonus
Пройдите в меню в раздел «Деньги» и откройте «Скидки и Наценки»
- Откроется окно управления скидок и наценок, наведите мышь на поле «All» и с помощью правой кнопки мышки создайте новый тип скидок
- Откроются «Свойства», в них введите Название своей скидки и поменяйте статус на Активный
- Пройдите в окно «Скидки/Нацинки» и создайте новую скидку (Нажмите правой кнопки мышки на свободое поле, из возникших опций выберите «Новая скидка»)
- Введите название вашей лояльности, пока что не меняйте статус на активный
- Откройте детализацию вашей лояльности двойным кликом на иконку
- Создайте новую детализацию (Нажмите правой кнопки мышки на свободое поле, из возникших опций выберите «Новая детализация»)
- Откройте поле настроек детализации, и укажите «тип бонуса»: LoonaBonus
- Сохраните изменения
- Пройдите обранто в «Свойства» вашей скидки и поменяйте статус на активный «Active»
- Сохраните изменения, но еще не закрывайте окно «Скидки и Надбавки»
Создание MCR алгоритма
- Откройте папку где содержится R-keeper и запустите R-keeper «Manager»
- Далее, откройте r_keeper менеджер и пройдите в Сервисы -> Обработка Сигналов Устройств -> MCR алгоритмы
- Откроется страничка существующих алгоритмов. Убедитесь что у вас имеется алгоритм loona.
Создайте новый алгоритм для элекртонных карт
Для создания нового алгоритма можно просто скопировать любой имеющийся алгоритм и вставить его в окно алгоритмов.
После этого переименуйте скопированый алгоритм на loona.
Нажмите на алгоритм и откроются свойства справа, поменяйте статус на Active и затем убедитесь что все настройки совпадают с настройками представленными ниже:
- Нажмите на скрипт, и откройте окно скрипта с помощью иконки слева.
- В окне скрипта замените имеющийся скрипт на код расположенный ниже:
function MCR1000028(DeviceSignal: Integer; DeviceIdent: Integer; var Parameter: String): Boolean;
var enc: integer; id, ratio, couponeCode :integer;
var encShift, couponCodeShift :integer;
var couponSeparateSymbol :String;
var idString:String;
var cardCodeResult:Int64;
begin
Result:=false;
ratio :=1000;
encShift :=48;
couponCodeShift:=36;
couponSeparateSymbol := '/';
if pos('-', Parameter) > 1 then begin
Enc := StrToIntDef(copy(Parameter, 1, pos('-', Parameter) - 1),-1);
if Enc>0 then begin
idString := copy(Parameter, pos('-', Parameter)+1, length(Parameter));
if pos(couponSeparateSymbol, idString) > 1 then begin
couponeCode := StrToIntDef(copy(idString, pos(couponSeparateSymbol, idString)+1, length(idString)),-1);
idString := copy(idString, 1, pos(couponSeparateSymbol, idString) - 1)
end;
id := StrToIntDef(idString,-1);
cardCodeResult := (enc shl encShift ) and (StrToInt64('0x7FFF')shl encShift);
cardCodeResult := cardCodeResult or ((couponeCode shl couponCodeShift) and (StrToInt64('0xFFF')shl couponCodeShift) ) ;
cardCodeResult := cardCodeResult or id;
Parameter :=Int64ToStr(cardCodeResult);
Result:=true;
end;
end;
end;
- Нажмите «Ок» и закройте окно
Создание Бонуса или Подарочного сертификата
Добавляем внешний вид оплаты. Переходим в раздел “Розничные продажи” нажимаем на “Тип платы” и добавляем новую оплату.
Обязательно указываем данные так же:
- Наименование — LoonaPayment
- Тип — Внешний тип оплаты
- Название в чеке — Электронная карта
- Безналичный тип — LoonaPayment
Установка плагина
Перед установкой нобходимо:
Убедиться в наличии .Net Framework версии 4.6.2. или выше. Версия бывает доступна на ОС Windows 7 и новее.
В течении использования плагина, нужно отключить Windows Firewall или открыть доступ для порта плагина (port 1234)
Необходимо настроить имеющийся FARCARDS.ini (настройки ниже)
Запустите Setup.exe от имени администратора
Откроется окно установки, в первом поле выберите папку в которой хранится Ваш Farcards и во втором поле выберите папку для установки плагина
- После установки зайдите в Windows -> Services (Сервисы), найдите Loona r-keeper plugin и убедитесь что «Startup Type» стоит автоматичекий (Automatic)
Не закрывайте окно сервисов
В папке с плагином также для вашего удобства содержится FARCARDS со всеми необходимыми настройками. Если имеется FARCARDS, можно настроить его вручную. (Настройки ниже)
Настройки FARCARDS
- Скопируйте «Extdll.dll» и «Extdll.ini» в папку UCS/FARCARDS
Откройте файл «FARCARDS.INI» в текстовом редакторе
В поле DLL впишите «ExtDll.dll» и сохраните изменения
- Запустите «Farcards.exe – install»
Создание API Token сканера для карты
Для интеграции с r_keeper вам необходимо создать сканер в кабинете Loona и использовать его токен доступа.
Для создания нового сканера:
- Зайдите в ваш личный кабинет Loona
В разделе Сканер нажмите на Создать сканер.
Введите название нового сканера
Выберите тип сканера — «App».
Выберите макеты с картами которые предназначены для сканирования, или отметьте Получить полный доступ чтобы сканер работал со всеми вашими макетами.
В списке созданных сканеров появится новый сканер со своим Идентификационным номером, этот номер используется при настройке плагина.
Создание API token сканера для карты
Для интеграции с системой iiko вам необходимо создать сканер в кабинете Loona и использовать его токен доступа.
Для создания нового сканера:
- Зайдите в ваш личный кабинет Loona
В разделе Сканер нажмите на Создать сканер.
Введите название нового сканера
Выберите тип сканера — «App».
Выберите макеты с картами которые предназначены для сканирования, или отметьте Получить полный доступ чтобы сканер работал со всеми вашими макетами.
В списке созданных сканеров появится новый сканер со своим токеном доступа (Идентификационный номер), этот номер используется при настройке плагина.
Активация 2D канера
Заходим в раздел Сотрудники -> Сотрудники и добавляем сотрудника
Обязательно введите имя сотрудника «Loona»
Ставим галочку «Только для плагинов»
Ставим галочку на «Сотрудник»
Добавляем должность — «Системный Администратор»
Далее, пройдите в секцию «Дополнительные сведения»
Обязательно введите ПИН-код: 1945
- Перезагрузите кабинет
Создание Купона
Для создания купона пройдите все пункты для создания скидки, но измените указаный процент скидки на 100%.
Создание Скидки
- Открываем iiko Office
- Переходим в раздел Дисконтная Система -> Скидки и Надбавки
- Добавляем скидку
- Пишем свои названия скидок как показано ниже, они будут использованы в настройках плагина
- Тип скидки ставим Скидки и Надбавки
- Нажимаем Далее
- Убираем галочку «Можно назначить вручную», остальное по усмотрению ресторана
- Тип ставим “Процент” и назначаем процент данной скидки
Нажимаем Далее и заканчиваем установку скидки.
Повторяем добавление скидки со всеми имеющимся уровнями скидок
Активация сканирования в iiko waiter
Зайдите в localhost:8100/settings через браузер
Пройдите к «Loyalty System Integration Settings»
- Loyalty plugin address: localhost:1234/api/op
- Отметьте «галочкой» Is External Loyalty Enabled
- Сохраните настройки
Если не можете зайти в настройки по ссылке выше:
Зайдите в кассу
Нажмите на «Дополнения» и затем на «iikoWaiter Настройки»
- Откроется QR код, отсканируйте его и пройдите по ссылке
Настройка PDS
В настройку PDS входит:
- Создание PDS интерфейса
- Создание и настройка кассового сервера (устройство)
- Создание валюты для оплаты с PDS (не обязательно для скидкочной лояльности)
- Введение интерфейсов PDS FARCARDS.ini и TMS.ini (при необходимости и наличии мобильного официанта)
- Введение интефейса в MCR алгоритм
- В r_keeper менеджере и пройдите в Сервис -> Интерфейсы
- В открывшемся окне создайте новый PDS (или можно настроить имеющийся), и введите данные как показано ниже
Далее, нужно создать кассовый сервер (устройство) и валюту PDS
Пройдите в Сервис -> Стаанции и Устройства, откройте Cash Server вашего ресторана и создайте «устройство» с PDS интерфейсом.
В поле PDS Server Name введите название вашего интерфейса как показано ниже
Выберите «Yes» на Pass ALL Reciepts XML data и Pass ALL Bills XML data
Далее, для создания валюты пройдите в Деньги->Валюты
В разделе оплаты картами создайте PDS оплату
В поле максимальный процент введите 100.00
В интерфейсе введите свой PDS интерфейс
Далее, введите данные о PDS интерфейсе в FARCARDS и TMS
Убедитесь что значение в поле Код записано в файлах TMS.ini и FARCARDS.ini:
- в файле TMS.ini пройдите в р аздел [CARDDATA] и поменяйте значение Interface на Interface = (введите значение Кода)
- далее, в том же файле дайте то же значение для Interface в разделе [RTGI] как показано ниже
Убедитесь что название созданой PDS совпадает с названием указаным в FARCARDS.ini
- в файле FARCARDS.ini пройдите в раздел [pds_netk] и поменяйте значение NetServerName на NetServerName = (введите название PDS)
*имейте ввиду, что поочередность введения данных в файлах имеет значение. Например в TMS.ini CARDDATA сначала впишите Interface, а затем RKDeviceTypeKind.
При возникновении проблем при проведении транзакции, проверьте PDS_netk.log и удестоверьтесь что на FARCARDS запросы приходят справильного интерфейса. Запросы могут приходить с предустановленного интерфейса, в этом случае можно выключить предустановленный интерфейс
Далее, зайдите в созданый вами MCR алгоритм и выберите созданый PDS в поле «Обьект»
Создание Купона
Для создания купона пройдите все пункты для создания скидки, но измените указаный процент скидки на 100%.
Настройки плагина
Заходим на http://localhost:1234/settings
- Api access token — доступен после создания сканера в кабинете (подробнее в разделе настройки кабинета) или по запросу от поддержки компании Loona
- Api base url — https://api.loona.ai
- Plugin url — http://localhost
- Waiter port — 1234
- Update URL — https://storage.yandexcloud.net/loona-common/loona-plugin/
Далее заполняем детали всех имеющихся уровней скидок в кабинете, и называем их так же как названы соответствующие уровни скидок в iiko office
- Устанавливаем мобильное приложение iikoWaiter5 если нужно
Настройки в кабинете
Редактирование макета:
Для использования скидок, бонусов и подарочных сертификатов в системе r_keeper штрихкод на карте должен содержать Номер Карты. Для настройки штрихкода на Номер Карты:
Зайдите в ваш личный кабинет Loona
Перейдите в раздел Макеты
Зайдите в
редактирование того макета на который хотите настроить сканер
Перейдите в секцию Дизайн
Нажмите на штрихкод, в настройках поля откроются настройки штрихкода
Поменяйте тип штрихкода на QR
Поменяйте значение на Номер Карты
Для использования купона:
В значении штрихкода поменять значение на “своё значение”
Использовать карты Loona
Настройки плагинa
Откройте ваш браузер и пройдите по адресу: «localhost:1234/settings»
Откроется поле настроек плагина.
- Api access token — доступен после создания сканера в кабинете (подробнее в разделе настройки кабинета) или по запросу от поддержки компании Loona
- Api base url — https://api.loona.ai
- Plugin url — http://localhost
- Waiter port — 1234
- Update URL — https://storage.yandexcloud.net/loona-common/loona-plugin/
- Loona Plugin Path — папка в которой установлен плагин Loona
- Farcards Path — папка в которой находится Farcards.exe
Далее, Введите необходимые параметры для настройки скидки и сохраните параметры. Код вашей скидки, бонуса или купона вам доступен в свойствах скидки в r_keeper manager.
Сохраните изменения параметров плагина
Вернитесь в «Сервисы», выделите сервис Loona r-keeper plugin, обновите сервис (сервис должен выключится после обновления), затем запустите сервис