Инструкция по синхронизации iiko c Restoplace
Как работает синхронизация с iiko
- При создании/редактировании резерва в iiko, резерв автоматически создаётся/обновляется в Restoplace (Передаваемые поля: Дата и время начала/конца резерва; Телефон гостя; Кол-во гостей; Комментарий)
- При открытии стола в iiko, в Restoplace создаётся резерв (Передаваемые поля: Дата и время начала резерва. Время окончания резерва в Restoplace устанавливается автоматически. Данный период указывается в настройках интеграции от 1го до 12ти часов)
- При создании/редактировании резерва в Restoplace, резерв автоматически создаётся/обновляется в iiko (Передаваемые поля: Дата и время начала резерва; Продолжительность резерва; Телефон гостя; Кол-во гостей; Комментарий; Депозит)
Технические требования важно!
- ⚠️ Рекомендуется iikoFront 7.9 и выше
- ⚠️ Лицензия iikoConnector for Restoplace (id 82076007). Лицензия платная, для уточнения стоимости и заказа данной лицензии обратитесь к партнеру 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?
4. В iikoOffice добавьте новый «Тип оплаты» с наименованием «Restoplace Pay» и установите галочку «Может приниматься извне». (см скриншот)
3. Отредактируйте BeOpen.Front.RestoPlace.JsonRpc.dll.config и замените фразу KEY_API на ваш api-ключ созданный в Restoplace. Где получить API ключ Restoplace?
4. В iikoOffice добавьте новый «Тип оплаты» с наименованием «Restoplace Pay» и установите галочку «Может приниматься извне». (см скриншот)
После создания оплаты, убедитесь что название совпадает с указанным названием в файле конфигурации BeOpen.Front.RestoPlace.JsonRpc.dll.config
5. Добавьте скрытый системный стол в iikoOffice. Это необходимо для того, чтобы не создавалась временная заявка в Restoplace, при создании Быстрого чека в iikoFront. (см скриншот)
ВАЖНО! Если системный стол уже добавлен, то данный пункт 5 можно пропустить.
ВАЖНО! Если системный стол уже добавлен, то данный пункт 5 можно пропустить.
6. Перезапустите iikoFront, и убедитесь, что плагин установлен удачно, перейдя во вкладку «Сообщения» вы увидите тест «Плагин запущен!», отправитель «Restoplace Plugin». (см скриншот)
Настройка интеграции в Restoplace
1. На главном экране сервиса app.restoplace.cc, перейдите в адрес заведения на котором настраивается интеграция с iiko
2. Вы попадёте в книгу резервов адреса. Нажмите кнопку «Настройки» в правом верхнем углу.
3. В открывшемся окне настроек адреса, раскройте пункт меню «Интеграции» и выберите подпункт «iiko»
4. Нажмите кнопку «Обновить». Если появилась надпись «Активно», то интеграция произведена успешно!
5. Свяжите столы и залы между Restoplace и iiko, для этого нажмите на кнопку «Связать объекты».
Как связать и разъединить объекты смотрите ниже.
6. После того как столы в iiko и Restoplace будут связаны, можно активировать обмен резервов между Restoplace и iiko, для этого включите галочку «Включить синхронизацию заявок с iiko»
4. Нажмите кнопку «Обновить». Если появилась надпись «Активно», то интеграция произведена успешно!
5. Свяжите столы и залы между Restoplace и iiko, для этого нажмите на кнопку «Связать объекты».
Как связать и разъединить объекты смотрите ниже.
6. После того как столы в iiko и Restoplace будут связаны, можно активировать обмен резервов между Restoplace и iiko, для этого включите галочку «Включить синхронизацию заявок с iiko»
Как связать и разъединить объекты между Restoplace и iiko
После нажатия кнопки «Связать объекты», откроется окно в котором вы увидите все созданные столы и залы в Restoplace и в iiko. Их нужно связать между собой.
Для связи объектов, в колонке «Несвязанные объекты», выберите нажатием зал/стол в колонке iiko и зал/стол в колонке Restoplace. Нажмите кнопку «Связать». После успешной связи они появятся в колонке «Связанные объекты».
«Связанные объекты» можно разъединить при необходимости, для этого: наведите курсор мыши на связанные объект, появится кнопка «Разъединить», после нажатия они снова появятся в колонке «Несвязанные объекты» по отдельности.
Для связи объектов, в колонке «Несвязанные объекты», выберите нажатием зал/стол в колонке iiko и зал/стол в колонке Restoplace. Нажмите кнопку «Связать». После успешной связи они появятся в колонке «Связанные объекты».
«Связанные объекты» можно разъединить при необходимости, для этого: наведите курсор мыши на связанные объект, появится кнопка «Разъединить», после нажатия они снова появятся в колонке «Несвязанные объекты» по отдельности.
Ответы на часто задаваемые вопросы
Ту мы собрали ответы на самые частые вопросы касаемые интеграции с iiko
Интеграция автоматизирует передачу броней столов между Restoplace и iiko, что упрощает работу сотрудников. Интеграцию с iiko подключают что бы при резервах в Рестоплейс, в iiko создавался заказ для официанта. Либо те кто хотят полностью управлять резервами из iiko. Есть свои особенности при интеграции с iiko, описаны в инструкции
Перейдите в настройки интеграции (с правами доступа "создатель" или "управляющий")
Если проблему не получилось решить, пришлите нам в чат поддержки файл конфигурации и логи
- Проверьте включена ли синхронизация, если выключена – включите её
- Проверьте активен ли "статус подключения". Если статус не активен: Проверьте верно ли указан ключ интеграции, в файле конфигурации плагина (на скриншоте нахождение файла). Проверьте логи плагина, посмотрите какая там ошибка. Логи находятся тут: %AppData%\Roaming\iiko\CashServer\Logs\plugin-BeOpen.Front.RestoPlace.JsonRpc.log
- Проверьте верно ли связаны залы и столы
Если проблему не получилось решить, пришлите нам в чат поддержки файл конфигурации и логи
Перейдите в настройки интеграции (с правами доступа "создатель" или "управляющий") и проверьте верно ли связаны залы и столы
Чтобы программа понимала какой стол в Рестоплейс к какому столу из Айко относится – нужно их верно связать. Если есть не верно связанные столы – нужно их отвязать и заново связать правильно.
Если проблему не получилось решить, пришлите нам в чат поддержки файл конфигурации и логи
Чтобы программа понимала какой стол в Рестоплейс к какому столу из Айко относится – нужно их верно связать. Если есть не верно связанные столы – нужно их отвязать и заново связать правильно.
Если проблему не получилось решить, пришлите нам в чат поддержки файл конфигурации и логи
Если статус не активен:
Если проблему не получилось решить, пришлите нам в чат поддержки файл конфигурации и логи
- Проверьте верно ли указан ключ интеграции, в файле конфигурации плагина (на скриншоте нахождение файла).
- Проверьте логи плагина, посмотрите какая там ошибка. Логи находятся тут: %AppData%\Roaming\iiko\CashServer\Logs\plugin-BeOpen.Front.RestoPlace.JsonRpc.log
Если проблему не получилось решить, пришлите нам в чат поддержки файл конфигурации и логи
Для работы интеграции необходима лицензия iikoConnector for Restoplace (id 82076007). Лицензия платная, для уточнения стоимости и заказа данной лицензии обратитесь к партнеру iiko, который обслуживает ваше заведение
Изменение резерва через плагин в форму банкета iiko происходит для полной синхронизации резервов. Дело в том, что функции резерва в Рестоплейс и iiko немного отличаются, и стандартная форма резерва в iiko не может полностью принять все данные из резерва Рестоплейс. Банкет iiko же получает все данные в полном объеме. Именно поэтому используется такой способ интеграции
В iiko создастся Банкет с заказом, у заказа будет предоплата, оплата сразу переходит на ваш р/с по интернет эквайрингу
Нет, интеграция с iiko подключается дилером iiko c вашей стороны по данной инструкции
iiko не дает отменить заказ с предоплатой по API. Поэтому резервы с предоплатой, при активной интеграции iiko, необходимо отменять на стороне iiko.
Так как в iiko при открытии стола не указывается продолжительность, а в Рестоплейс необходимо указать время начала и окончания брони (чтобы стол не был занят весь день) необходимо задать продолжительность в этой настройке – задаётся время, на которое заявка будет открываться в Рестоплейс, если её создали напрямую в iiko
Нет, интеграция передаёт только брони столов. Билеты и сертификаты в iiko не передаются
Один из возможных способов использования: создайте в iiko скидку или сертификат с любым номером и реальной суммой сертификата из Рестоплейс, чтобы перекрыть сумму заказа в iiko. Это позволит корректно закрыть заказ и избежать недостачи по сумме заказа для фискализации https://ru.iiko.help/articles/#!iikocard/topic-39/a/h3__1749710456
Прочитайте ещё
Пошаговое руководство по установке виджета бронирования RESTOPLACE в группу вашего заведения в Вконтакте
Как изменить цветовое оформление виджета для гостей, который устанавливается на вашем сайте и в соцсетях
Пошаговое руководство по установке виджета бронирования RESTOPLACE в Inst-m вашего заведения
Как произвести интеграцию Restoplace с Bitrix24. Как подключить и настроить
Как произвести интеграцию UDS с Restoplace. Как настроить UDS
В этой инструкции вы узнаете, как установить HTML-код виджета бронирования Restoplace на Ваш сайт