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

Подготовка к интеграции с iiko

Интеграция с системой iiko осуществляется по API Transport. Для этого у вас должен быть подключен iiko Cloud. С нашей стороны запрос номенклатуры из iiko осуществляется методом https://api-ru.iiko.services/#tag/Menu/paths/~1api~11~1nomenclature/post. Список папок (категорий) iiko извлекается нашей системой из массива "groups". Массив "productCategories" не используется для извлечения папок (категорий).

Для подготовки интеграции 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 стоимость каждого блюда будет уменьшена на сумму списанных бонусов Гостем. Например заказ на 1000 р. (пицца 700 р. и ролл 300 р. ). Гость списал 200 бонусов. В iiko придет заказа, в заказе стоимость блюд будет следующая: пицца 560 р., ролл 240 р. Таким образом сумма бонусов вычитается из блюд пропорционально их сумме в заказе.
ВНИМАНИЕ! Для использования 2-го варианта необходимо отключить округление на стороне iiko.

Подготовка к интеграции с frontpad

При поступлении заказа из мобильного приложения или сайта в ЛК Bamps заказ автоматически отправляется в систему Frontpad. При этом стыковка товаров производится по артикулам.

Для подготовки интеграции Frontpad с Bamps необходимо:

1. Включить интеграцию во Frontpad. В личном кабинете Frontpad заходим в Настройки - Общие - API (подключение интернет-магазина) - Кнопка Настроить. Ставим галочку "Включен". Копируем текст из поля "Секрет" и направляем его менеджеру Фабрики Приложений. В поле Webhook url прописываем https://my.bamps.online/api/v2/integration/frontpad/hook
И обязательно сохраняем настройки.
Если у вас раздел API (подключение интернет-магазина) не активен, вам нужно обратиться в поддержку Frontpad, чтобы его активировали.

2. Сообщить коды статусов заказов. Заходим в Справочники - Статусы. Делаем скриншот и присылаем его менеджеру Фабрики Приложений. Это нужно для того, чтобы при изменении статуса заказа во Frontpad он автоматически менял статус в Bamps.

3. Сообщить "Варианты оплаты". Заходим в Справочники - Варианты оплаты. Делаем скриншот и присылаем его менеджеру Фабрики Приложений. Это нужно для того, чтобы во входящих заказах из Bamps в вашем Frontpad отображался корректный вид оплаты.

4. Прописать артикулы на всех товарах. Заходим в Справочники - Товары. Проходимся по всем товарам и в поле "Артикул" заполняем уникальный артикулы на всех товарах. Лучше всего использовать только цифры, например 001, 002, 003 и т.д.
ВНИМАНИЕ! Артикулы не должны пересекаться. У каждого товара Артикул должен быть уникальным.

5. Создать товар доставки. Если у вас есть платная доставка, то вам необходимо во Frontpad сделать отдельную папку (например, с названием "Доставка") и создать в ней товар доставки с соответствующей стоимостью. На данном товаре также прописываем Артикул.

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

В личном кабинете Bamps вам необходимо:

1. Прописать Артикулы. На всех товарах прописываем Артикулы точно также, как они указаны у вас во Frontpad. Лучше всего скопировать их напрямую из Frontpad, чтобы не ошибиться. Если у вас используются модификаторы (это могут быть выбор размера пиццы, конструктор блюда, или добавки к блюду), то в ЛК Bamps вам также необходимо прописать Артикулы и на модификаторах. При этом во Frontpad модификаторами являются по сути обычные товары, которые связываются с основным товарам и являются для него модификаторами, но в самой системе Frontpad технически это обычные товары.

2. Сделать тестовый заказ. После указания всех Артикулов в ЛК Bamps вам необходимо сообщить менеджеру Фабрики Приложений о том, что нужно включить интеграцию с Frontpad. Крайне желательно это делать в утреннее время с понедельника по четверг. После включения интеграции необходимо направить несколько тестовых заказов во Frontpad с разными типами оплаты, с разными товарами, с оплатой бонусами и без оплаты бонусами. Таким образом смоделировав реальные ситуации.