Инструкция по синхронизации iiko c Restoplace

2. Создайте папку Restoplace в каталог C:\ProgramFiles\iiko\iikoRMS\Front.Net\Plugins.

3. Отредактируйте конфигурационный файл плагина BeOpen.Front.RestoPlace.JsonRpc.dll.config:
замените фразу KEY_API на ваш api-ключ созданный в Restoplace. Где получить API ключ Restoplace?

⚠️ ВАЖНО! Если после всех настроек, плагин не может сконнектиться с веб-сокетом и статус подключения “Не активно” (см. скриншот), можно попробовать использовать не wss протокол, а ws. Также необходимо проверить корректен ли адрес после ws://.. ws://iiko.restoplace.cc/?key=KEY_API

Проверить запуск плагина можно, посмотрев логи по пути:
C:\Users\user_name\AppData\Roaming\iiko\CashServer\Logs\plugin-BeOpen.Front.RestoPlace.log

PaymentTypeName - параметр, который отвечает за тип оплаты, на который будет начислена предоплата. Сюда необходимо прописать название, созданного для плагина, типа оплаты. (пункт 4)

ProcessPrepayWithClosedCafeSession - параметр, отвечающий за проведение предоплат при закрытой кассовой смене.

Если установлено False при создании брони в iikoFront, если кассовая смена закрыта хотя бы на одном фискальном регистраторе, в банкет будет добавлен непроведенный платеж предоплаты, при этом не будет открыта кассовая смена. Далее, когда все кассовые смены будут открыты, платеж проведется фискальным платежем.

Если установлено True, платеж будет проводиться даже при закрытой кассовой смене, при этом она будет открываться и закрываться после проведения предоплаты. В этом режиме недоступна многофискальность.

4. В iikoOffice добавьте новый «Тип оплаты». Обязательные настройки типа оплаты: наименование «Restoplace Pay», включенная галочка «Может приниматься извне».

⚠️ ВАЖНО! Для того, чтобы оплата не фискализировалась повторно в iikoFront, у типа оплаты настройте фискализацию в качестве скидки, также в выпадающем списке ниже чекбокса необходимо выбрать скидку, которая будет указываться в OLAP-отчетах. Пример типа оплаты и скидки приведен ниже:

После создания оплаты, убедитесь что название совпадает с указанным названием в файле конфигурации BeOpen.Front.RestoPlace.JsonRpc.dll.config

5. Добавьте скрытый системный стол в iikoOffice. Это необходимо для того, чтобы не создавалась временная заявка в Restoplace, при создании Быстрого чека в iikoFront. (см скриншот)

⚠️ ВАЖНО! Если системный стол уже добавлен, то данный пункт 5 можно пропустить.

6. Перезапустите iikoFront, и убедитесь, что плагин установлен удачно, перейдя во вкладку «Сообщения» вы увидите тест «Плагин запущен!», отправитель «Restoplace Plugin». (см скриншот)

2️⃣ Вы попадёте в книгу резервов адреса. Нажмите кнопку «Настройки» в правом верхнем углу.

3️⃣ В открывшемся окне настроек адреса, раскройте пункт меню «Интеграции» и выберите подпункт «iiko»

4️⃣ Нажмите кнопку «Обновить». Если появилась надпись «Активно», то интеграция произведена успешно!

5️⃣ Настройте параметры интеграции:

5.1 Передавать в iiko резервы 🔁Выберите, какие заявки из Restoplace будут улетать в iiko:

• Все резервы — передаются все брони столов
• Только с депозитами — в айко отправляются только брони с внесенным депозитом гостем или сотрудником, оплаченные любым способом (наличными / онлайн)
• Только с депозитами (оплаченные онлайн) — улетают только брони с внесённой предоплатой онлайн (гостем в виджете или по ссылке на оплату от сотрудника)

5.2 Тип связи между Restoplace и iiko ↔️Определяет направление обмена:

• Двухсторонняя — брони синхронизируются в обе стороны
• Двухсторонняя (кроме заказов, открытых без брони на стороне iiko) — если официант открыл стол «с улицы» прямо в iiko, бронь в Restoplace не создаётся.
• Односторонняя из iiko в Restoplace — Restoplace только принимает изменения из iiko (обратно не отправляет)

5.3 Длительность заявки в Restoplace, если стол открыли в iiko ⏱️Когда стол открывают в iiko (без длительности), в Restoplace создаётся бронь на выбранный период. Например на 3 часа

5.4 После закрытия стола в iiko (оплата заказа), в Restoplace резерв закроется, через… ✅ Определяет задержку авто-закрытия брони после закрытия в iiko:

• Сразу — в Рестоплейс стол освободится сразу после закрытия в iiko
• Спустя время — выберите время, если кассе нужна пауза на печать чеков/доведение заказа.

💡 Важно: после изменения любой настройки перезапустите iikoFront

6️⃣ Свяжите столы и залы между Restoplace и iiko, для этого нажмите на кнопку «Связать объекты».
Как связать и разъединить объекты смотрите ниже.

7️⃣ После того как столы в iiko и Restoplace будут связаны, можно активировать обмен резервов между Restoplace и iiko, для этого включите галочку «Включить синхронизацию заявок с iiko»