Интеграция IIKO

Подготовка меню в кабинете IIKO:

На iiko web настройте iiko transport, выпустите токен меню и токен категорий. Убедитесь, что все настройки верные, у вас есть сформированное внешнее меню с товарами.

Инструкция настройки CloudApi в вашем лк: https://ru.iiko.help/articles/#!iikoweb/iikocloudapi

Инструкция по настройке внешнего меню тут: https://ru.iiko.help/articles/#!iikoweb/external-menu

сформируйте меню в разделе выгрузка меню с верными категориями и модификаторами.

Настройка Интеграции IIKO в кабинете DIgarson:

Чтобы начать настройку, перейдите в раздел “Интеграция IIKO” в Общих настройках.

Для начала вам нужно подключить профиль меню для выгрузки товаров и категорий, далее отдельно подключаются и настраиваются профили заказов. Так можно загружать меню из одного лк, а заказы отправлялись в другой.

Перейдите в таб “Меню”, и нажмите “Добавить профиль”. Введите Login для загрузки меню из IIKO это ключ от соответствующего стенда. Выберите предприятие для загрузки меню.

Далее выберите группу блюд, которую выводить в меню компании. Эта главная группа или корневая категория в которой лежат все остальные категории меню. Она на витрине отображаться не будет. Далее создайте в каталоге пустую категорию для загрузки туда меню из IIKO в Digarson. Она будет выступать такой же корневой и отображаться не будет. Выберите нужную группу и эту категорию Digarson для загрузки.

Дайте название этому профилю меню и включите его. Нажмите сохранить.

Далее настройте терминальную группу, куда будут уходить заказы официантам. Чтобы подключить профиль заказов перейдите в таб “Заказы”, и нажмите “Добавить профиль”. Введите Login для отправки заказов в IIKO. Login это ключ от соответствующего стенда. Нажмите “Получить список предприятий”. Выберите предприятие для отправки заказов в IIKO.

Сопоставьте связь терминальных групп в IIKO и торговых точек в Digarson.

Сопоставьте связь типов оплаты в IIKO и типов оплаты в Digarson. Например: Наличные – На месте; Безналичные сайт – Онлайн оплата.

Сопоставьте связь типов заказа в IIKO и типов заказа в Digarson. Например: Доставка самовывоз – Самовывоз; Обычный заказ – QR-меню.

Сопоставьте связь статусов заказа в IIKO и статусов заказа в Digarson для каждого типа заказа в вашем заведении. Например: Отменен, Удален – Отменен | Доставка; Отменен, Удален – Отменен | QR-меню;

Далее укажите При каком статусе отправлять заказ в IIKO. Сопоставьте статус и тип заказа.

Укажите Название профиля интеграции. Укажите Email для отправки чека.

Включите нужные вам свитчеры Интеграции IIKO:

1) Автозакрытие (с указанием Количества минут до закрытия и Исключением товаров из автозакрытия). Включите автоматическое закрытие заказа, если хотите чтобы заказы внутри ресторана в пост системе IIKO закрывались самостоятельно (если в них нет ошибки и они полностью оплачены онлайн). При включении не забудьте указать через какое время нужно закрывать заказ. Мы рекомендуем указывать час.

2) Печать бумажного чека заказа,

3) Отправка платежа как фискальная предоплата (isPrepay), то есть если онлайн оплата то в айко оформится как проведенная предоплата и напечатается фискальный чек

4) Фискализация на облачной кассе (isFiscalizedExternally),

5) Платеж фискализируется на ФР IIKO Front (isProcessedExternally).

Не забудьте включить профиль заказов и сохранить настройки.

Запуск загрузки меню для Интеграции IIKO

Далее перейдите в таб “Меню” и в столбце “Действия” нажмите значок загрузки меню 🔁.

Включите нужные свитчеры и загрузите товары нажав “Начать синхронизацию”.

Примерно через 7 минут все товары и модификаторы будут подгружены в систему.

С включенной интеграцией редактирование и добавление товаров и модификаторов в лк Digarson запрещен. Иначе интеграция не пройдет, так как таких товаров нет в IIKO. Все меню подгружается только с IIKO. Все изменения нужно вносить в нем и заново запускать подгрузку интеграции.

Чтобы отключить отображение ненужных групп модификаторов, выключите эти группы в Digarson. Они не будут отображаться на витрине.

Информация о загрузках и заказах Интеграции IIKO

В табе “История синхронизаций” вы можете увидите все подгрузки и их статусы.

Если вы нажмете на статус каждой из синхронизаций, то увидите пояснение.

В табе “История заказов” вы можете увидите все заказы, оформленные в компании с включенной интеграцией. А также посмотреть статусы этих заказов по отправке в айко. Если статус “ошибка”, то при нажатии на этот статус вы увидите в чем конкретно была ошибка.

Товары на стоп ставятся в IIKO и передаются в стоп-лист Digarson. Нерабочие блюда, удаленные через приказ в IIKO offis выгружаются с ценой ноль и параметром временно нет на витрине. Такие товары нельзя будет купить. Лучше просто верно формировать меню в IIKO для выгрузки без таких нерабочих блюд.

https://willtaste.dgsn.app/backend/api/iiko/webhook/handler пример ссылки для настройки вебхуков. замените в ссылке свой адрес и вставьте в настройки cloudapi

ключевые слова: iiko, айко