🎯 Структура технической поддержки🔗
⏱ В каком случае дилеру может понадобиться подключиться к поддержке🔗
Ключевое 📌
- Служба поддержки RBCN работает ежедневно с 9:00 до 21:00 (по Москве).
- Для решения любой проблемы нам необходим лог. Чтобы мы могли его найти, нужны:
- номер телефона пользователя, у которого возникла ошибка;
- событие не старше 30 дней.
Как настроить взаимодействие в Pyrus расписано тут 👉 Взаимодействие
Важно: продукты RBCN работают автономно ⚠️
‼️ Мы не просим дилеров ничего настраивать или проверять в наших админках — всё это мы делаем сами.
🛠 Когда всё-таки может понадобиться помощь дилера?🔗
📦 Проблема с заказом🔗
(не дошёл до iikoFront / не отправился)
Лайвхак💡
Можно настроить бота iiko с оповещениями
📘 Канал событий — Интеграция с сервисами доставки
🔍 Как расшифровывать тексты ошибок и что с ними делать мы расписали тут 👉 💀 Типовые ошибки и как их фиксить
⚙️ Вопрос по настройке в iiko, влияющий на работу через API🔗
(например, холдирование баллов)
- Обычно это просто «поставить нужную галочку».
- Самые частые настройки и нюансы по этой ссылке 👉 💡 Список полезных ссылок по настройкам iiko
👤 Проблема с гостем🔗
(не отображается / не ищется в iikoFront)
- Нам всегда нужен лог, чтобы разобраться.
- Чтобы вытащить лог, нужен конкретный пример пользователя и его номер телефона.
🔄 Вопросы по возможностям API🔗
- Такие вопросы всегда приходят от нас, через клиента.
- У нас нет прямого канала связи с iiko для таких запросов — поэтому мы передаём их через клиента и дилера.
В 99% случаев клиент сначала обращается напрямую в поддержку RBCN 📌
Мы:
- либо решаем проблему сами,
- либо выдаём инструкцию по настройке в iiko,
- либо формируем лог и просим клиента обратиться к дилеру — уже с готовыми данными.
📚 Каталог услуг и типовых обращений🔗
Ниже — примеры типовых ситуаций, с которыми может обратиться клиент, и пошаговые действия с нашей и вашей стороны.
Также указано, за какой частью отвечает дилер, а за какой — RBCN.
🚨 Инцидент — Блокирующий🔗
❌ Не уходит заказ🔗
Модуль: iikoTransport
-
Если клиент уже прислал логи → проверить причину (см. библиотеку частых ошибок 💀 Типовые ошибки и как их фиксить)
→ ответственный: дилер
-
Если клиент обратился напрямую
→ запросить номер телефона и логи у поддержки RBCN
→ проверка логов
→ ответственные: RBCN + дилер
🎁 Не срабатывает акция🔗
Модуль: iikoCard
-
Если клиент уже прислал логи → анализируем, почему акция не сработала (в логах по запросу можем предоставить trace)
→ ответственный: дилер
-
Если клиент обратился напрямую
→ запросить номер телефона и логи у поддержки RBCN
→ проверка логов
→ ответственные: RBCN + дилер
🔍 Не ищется гость🔗
Модуль: iikoCard
-
Если клиент уже прислал логи
→ смотрим, почему не создался (обычно причина — обмен POS-сервера и iikoBiz)
→ ответственный: дилер -
Если клиент обратился напрямую
→ запросить номер телефона и логи у поддержки RBCN
→ проверка логов
→ ответственные: RBCN + дилер
⚠️ Инцидент — Неблокирующий🔗
🧾 Не выгружается обновление меню🔗
Модули: iikoTransport / iikoChain / iikoOffice
-
Если клиент пришёл по нашей рекомендации:
- проверяем настройки выгрузки 📦 Выгрузка меню
- проверяем обмены 🔄 Как запускать обмены
→ ответственный: дилер
-
Если клиент пришёл самостоятельно:
- те же действия, что выше
→ ответственные: RBCN + дилер
🛠 Запрос на обслуживание🔗
🔑 Настроить API-ключ🔗
Модуль: iikoTransport
→ Инструкция 🔑 Создание и настройка API ключа
→ ответственный: дилер
🍔 Настроить выгрузку меню🔗
Модуль: iikoTransport / iikoChain / iikoOffice
Чаще всего клиент настраивает сам, но можно помочь инструкцией
→ Инструкция 📦 Выгрузка меню
→ ответственный: дилер
🧩 Настроить терминальные группы🔗
Модуль: iikoTransport
→ Инструкция 🖥 Добавление терминальных групп к ключу
→ ответственный: дилер
💳 Настроить типы оплат🔗
Модуль: iikoTransport / iikoChain / iikoOffice
→ Инструкция 💰 Типы оплат
→ ответственный: дилер
🧾 Настроить типы заказов🔗
Модуль: iikoTransport / iikoChain / iikoOffice
→ Инструкция 🛍 Типы заказов
→ ответственный: дилер
🧱 Настроить дополнительные модули🔗
Модуль: iikoTransport / iikoChain / iikoOffice
→ Большинство описаны тут: 💡 Список полезных ссылок по настройкам iiko
→ ответственный: дилер
🧍 Настроить модуль «Чекин»🔗
Модуль: iikoCard
→ Инструкция 🧾 Чекин гостя в заказ
→ ответственный: дилер
❓ Консультация🔗
Если нужно обсудить что-то, что не попадает в рамки шаблонных кейсов — просто отправьте запрос в нашу поддержку.
📩 Работать будем вместе — подключим нужных специалистов с обеих сторон.
Время реакции RBCN ⏱️
- Первый ответ с нашей стороны — в течение 10 минут.
- Для решения задачи нам нужно получить обратную связь от дилера.
- После этого — в течение 1 часа принимаем решение и действуем.
🎯 Технические особенности и поддержка по регионам🔗
1️⃣ Продукты RBCN🔗
🟡 Мобильное приложение🔗
Приложение доступно для смартфонов под управлением iOS и Android
Совместимость:
• iOS 15.0 или новее
• Android 7.0 или новее
🟢 Сайт🔗
Сайт доступен из любого браузера (предпочтительно Chrome / Safari) на смартфонах, планшетах и ПК
🔵 VK приложение🔗
VK приложение доступно на смартфонах, планшетах, ПК
VK приложение RBCN запускается внутри веб-платформы https://vk.com/ или приложения https://vk.com/mobile
🟣 TG приложение🔗
TG приложение доступно на смартфонах, планшетах, ПК
TG приложение RBCN запускается внутри веб-платформы https://web.telegram.org/ или приложения https://telegram.org/apps
⚪️ QR меню🔗
QR меню доступно из любого браузера (предпочтительно Chrome / Safari) на смартфонах, планшетах и ПК
Важно ⚠️
Для стабильной работы всех продуктов RBCN обязательно наличие устойчивого интернет-соединения
2️⃣ Требования к IIKO🔗
Рекомендуемая версия iiko: 8.5 или выше
Минимальная версия iiko: 8.3
Регион: любой, где у RBCN поддерживается локализация
Для стабильной работы всех продуктов RBCN = поступления заказов в iikoFront (кроме QR меню) обязательно наличие устойчивого интернет-соединения на стороне iiko.biz и iikoFront
Некоторые функции доступны только на версиях выше, о чем мы сами сообщим клиенту
Лицензии🔗
Набор лицензий зависит от подключаемого продукта RBCN, а также формата подключения ⚠️
Мобильное приложение🔗
Лицензия запуска Rubeacon Brand, которая оплачивается один раз для старта работ по настройке приложения
Блок — Чекин гостя в заказ🔗
- Rubeacon (базовая лицензия за 1 фронт)
Для заведений с несколькими RMS базовая лицензия должна быть добавлена в каждый RMS - Rubeacon +1 (ежемесячная плата за подключение 1 доп. кассы)
- Rubeacon +3 (ежемесячная плата за подключение 3 доп. касс)
- Rubeacon +10 (ежемесячная плата за подключение 10 доп. касс)
Блок — Отправка заказа🔗
Вариант 1
- Rubeacon Delivery+Takeaway 1-3 (ежемесячная плата за подключение первых трех терминалов доставки)
=> рассчитывается от количества терминалов доставки, куда может прийти заказ - Rubeacon Delivery+Takeaway +1 (ежемесячная плата за подключение 1 доп. терминала доставки)
- Rubeacon Delivery+Takeaway +3 (ежемесячная плата за подключение 3 доп. терминалов доставки)
Вариант 2
- iikoVendorKit for Rubeacon — лицензия коннектор, которая должна быть добавлена на каждый подключаемый RMS
Подробнее о возможных сценариях оплаты ℹ️
Расписали тут 💲 Стоимость решений RBCN
Сайт / VK приложение / TG приложение / QR меню🔗
- iikoVendorKit for Rubeacon — лицензия коннектор, которая должна быть добавлена на каждый подключаемый RMS
Все продукты RBCN с функцией отправки заказа или выгрузки меню (Мобильное приложение с блоком Отправка заказа / Сайт / VK приложение / TG приложение / QR меню) используется CloudApi ⚠️
Если подключается lifetime клиент, ему необходимо докупить лицензию iikoCloud Api на каждый RMS, куда будут отправляться заказы / откуда будет выгружаться меню
🔄 Информация об используемом API🔗
(🧩Все базовые настройки в iiko - 🟠 Предназначение продукта)
🔹 Блок Отправка заказа🔗
- используется iikoCloud API
-
Взаимодействие
- Авторизация любых запросов: https://api-ru.iiko.services/docs#tag/Authorization
- Проверка доступности терминалов: https://api-ru.iiko.services/docs#tag/Terminal-groups/paths/~1api~11~1terminal_groups~1is_alive/post
- Проверка остатков на точке перед созданием заказа: https://api-ru.iiko.services/docs#tag/Menu/paths/~1api~11~1stop_lists~1check/post
- Проверка статуса той или иной команды: https://api-ru.iiko.services/docs#tag/Operations
-
Получение информации для начала работы
- Список доступных по ключу организаций: https://api-ru.iiko.services/docs#tag/Organizations
- Список подключенных терминальных групп: https://api-ru.iiko.services/docs#tag/Terminal-groups/paths/~1api~11~1terminal_groups/post
- Список типов заказа: https://api-ru.iiko.services/docs#tag/Dictionaries/paths/~1api~11~1deliveries~1order_types/post
- Список типов оплат: https://api-ru.iiko.services/docs#tag/Dictionaries/paths/~1api~11~1payment_types/post
- Список маркетинговых источников: https://api-ru.iiko.services/docs#tag/Marketing-sources
- Список настроенных акций в iikoCard: https://api-ru.iiko.services/docs#tag/Discounts-and-promotions/paths/~1api~11~1loyalty~1iiko~1program/post
- Список ручных скидок (в случае подключения движка лояльности RBCN): https://api-ru.iiko.services/docs#tag/Dictionaries/paths/~1api~11~1discounts/post
- Список причин отмены (для отмены заказа пользователем): https://api-ru.iiko.services/docs#tag/Dictionaries/paths/~1api~11~1cancel_causes/post
- Справочники адресов (если клиент не использует flexible адреса): https://api-ru.iiko.services/docs#tag/Addresses
Эти методы, мы не дергаем с какой-либо заданной периодичностью, используем для стартовых настроек и далее по запросу от клиента 💡
-
Выгрузка меню
- Меню по базовому прейскуранту из iikoBackOffice: https://api-ru.iiko.services/docs#tag/Menu/paths/~1api~11~1nomenclature/post
- Список настроек внешнего меню: https://api-ru.iiko.services/docs#tag/Menu/paths/~1api~12~1menu/post
- Внешнее меню: https://api-ru.iiko.services/docs#tag/Menu/paths/~1api~12~1menu~1by_id/post
-
Расчет акций для заказа
-
Блок: https://api-ru.iiko.services/docs#tag/Discounts-and-promotions
- Расчет акций для заказа: https://api-ru.iiko.services/docs#tag/Discounts-and-promotions/paths/~1api~11~1loyalty~1iiko~1calculate/post
Остальные методы, описанные в блоке Discounts and promotions НЕ используются 📌
-
-
Черновики заказов
-
Блок: https://api-ru.iiko.services/docs#tag/Drafts
- Создание черновика заказа: https://api-ru.iiko.services/docs#tag/Drafts/paths/~1api~11~1deliveries~1drafts~1create/post
Остальные методы, описанные в блоке Drafts НЕ используются 📌
-
-
Отправка заказа на доставку / самовывоз + история заказа на доставку / самовывоз
-
Блок: https://api-ru.iiko.services/docs#tag/Deliveries:-Create-and-update
- Создание заказа: https://api-ru.iiko.services/docs#tag/Deliveries:-Create-and-update/paths/~1api~11~1deliveries~1create/post
- Отправка проблемы в заказ: https://api-ru.iiko.services/docs#tag/Deliveries:-Create-and-update/paths/~1api~11~1deliveries~1update_order_problem/post
- Отмена заказа: https://api-ru.iiko.services/docs#tag/Deliveries:-Create-and-update/paths/~1api~11~1deliveries~1cancel/post
Остальные методы, описанные в блоке Deliveries: Create and update НЕ используются 📌
-
Блок: https://api-ru.iiko.services/docs#tag/Deliveries:-Retrieve
- Запрос истории конкретного заказа на доставку / самовывоз: https://api-ru.iiko.services/docs#tag/Deliveries:-Retrieve/paths/~1api~11~1deliveries~1by_id/post
Остальные методы, описанные в блоке Deliveries: Retrieve НЕ используются 📌
-
-
Отправка заказа на стол + история заказа на стол
-
Блок: https://api-ru.iiko.services/docs#tag/Orders
- Создание заказа на стол: https://api-ru.iiko.services/docs#tag/Orders/paths/~1api~11~1order~1create/post
- Запрос истории конкретного заказа на стол: https://api-ru.iiko.services/docs#tag/Orders/paths/~1api~11~1order~1by_id/post
Остальные методы, описанные в блоке Orders НЕ используются 📌
-
-
Web-hooks
- Обновление стоп-листов: https://api-ru.iiko.services/docs#tag/Menu/paths/iikoTransport.PublicApi.Contracts.WebHooks.StopListUpdateWebHookEventInfo/post
- Обновления по заказам доставка / самовывоз: https://api-ru.iiko.services/docs#tag/Deliveries:-Create-and-update/paths/iikoTransport.PublicApi.Contracts.WebHooks.DeliveryOrderUpdateWebHookEventInfo/post
-
Обновления по заказам на стол: https://api-ru.iiko.services/docs#tag/Orders/paths/iikoTransport.PublicApi.Contracts.WebHooks.TableOrderUpdateWebHookEventInfo/post
-
Блок: https://api-ru.iiko.services/docs#tag/Webhooks
- Настройка вебхука для организации: https://api-ru.iiko.services/docs#tag/Webhooks/paths/~1api~11~1webhooks~1update_settings/post
- Обновления по заказам доставка / самовывоз: https://api-ru.iiko.services/docs#tag/Webhooks/paths/iikoTransport.PublicApi.Contracts.WebHooks.DeliveryOrderUpdateWebHookEventInfo/post
- Обновления по заказам на стол: https://api-ru.iiko.services/docs#tag/Webhooks/paths/iikoTransport.PublicApi.Contracts.WebHooks.TableOrderUpdateWebHookEventInfo/post
- Обновление стоп-листов: https://api-ru.iiko.services/docs#tag/Webhooks/paths/iikoTransport.PublicApi.Contracts.WebHooks.StopListUpdateWebHookEventInfo/post
Остальные webhooks, описанные в блоке Webhooks НЕ используются 📌
-
Гости
-
Блок: https://api-ru.iiko.services/docs#tag/Customer-categories
- используются все запросы блока
-
Блок: https://api-ru.iiko.services/docs#tag/Customers
- Получение гостя: https://api-ru.iiko.services/docs#tag/Customers/paths/~1api~11~1loyalty~1iiko~1customer~1info/post
- Создание или обновление гостя: https://api-ru.iiko.services/docs#tag/Customers/paths/~1api~11~1loyalty~1iiko~1customer~1create_or_update/post
- Холдирование баллов после отправки заказа: https://api-ru.iiko.services/docs#tag/Customers/paths/~1api~11~1loyalty~1iiko~1customer~1wallet~1hold/post
- Отмена холдирования баллов при отмене заказа: https://api-ru.iiko.services/docs#tag/Customers/paths/~1api~11~1loyalty~1iiko~1customer~1wallet~1cancel_hold/post
- Пополнение баланса гостя: https://api-ru.iiko.services/docs#tag/Customers/paths/~1api~11~1loyalty~1iiko~1customer~1wallet~1topup/post
Остальные методы, описанные в блоке Customers НЕ используются 📌
-
-
Не используемые методы
- Нотификации: https://api-ru.iiko.services/docs#tag/Notifications
- Разбудить терминал: https://api-ru.iiko.services/docs#tag/Terminal-groups/paths/~1api~11~1terminal_groups~1awake/post
- Справочники:
- Редактирование стоп-листов:
- https://api-ru.iiko.services/docs#tag/Menu/paths/~1api~11~1stop_lists/post
- https://api-ru.iiko.services/docs#tag/Menu/paths/~1api~11~1stop_lists~1add/post
- https://api-ru.iiko.services/docs#tag/Menu/paths/~1api~11~1stop_lists~1remove/post
- https://api-ru.iiko.services/docs#tag/Menu/paths/~1api~11~1stop_lists~1clear/post
- Комбо:
- Сотрудники: https://api-ru.iiko.services/docs#tag/Employees
- Ограничения по доставочным заказам: https://api-ru.iiko.services/docs#tag/Delivery-restrictions
- Банкеты и резервы: https://api-ru.iiko.services/docs#tag/Banquetsreserves
- Инициация отправки сообщений гостям: https://api-ru.iiko.services/docs#tag/Messages
- Отчеты: https://api-ru.iiko.services/docs#tag/Report
🔹 Блок Чекин гостя в заказ🔗
-
используется iikoCloud API
-
Взаимодействие
- Авторизация любых запросов: https://api-ru.iiko.services/docs#tag/Authorization
-
Получение информации для начала работы
- Список доступных по ключу организаций: https://api-ru.iiko.services/docs#tag/Organizations
- Список настроенных акций в iikoCard: https://api-ru.iiko.services/docs#tag/Discounts-and-promotions/paths/~1api~11~1loyalty~1iiko~1program/post
Эти методы, мы не дергаем с какой-либо заданной периодичностью, используем для стартовых настроек и далее по запросу от клиента 💡
-
Гости
-
Блок: https://api-ru.iiko.services/docs#tag/Customers
- Получение гостя: https://api-ru.iiko.services/docs#tag/Customers/paths/~1api~11~1loyalty~1iiko~1customer~1info/post
- Создание или обновление гостя: https://api-ru.iiko.services/docs#tag/Customers/paths/~1api~11~1loyalty~1iiko~1customer~1create_or_update/post
Остальные методы, описанные в блоке Customers НЕ используются 📌
-
Остальные методы, описанные в iikoCardApi НЕ используются ⚠️
🔹 iikoCard WebHooks🔗
Дополнительно есть возможность подключать пуши из iiko через WebHook, что описано тут 👉
🔔 Настройка iiko.biz webhook для отправки PUSH-уведомлений
🧠 Реализация интеграционного решения и архитектура🔗
⚪️ Взаимодействие с компонентами iiko🔗
-
Взаимодействие с другими плагинами iiko
Не осуществляется — внешние плагины iiko не используются.
-
Взаимодействие с кассами
Через iikoCloud API отправляем заказ на главную кассу терминальной группы. Также происходит поиск гостя в iikoFront на любой кассе — через сканирование QR-кода гостя.
-
Взаимодействие с оборудованием (в том числе порты)
Не требуется. Единственное техническое условие — стабильное интернет-соединение на iikoFront.
-
Взаимодействие RMS с Chain
Через модули iikoTransport / iikoCloud API.
-
Доступ к базам данных и конфигурационным файлам
Взаимодействие осуществляется через iikoTransport / iikoCloud API.
Прямого доступа к базам данных iiko нет. -
Совместимость с ЕГАИС, Честным Знаком и иными регуляторными сервисами
Не требуется.
Со стороны решения заказ формируется в корректном формате, соответствующем требованиям iiko для последующего взаимодействия с регуляторными сервисами. -
Совместимость с 32/64-битными приложениями
Не актуально. Решение работает через API и не зависит от разрядности установленного ПО iiko.
-
Средняя и пиковая нагрузка (входящие/исходящие запросы по модулям iiko)
⏳ Данные будут предоставлены позднее.
🛠 Взаимодействие с другими решениями и технологиями🔗
-
Используемые технологии
- iOS: Swift
- Android: Kotlin
- Backend: Python
- Web / VK Mini Apps / Telegram: Vue.js
-
Используемые протоколы и требования к безопасности
Все соединения и API-запросы выполняются с использованием TLS версии 1.2.
