Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Подключение интеграции в личном кабинете

  1. Начнём с настроек iikoOffice. Откройте раздел Обмен данными → iiko.Biz → Состояние подключения

  2. Убедитесь, что все проверки доступны и горят зелёным цветом:
  3. Если Вы это делаете в первый раз, программа предложит зарегистрироваться: в этом случае введите ФИО, название предприятия и всё что необходимо и зарегистрируйтесь на сайте.
  4. Войдите в свой аккаунт на iiko.biz, выберите в меню Приложения → Список.
  5. Вам потребуется подключить приложение API iikoDelivery - найдите его в списке приложений, выберите и нажмите Подключить
  6. Пароль и логин, которые Вы ввели при подключении API iikoDelivery необходимо (warning) запомнить, именно они нам понадобятся при настройках импорта.
  7. Опять откройте iikoOffice
  8. Выберите пункт меню Доставка → Терминалы доставки - это список точек на которые будут поступать заказы.
  9. В списке должен быть хотя бы один зарегистрированный терминал. Выберите и нажмите Зарегистрировать, если таких нет.
  10. Перейдите в раздел Обмен данными → iiko.Biz → Выгрузка меню 
  11. Заполните Меню для выгрузки - тут отображается меню сайта по категориям
    - Чтобы добавить новую категорию нажмите Добавить группу... введите название и нажмите Сохранить
    - Чтобы добавить в категорию товары в верхней таблице выберите группу, а в нижней выбирайте элементы нажимая Shift или Ctrl, затем нажмите Добавить выбранные товары
    - Вместе с выгружаемыми блюдами необходимо создать папку для модификаторов и добавить в неё модификаторы для этих блюд.
  12. Как только меню для выгрузки сформировано, нажмите Выгрузить
  13. Зайдите в личный кабинет FoodSoul Интеграции → Автоматизация
  14. Поставьте галочку iikoDelivery и заполните поля в настройках:
    Пользователь: логин пользователя в API iikoDelivery
    Пароль: пароль пользователя в API iikoDelivery
    Организация: название Вашей организации как оно указано в аккаунте
    Не путайте эти доступы с доступами для входа в личный кабинет iiko.biz
    (warning) на деле подключение API происходит не сразу, возможно придётся подождать некоторое время, чтобы всё заработало и выгрузка прошла успешно
  15. Нажмите Сохранить
  16. Если всё правильно, список товаров должен выгрузиться в личный кабинет.
  17. Номенклатура из айко будет автоматически выгружаться в личный кабинет раз в сутки. При синхронизации меню будет полностью заменено, это нужно учитывать при редактировании.
  18. Заказы, оформленные через сайт или приложение, будут поступать в Айко.


Info

Далее указаны дополнительные настройки для iiko Delivery, чтобы Вы могли полноценно интегрировать наши системы.

Подробнее о том как подключить API Вы можете узнать по этой ссылке


Принудительное обновление меню

Ссылка Принудительный запуск импорта данных позволяет принудительно обновить меню в личном кабинете с серверов айко.

Фильтр товаров по названию категории

В поле Фильтр товаров по названию категории укажите название Категории для элементов номенклатуры (вкладка Дополнительная информация в настройках товара Айко)

Товары будут импортироваться только из этой категории.

Фильтр товаров по имени группы

В поле Фильтр по имени группы укажите название группы из меню для выгрузки Айко (Обмен данными → iiko.Biz → Выгрузка меню)

Товары будут импортироваться только из этой группы и из её подгрупп.

Фильтр товаров и цен по имени терминала(прайс-лист)

Айко позволяет создать Приказ об изменении прейскуранта, при этом может изменяться стоимость товаров или они могут сниматься с продажи на определённых точках

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

Айко позволяет создать Приказ об изменении прейскуранта, при этом может изменяться стоимость товаров или они могут сниматься с продажи на определённых точках

В поле Фильтр цен по имени терминала укажите Название терминала Айко, который назначен соответствующему торговому отделению.

  • В личный кабинет будут выгружены товары и модификаторы с ценами из прайс-листа назначенного для этого терминала.
  • Не будут выгружены модификаторы и товары снятые с продажи на выбранном терминале.
  • На один филиал в личном кабинете можно указать только один терминал.

Например:

  • Вы хотите сделать категорию "Хот-доги mini" доступной только в филиале Краснодар
  • Создайте для неё новый приказ
  • Оставьте галочки только для точки Краснодар и сохраните, чтобы приказ вступил в действие.

    Info

    Важный момент: при создании приказа необходимо выбрать все точки, чтобы они были подсвечены черным цветом иначе приказ на них не подействует

  • Сделайте выгрузку ( Обмен данными - iiko.biz - Выгрузка меню )
  • Откройте в личном кабинете FoodSoul филиал Краснодар
  • В поле Фильтр цен по имени терминала укажите Название терминала для точки Краснодар.
  • После обновления меню во всех филиалах кроме города Краснодар товары из категории "Хот-доги mini" не будет отображаться.

