Интеграции с популярными POS-системами

В данном разделе описано, как сделать интеграции с iiko, r-keeper, frontpad, а также самые частые вопросы по интеграциям, возникающие в процессе работы
  • Интеграция с iiko
  • Интеграция с frontpad
  • Интеграция с r-keeper (электронная бонусная карта)
  • Интеграция с r-keeper (заказы) - в разработке
Интеграция со сторонней системой производится с помощью стандартных API интерфейсов сторонней системы. Необходимо быть готовым к тому, что неизбежно будут возникать вопросы по текущей работе, так как стабильность всего процесса зависит не только от Bamps!Delivery, но в большей степени от сторонней системы.
Подготовка к интеграции с iiko

Интеграция с системой iiko осуществляется по API Transport. Для этого у вас должен быть подключен iiko Cloud.

Для подготовки интеграции iiko с Bamps необходимо cообщить менеджеру "Фабрики Приложений":

1. API-ключ. Необходимо в iiko создать отдельный API ключ для интеграции с мобильным приложением (Bamps!Delivery) и включить на него меню, которое должно быть доступно по этой интеграции. API-ключи, созданные для интеграции с другими сервисами использовать для интеграции с мобильным приложением не нужно!

2. ID терминала в iiko, на который должны приходить заказы. Если у вас несколько терминалов, то нужно сообщить их все. В случае нескольких терминалов понадобится подключение в Bamps!Delivery дополнительных филиалов или сервиса "Зоны доставки" (в зависимости от ситуации).

3. ID вашей организации в iiko.

Дополнительно вам необходимо сделать следующие действия в iiko:

4. Если у вас есть платная доставка, то вам необходимо создать в iiko папку "Доставка" и также внутри нее создать блюдо "Доставка" со стоимостью платной доставки. Если в мобильном приложении планируете использовать зоны доставки и в каждой зоне у вас разная стоимость доставки, то нужно создать в папке "Доставка" несколько продуктов с соответствующими стоимостями.

5. Создать в iiko все типы оплат, которые у вас будут применяться (наличными, картой курьеру, картой в приложении).

6. Корректно создайте ваше меню в iiko. Обязательно загрузите фотографии ваших блюд в iiko. Если у вас используются модификаторы блюд, то вы также на них можете загрузить фотографии, они отобразятся в мобильном приложении. В случае, если используются модификаторы единичного выбора (размер пиццы, начинка в шаурме, тип гарнира в WOK и т.п.), то нужно иметь в виду, что они добавляют стоимость к основному блюду. Основное блюдо у вас может быть со стоимостью = 0 руб. Модификаторы в этом случае добавят стоимость. В мобильном приложении цена блюда будет установлена от XXX руб = стоимости модификатора с наименьшей ценой
ВНИМАНИЕ! Модификаторы и группы модификаторов у вас должны быть корректно связаны с блюдом в iiko. Если в iiko связь установлена некорректно, то и в мобильном приложении будет также.


Подключение интеграции с iiko

ВНИМАНИЕ! Интеграцию крайне желательно подключать в утреннее нерабочее время вашего заведения, потому что на некоторое время придется выключить его из работы. Интеграцию не следует подключать в пиковые дни (пятница - воскресенье).

Менеджер "Фабрики Приложений" прописывает в системе параметры, которые вы ему сообщили. Далее в личном кабинете Bamps вам необходимо:

1. Создать Категории продукции. Если у вас они уже ранее были созданы и в них есть блюда, вы можете попросить менеджера массово очистить все Каталоги.

2. Связать Категории в Bamps с категориями из iiko. Для этого вам необходимо в разделе Контент - Каталог - нажать кнопку "Категории". После ее нажатия происходит загрузка списка папок из iiko в систему Bamps.
Затем в настройке каждой категории необходимо связать ее с папкой из iiko. В Bamps есть возможность к одной категории привязать сразу несколько категорий iiko. При связывании папок "Доставка" в ЛК Bamps необходимо установить галочку в настройках категории "Не показывать в приложении/сайте".
3. Загрузить продукцию из iiko. Для этого вам необходимо в разделе Контент - Каталог - нажать кнопку "Продукция". После ее нажатия происходит загрузка продукции из iiko в связанные папки в Bamps.
4. Настроить работу с бонусами.

Если будет использоваться бонусная система Bamps, то необходимо при обработке заказа в iiko уменьшать его стоимость на сумму списанных бонусов Гостем. Сообщите менеджеру, какой вариант вы будете использовать:
1. Ручное списание бонусов оператором. В комментарии к заказу в Iiko оператор увидит сумму списанных бонусов и сможет применить скидку в рублях к заказу в Iiko. Для этого потребуется настройка этой скидки со стороны поддержки iiko.
2. Автоматическое уменьшение суммы заказа на сумму бонусов. Данная настройка проставляется менеджером Фабрики Приложений.

Если будет использоваться бонусная система iiko Card - просто сообщите об этом менеджеру. При таком варианте бонусная система в приложении деактивируется. Гость будет видеть бонусный баланс из системы iiko и будет списывать бонусы из iiko.
Поздравляем, интеграция настроена! Теперь необходимо обязательно протестировать ее путем отправки заказов в приложении. При поступлении в личный кабинет заказ автоматически будет приходить на терминал iiko.
ВНИМАНИЕ! Теперь управление заказами происходит только в iiko (изменение статуса заказа, добавление / удаление блюд в заказе, изменение времени доставки и т.д.). Наша система реагирует при этом только на изменение статуса заказа.
Текущие вопросы по работе интеграции iiko
Если Вы не нашли ответ на свой вопрос, напишите на manager@bamps.online