База знаний Restoplace

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

Как работает синхронизация с iiko

  • При создании/редактировании резерва в iiko, резерв автоматически создаётся/обновляется в Restoplace (Передаваемые поля: Дата и время начала/конца резерва; Телефон гостя; Кол-во гостей; Комментарий)
  • При открытии стола в iiko, в Restoplace создаётся резерв (Передаваемые поля: Дата и время начала резерва. Время окончания резерва в Restoplace устанавливается автоматически. Данный период указывается в настройках интеграции от 1го до 12ти часов)
  • При создании/редактировании резерва в Restoplace, резерв автоматически создаётся/обновляется в iiko (Передаваемые поля: Дата и время начала резерва; Продолжительность резерва; Телефон гостя; Кол-во гостей; Комментарий; Депозит)

Технические требования важно!

  • ⚠️ Рекомендуется iikoFront 8.7 и выше
  • ⚠️ Лицензия iikoConnector for Restoplace (id 82081118). Лицензия платная, для уточнения стоимости и заказа данной лицензии обратитесь к партнеру iiko, который обслуживает ваше заведение

Особенности интеграции важно!

  • Из-за особенностей API iiko, после интеграции, в iiko все заявки будут создаваться типа «Банкет»
  • Если заявка в Restoplace имеет статус «Открыта», то её редактирование и закрытие/отмена возможны только через iiko
  • В iiko нет возможности забронировать зал целиком, поэтому если создать бронь на весь зал в Restoplace, то в iiko эта бронь не отправиться (групповые брони будут отправляться корректно)
  • iiko не принимает резервы длительность которых менее 15 минут. Если создадите резерв длительностью менее 15 минут, то в iiko он не появиться
  • iiko не дает отменить заказ с предоплатой по API. Поэтому резервы с предоплатой, при активной интеграции iiko, необходимо отменять на стороне iiko.

Как установить

Установка выполняется техническим специалистом партнёра iiko вместе с клиентом. Помощь специалистов Restoplace не требуется. Процесс установки занимает 15 минут

Установка плагина Restoplace в iiko

1. Скачайте плагин Restoplace для iikoFront
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
Логи iiko
PaymentTypeName - параметр, который отвечает за тип оплаты, на который будет начислена предоплата. Сюда необходимо прописать название, созданного для плагина, типа оплаты. (пункт 4)

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

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

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

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

⚠️ ВАЖНО! Для того, чтобы оплата не фискализировалась повторно в iikoFront, у типа оплаты настройте фискализацию в качестве скидки, также в выпадающем списке ниже чекбокса необходимо выбрать скидку, которая будет указываться в OLAP-отчетах. Пример типа оплаты и скидки приведен ниже:
Тип оплаты iiko
Скидка в iiko
После создания оплаты, убедитесь что название совпадает с указанным названием в файле конфигурации BeOpen.Front.RestoPlace.JsonRpc.dll.config
5. Добавьте скрытый системный стол в iikoOffice. Это необходимо для того, чтобы не создавалась временная заявка в Restoplace, при создании Быстрого чека в iikoFront. (см скриншот)

⚠️ ВАЖНО! Если системный стол уже добавлен, то данный пункт 5 можно пропустить.
Cистемный стол iiko
Cистемный стол интеграция iiko
Cистемный стол по умолчанию iiko
6. Перезапустите iikoFront, и убедитесь, что плагин установлен удачно, перейдя во вкладку «Сообщения» вы увидите тест «Плагин запущен!», отправитель «Restoplace Plugin». (см скриншот)
Cистемный стол по умолчанию iiko

Настройка интеграции в Restoplace

1. На главном экране сервиса app.restoplace.cc, перейдите в адрес заведения на котором настраивается интеграция с iiko
Настройка адреса Restoplace
2. Вы попадёте в книгу резервов адреса. Нажмите кнопку «Настройки» в правом верхнем углу.
Настройка адреса заведения Restoplace
3. В открывшемся окне настроек адреса, раскройте пункт меню «Интеграции» и выберите подпункт «iiko»

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

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

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

Как связать и разъединить объекты между Restoplace и iiko

После нажатия кнопки «Связать объекты», откроется окно в котором вы увидите все созданные столы и залы в Restoplace и в iiko. Их нужно связать между собой.

Для связи объектов, в колонке «Несвязанные объекты», выберите нажатием зал/стол в колонке iiko и зал/стол в колонке Restoplace. Нажмите кнопку «Связать». После успешной связи они появятся в колонке «Связанные объекты».

«Связанные объекты» можно разъединить при необходимости, для этого: наведите курсор мыши на связанные объект, появится кнопка «Разъединить», после нажатия они снова появятся в колонке «Несвязанные объекты» по отдельности.
Интеграция iiko и Restoplace
Разъединить столы iiko restoplace

Ответы на часто задаваемые вопросы

Ту мы собрали ответы на самые частые вопросы касаемые интеграции с iiko

Прочитайте ещё


Пошаговое руководство по установке виджета бронирования RESTOPLACE в группу вашего заведения в Вконтакте

Как изменить цветовое оформление виджета для гостей, который устанавливается на вашем сайте и в соцсетях

Пошаговое руководство по установке виджета бронирования RESTOPLACE в Inst-m вашего заведения

Как произвести интеграцию Restoplace с Bitrix24. Как подключить и настроить

Как произвести интеграцию UDS с Restoplace. Как настроить UDS

В этой инструкции вы узнаете, как установить HTML-код виджета бронирования Restoplace на Ваш сайт