Сохранение изображений товаров

В поле Обновлять изображения, только при отсутствии загруженных поставьте галочку Да, чтобы была возможность загружать картинки товаров в личный кабинет. При обновлении меню из Айко они будут сохранены.

Выгрузка параметров товара и модификаторов

Все схемы модификаторов товара из айко импортируются в соответствующие разделы в личном кабинете:

Номенклатура - Группы модификаторов
Номенклатура - Модификаторы
  • Для того, чтобы выгрузить товар с выбором параметра у группы модификаторов необходимо указать в свойствах максимальное количество 1, минимальное количество 1 и поставить галочку "обязательный выбор".
    (warning) По умолчанию все группы модификаторов с такими настройками выгружаются как параметры товара
    (warning) Вы можете отменить это поведение если включите в настройках соответствующий переключатель:
    Интеграция → Автоматизация → Не выгружать модификаторы товара, как параметры
  • Для того, чтобы активировать режим ингредиентов "Сколько угодно ингредиентов в одном количестве" Вам необходимо у групповых модификаторов установить максимальное количество 1, а минимальное 0. А так же у группы модификаторов установить максимальное количество > 1
  • Для того, чтобы активировать режим ингредиентов "Сколько угодно ингредиентов в любом количестве" Вам необходимо у групповых модификаторов установить максимальное значение > 1, а так же у группы модификаторов установить максимальное значение > 1
  • Для того, чтобы активировать режим ингредиентов "Один ингредиент в одном количестве" Вам необходимо у группы модификаторов максимальное значение установить 1, а минимальное <= 1
  • Для того, чтобы установить флаг для обязательного выбора ингредиентов, Вам необходимо поставить галочку у группы модификаторов - обязательный выбор.

Проведение онлайн оплаты вручную:

Поставьте галочку Нет, чтобы указать Айко что Вы самостоятельно будете проводить онлайн заказы

При этом свойство онлайн оплаты будет передано в Айко как "Предоплата"

Это может потребоваться для поступления данных о заказе из Айко во внешние программы (например для учёта бонусных баллов).

Внешние источники заказа

  • Для настройки внешних источников заказа в айко выберите пункт меню Доставка → Реклама
  • Добавьте новый источник заказа
  • Введите название
  • Укажите источники заказа, один или несколько через ";":
ПлатформаИсточник заказа в Айко
Приложение Androidfoodsoul-android
Приложение IOSfoodsoul-ios
Сайтfoodsoul-site
Социальное приложение ВКонтактеfoodsoul-vk

Синхронизация статусов заказа

После поступления в Айко будет происходить проверка заказа на изменение его статуса. Синхронизируются только стандартные статусы заказов:

Статус заказа в айкоСтатус заказа в Личном кабинете
НоваяБез внимания
Ждет отправкиОжидает отправки
В путиВ пути
ЗакрытаВыполнен
ОтмененаОтменен
ДоставленаВыполнен
Не подтвержденаБез внимания
ГотовитсяНа кухне
ГотовоПриготовлен
Info

Айко автоматически расчитывает со своей стороны время, необходимое на выполнение заказа.

Если Заказ слишком долго находится в текущем статусе, он считается "просроченным", и таймер статуса уходит в минус.

После времени отведённого на выполнение заказа в личном кабинете, ему автоматически выставляется статус "Подтверждён".

Подтверждённый заказ уже не может поменять свой статус через Айко и его нельзя отменить.

Передача способа оплаты

В Айко будет передаваться Способ оплаты который был выбран при оформлении заказа. Для этого необходимо настроить внешний тип оплаты в iikoOffice.

  • В iikoOffice откройте раздел Розничные продажи -> Типы оплат.
  • Укажите для типа оплаты необходимые настройки:
  • -Тип: Банковские карты( для оплаты картой Онлайн )
  • -Включите галочку Можно комбинировать с другими типами оплаты.
  • -Проведение оплаты: Только внешний или Как внешний, так и на стороне ресторана.
  • -Включите настройку Может приниматься извне. Она определяет что платеж создается по команде из другой системы.
  • -Укажите специальный код, по которому Айко сможет распознать способ оплаты заказа. Введите значение в поле Код (например CARD или VISA). Значение вводится только в верхнем регистре.
  • -Укажите в поле Платёжная система значение Внешняя.
  • -Для оплаты Онлайн желательно также включить Запрещать вводить вручную, и в списке Проведение оплаты выбрать Только внешний.
  • В личном кабинете FoodSoul:
  • Поля настроек соответствуют способу оплаты заказа, который выбирается на сайте или в приложении.
  • Вставьте в нужное поле Код типа оплаты, который Вы настраивали в iikoOffice.

