Подключение интеграции в личном кабинете
Начнём с настроек iikoOffice. Откройте раздел Обмен данными → iiko.Biz → Состояние подключения
- Убедитесь, что все проверки доступны и горят зелёным цветом:
- Если Вы это делаете в первый раз, программа предложит зарегистрироваться: в этом случае введите ФИО, название предприятия и всё что необходимо и зарегистрируйтесь на сайте.
- Войдите в свой аккаунт на iiko.biz, выберите в меню Приложения → Список.
- Вам потребуется подключить приложение API iikoDelivery - найдите его в списке приложений, выберите и нажмите Подключить
- Пароль и логин, которые Вы ввели при подключении API iikoDelivery необходимо
запомнить, именно они нам понадобятся при настройках импорта.
- Опять откройте iikoOffice
- Выберите пункт меню Доставка → Терминалы доставки - это список точек на которые будут поступать заказы.
- В списке должен быть хотя бы один зарегистрированный терминал. Выберите и нажмите Зарегистрировать, если таких нет.
- Перейдите в раздел Обмен данными → iiko.Biz → Выгрузка меню
- Заполните Меню для выгрузки - тут отображается меню сайта по категориям
- Чтобы добавить новую категорию нажмите Добавить группу... введите название и нажмите Сохранить
- Чтобы добавить в категорию товары в верхней таблице выберите группу, а в нижней выбирайте элементы нажимая Shift или Ctrl, затем нажмите Добавить выбранные товары
- Вместе с выгружаемыми блюдами необходимо создать папку для модификаторов и добавить в неё модификаторы для этих блюд. - Как только меню для выгрузки сформировано, нажмите Выгрузить
- Зайдите в личный кабинет FoodSoul Интеграции → Автоматизация
- Поставьте галочку iikoDelivery и заполните поля в настройках:
Пользователь: логин пользователя в API iikoDelivery
Пароль: пароль пользователя в API iikoDelivery
Организация: название Вашей организации как оно указано в аккаунте
Не путайте эти доступы с доступами для входа в личный кабинет iiko.bizна деле подключение API происходит не сразу, возможно придётся подождать некоторое время, чтобы всё заработало и выгрузка прошла успешно
- Нажмите Сохранить
- Если всё правильно, список товаров должен выгрузиться в личный кабинет.
- Номенклатура из айко будет автоматически выгружаться в личный кабинет раз в сутки. При синхронизации меню будет полностью заменено, это нужно учитывать при редактировании.
- Заказы, оформленные через сайт или приложение, будут поступать в Айко.
Далее указаны дополнительные настройки для iiko Delivery, чтобы Вы могли полноценно интегрировать наши системы.
Подробнее о том как подключить API Вы можете узнать по этой ссылке
Принудительное обновление меню
Ссылка Принудительный запуск импорта данных позволяет принудительно обновить меню в личном кабинете с серверов айко.
Фильтр товаров по названию категории
В поле Фильтр товаров по названию категории укажите название Категории для элементов номенклатуры (вкладка Дополнительная информация в настройках товара Айко)
Товары будут импортироваться только из этой категории.
Фильтр товаров по имени группы
В поле Фильтр по имени группы укажите название группы из меню для выгрузки Айко (Обмен данными → iiko.Biz → Выгрузка меню)
Товары будут импортироваться только из этой группы и из её подгрупп.
Фильтр товаров и цен по имени терминала(прайс-лист)
Айко позволяет создать Приказ об изменении прейскуранта, при этом может изменяться стоимость товаров или они могут сниматься с продажи на определённых точках
Эта опция позволяет, к примеру, разделить одно меню между несколькими филиалами с учётом цен на товары и модификаторы или выгрузить в личный кабинет только часть позиций.
В поле Фильтр цен по имени терминала укажите Название терминала Айко, который назначен соответствующему торговому отделению.
- В личный кабинет будут выгружены товары и модификаторы с ценами из прайс-листа назначенного для этого терминала.
- Не будут выгружены модификаторы и товары снятые с продажи на выбранном терминале.
- На один филиал в личном кабинете можно указать только один терминал.
Например:
- Вы хотите сделать категорию "Хот-доги mini" доступной только в филиале Краснодар
- Создайте для неё новый приказ
Оставьте галочки только для точки Краснодар и сохраните, чтобы приказ вступил в действие.
Важный момент: при создании приказа необходимо выбрать все точки, чтобы они были подсвечены черным цветом иначе приказ на них не подействует
- Сделайте выгрузку ( Обмен данными - iiko.biz - Выгрузка меню )
- Откройте в личном кабинете FoodSoul филиал Краснодар
- В поле Фильтр цен по имени терминала укажите Название терминала для точки Краснодар.
- После обновления меню во всех филиалах кроме города Краснодар товары из категории "Хот-доги mini" не будет отображаться.
Сохранение изображений товаров
В поле Обновлять изображения, только при отсутствии загруженных поставьте галочку Да, чтобы была возможность загружать картинки товаров в личный кабинет. При обновлении меню из Айко они будут сохранены.
Выгрузка параметров товара и модификаторов
Все схемы модификаторов товара из айко импортируются в соответствующие разделы в личном кабинете:
Номенклатура - Группы модификаторов Номенклатура - Модификаторы |
---|
- Для того, чтобы выгрузить товар с выбором параметра у группы модификаторов необходимо указать в свойствах максимальное количество 1, минимальное количество 1 и поставить галочку "обязательный выбор".
По умолчанию все группы модификаторов с такими настройками выгружаются как параметры товара
Вы можете отменить это поведение если включите в настройках соответствующий переключатель:
Интеграция → Автоматизация → Не выгружать модификаторы товара, как параметры
- Для того, чтобы активировать режим ингредиентов "Сколько угодно ингредиентов в одном количестве" Вам необходимо у групповых модификаторов установить максимальное количество 1, а минимальное 0. А так же у группы модификаторов установить максимальное количество > 1
- Для того, чтобы активировать режим ингредиентов "Сколько угодно ингредиентов в любом количестве" Вам необходимо у групповых модификаторов установить максимальное значение > 1, а так же у группы модификаторов установить максимальное значение > 1
- Для того, чтобы активировать режим ингредиентов "Один ингредиент в одном количестве" Вам необходимо у группы модификаторов максимальное значение установить 1, а минимальное <= 1
- Для того, чтобы установить флаг для обязательного выбора ингредиентов, Вам необходимо поставить галочку у группы модификаторов - обязательный выбор.
Проведение онлайн оплаты вручную:
Поставьте галочку Нет, чтобы указать Айко что Вы самостоятельно будете проводить онлайн заказы
При этом свойство онлайн оплаты будет передано в Айко как "Предоплата"
Это может потребоваться для поступления данных о заказе из Айко во внешние программы (например для учёта бонусных баллов).
Внешние источники заказа
- Для настройки внешних источников заказа в айко выберите пункт меню Доставка → Реклама
- Добавьте новый источник заказа
- Введите название
- Укажите источники заказа, один или несколько через ";":
Платформа | Источник заказа в Айко |
---|---|
Приложение Android | foodsoul-android |
Приложение IOS | foodsoul-ios |
Сайт | foodsoul-site |
Социальное приложение ВКонтакте | foodsoul-vk |
Синхронизация статусов заказа
После поступления в Айко будет происходить проверка заказа на изменение его статуса. Синхронизируются только стандартные статусы заказов:
Статус заказа в айко | Статус заказа в Личном кабинете |
---|---|
Новая | Без внимания |
Ждет отправки | Ожидает отправки |
В пути | В пути |
Закрыта | Выполнен |
Отменена | Отменен |
Доставлена | Выполнен |
Не подтверждена | Без внимания |
Готовится | На кухне |
Готово | Приготовлен |
Айко автоматически расчитывает со своей стороны время, необходимое на выполнение заказа.
Если Заказ слишком долго находится в текущем статусе, он считается "просроченным", и таймер статуса уходит в минус.
После времени отведённого на выполнение заказа в личном кабинете, ему автоматически выставляется статус "Подтверждён".
Подтверждённый заказ уже не может поменять свой статус через Айко и его нельзя отменить.
Передача способа оплаты
В Айко будет передаваться Способ оплаты который был выбран при оформлении заказа. Для этого необходимо настроить внешний тип оплаты в iikoOffice.
- В iikoOffice откройте раздел Розничные продажи -> Типы оплат.
- Укажите для типа оплаты необходимые настройки:
- -Тип: Банковские карты( для оплаты картой Онлайн )
- -Включите галочку Можно комбинировать с другими типами оплаты.
- -Проведение оплаты: Только внешний или Как внешний, так и на стороне ресторана.
- -Включите настройку Может приниматься извне. Она определяет что платеж создается по команде из другой системы.
- -Укажите специальный код, по которому Айко сможет распознать способ оплаты заказа. Введите значение в поле Код (например CARD или VISA). Значение вводится только в верхнем регистре.
- -Укажите в поле Платёжная система значение Внешняя.
- -Для оплаты Онлайн желательно также включить Запрещать вводить вручную, и в списке Проведение оплаты выбрать Только внешний.
- В личном кабинете FoodSoul:
- Поля настроек соответствуют способу оплаты заказа, который выбирается на сайте или в приложении.
- Вставьте в нужное поле Код типа оплаты, который Вы настраивали в iikoOffice.
Подробнее по настройкам способов оплат-ы можно прочитать в документации на официальном сайте:
https://ru.iiko.help/articles/#!iikooffice-6-3/topic-103
Настройка терминалов и стоимости доставки
Вы можете указать основной терминала для отправки заказов и стоимость доставки заказа.
В личном кабинете на странице настроек iikoDelivery найдите блок Районы:
-в поле Название терминала для доставки заказа скопируйте Название терминала Айко (Доставка → Терминалы доставки)
-заказы с сайта и из приложения будут поступать на этот терминал.
-в поле Название товара (стоимости доставки) для добавления в корзину укажите название товара который будет добавлен в заказ как "стомимость доставки".
-товар автоматически будет добавлен к каждому заказу
-товар должен присутствовать в номенклатуре для выгрузки
В выпадающем списке можно выбрать район и нажать кнопку Добавить - таким образом можно настроить разные терминалы и стоимость доставки для каждого района.
Передача локальных скидок
Клиентам в заказе может быть предоставлена отдельная локальная скидка.
Применять систему лояльности iikoCard совместно с локальными скидками нельзя! Используйте одно из двух: либо только локальные скидки, либо все скидки настраивайте в iikoCard.
Скидки из iikoCard должны применяться к заказу автоматически, для них не нужно производить настроек.
Откройте в iikoOffice меню Дисконтная система → Скидки и надбавки
Создайте новую скидку со свободной ценой.
В личном кабинете в поле Название гибкой скидки укажите название созданной скидки.
После сохранения настроек данная скидка будет применена к каждому заказу.
Подробнее с настройками можно ознакомиться в справочном руководстве на официальном сайте:
https://ru.iiko.help/articles/#!iikooffice-6-3/topic-503
Интеграция с iikoCard: локальный сервер
Программа позволяет Вам использовать локальный сервер iikoCard вместо основного по умолчанию.
- IP Адрес: укажите ip адрес Вашего сервера iikoCard.
- Режим работы: выберите Локальная версия Api 48
Интеграция с iikoCard: бонусная программа
Зарегистрированные клиенты могут накапливать и расплачиваться бонусными баллами.
- Для настройки интеграции с бонусной системой создайте и настройте бонусную программу в iikoCard;
- В действиях должно быть обязательно указано "Производить оплату со счета", чтобы у клиентов автоматически списывались бонусные баллы.
- Создайте в iikoOffice новый внешний тип оплаты для бонусной программы:
- Укажите тип: Безналичный расчёт
- Включите настройки:
-Может приниматься извне
-Можно комбинировать с другими типами оплаты - Укажите код: например BONUS
- Привяжите этот тип оплаты к бонусной программе:
-Безналичный тип: система iikoCard
-В дополнительных настройках выберите Вашу бонусную программу. - В личном кабинете в настройках укажите:
Код оплаты бонусами: Код метода оплаты для бонусной программы
Название бонусного кошелька: название бонусного счёта клиентов для Вашей бонусной программы - Откройте меню Настройки - Бонусная система
- Активируйте бонусную систему
- Включите настройку Бонусная система из системы автоматизации.
- Настройка завершена!
- Если всё настроено верно, в Айко будет отправляться информация об оплате бонусными баллами.
- Клиенты будут видеть баланс на своём счёте в профиле после регистрации.
Категории
Для того чтобы вы могли в автоматическом режиме устанавливать опции "Применять скидки для категории" и "Учитывать в корзине при минимальной сумме заказа" в iiko в "Дополнительной информации" у группы товаров Вам необходимо указать в формате JSON следующий массив данных:
array( 'minimal_sum' = TRUE or FALSE, 'discount' = TRUE or FALSE )
Товары
Для того чтобы вы могли в автоматическом режиме устанавливать "Лейбл" и "Публикацию на главной странице сайта" в iiko в "Дополнительной информации" у товара Вам необходимо указать в формате JSON следующий массив данных:
array( 'labels_ids' = array( 1, 2, 3 ), //ids лейблов(посмотреть можно в лк foodsoul в разделе лейблы) 'recommend' = TRUE or FALSE )