Подробнее по настройкам способов оплат-ы можно прочитать в документации на официальном сайте:
https://ru.iiko.help/articles/#!iikooffice-6-3/topic-103

Настройка терминалов и стоимости доставки

Вы можете указать основной терминала для отправки заказов и стоимость доставки заказа.

В личном кабинете на странице настроек iikoDelivery найдите блок Районы:

-в поле Название терминала для доставки заказа скопируйте Название терминала Айко (Доставка → Терминалы доставки) 
-заказы с сайта и из приложения будут поступать на этот терминал.

-в поле Название товара (стоимости доставки) для добавления в корзину укажите название товара который будет добавлен в заказ как "стомимость доставки".
-товар автоматически будет добавлен к каждому заказу
-товар должен присутствовать в номенклатуре для выгрузки

В выпадающем списке можно выбрать район и нажать кнопку Добавить - таким образом можно настроить разные терминалы и стоимость доставки для каждого района.

Передача локальных скидок

Клиентам в заказе может быть предоставлена отдельная локальная скидка.

Info

Применять систему лояльности iikoCard совместно с локальными скидками нельзя! Используйте одно из двух: либо только локальные скидки, либо все скидки настраивайте в iikoCard.

Скидки из iikoCard должны применяться к заказу автоматически, для них не нужно производить настроек.

Откройте в iikoOffice меню Дисконтная система → Скидки и надбавки

Создайте новую скидку со свободной ценой.

В личном кабинете в поле Название гибкой скидки укажите название созданной скидки.

После сохранения настроек данная скидка будет применена к каждому заказу.

Подробнее с настройками можно ознакомиться в справочном руководстве на официальном сайте:
https://ru.iiko.help/articles/#!iikooffice-6-3/topic-503

Интеграция с iikoCard: локальный сервер

Программа позволяет Вам использовать локальный сервер iikoCard вместо основного по умолчанию.


  • IP Адрес: укажите ip адрес Вашего сервера iikoCard.
  • Режим работы: выберите Локальная версия Api 48

Интеграция с iikoCard: бонусная программа

Зарегистрированные клиенты могут накапливать и расплачиваться бонусными баллами.

  1. Для настройки интеграции с бонусной системой создайте и настройте бонусную программу в iikoCard;
  2. В действиях должно быть обязательно указано "Производить оплату со счета", чтобы у клиентов автоматически списывались бонусные баллы.
  3. Создайте в iikoOffice новый внешний тип оплаты для бонусной программы:
  4. Укажите тип: Безналичный расчёт
  5. Включите настройки:
    -Может приниматься извне
    -Можно комбинировать с другими типами оплаты
  6. Укажите код: например BONUS
  7. Привяжите этот тип оплаты к бонусной программе:
    -Безналичный тип: система iikoCard
    -В дополнительных настройках выберите Вашу бонусную программу.
  8. В личном кабинете в настройках укажите:

    Код оплаты бонусами: Код метода оплаты для бонусной программы
    Название бонусного кошелька: название бонусного счёта клиентов для Вашей бонусной программы
  9. Откройте меню Настройки - Бонусная система

  10. Активируйте бонусную систему
  11. Включите настройку Бонусная система из системы автоматизации.
  12. Настройка завершена!
  13. Если всё настроено верно, в Айко будет отправляться информация об оплате бонусными баллами.
  14. Клиенты будут видеть баланс на своём счёте в профиле после регистрации.

Категории

Для того чтобы вы могли в автоматическом режиме устанавливать опции "Применять скидки для категории" и "Учитывать в корзине при минимальной сумме заказа" в iiko в "Дополнительной информации" у группы товаров Вам необходимо указать в формате JSON следующий массив данных:

Code Block
languagephp
themeRDark
array(
	'minimal_sum' = TRUE or FALSE,
	'discount' = TRUE or FALSE
)

Товары

Для того чтобы вы могли в автоматическом режиме устанавливать "Лейбл" и "Публикацию на главной странице сайта" в iiko в "Дополнительной информации" у товара Вам необходимо указать в формате JSON следующий массив данных:

Code Block
languagephp
themeRDark
array(
	'labels_ids' = array(
		1, 2, 3
	), //ids лейблов(посмотреть можно в лк foodsoul в разделе лейблы)
	'recommend' = TRUE or FALSE
)