Page tree

Versions Compared

Key

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

Table of Contents

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

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

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


Info

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

 

Как

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

Описание полей настроек

  • Пользователь: логин пользователя в API iikoDelivery
  • Пароль: пароль пользователя в API iikoDelivery
  • Название организации: название Вашей организации как оно указано в аккаунте

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

    Image Added

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

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

    Image Added

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

    : будут выгружены товары только (warning) из категории с этим названием

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

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

    Фильтр товаров по

    названию группы: будут выгружены товары только (warning) из группы с этим названием и её подгрупп.
  • IP Адрес: если по каким-то причинам нужно развернуть локальный сервер iiko.biz это поле позволяет указать его IP адрес; учитывайте настройки сервера: в этом случае для запросов авторизации используется порт 9900 !
  • Районы: в этой группе настраиваются терминалы доставки:
  • Название терминала для доставки заказа: название терминала ( точно такое же как в Айко ). Если указано - это будет основной терминал на который будет отправлен заказ.
  • имени группы

    Image Added

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

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

    Фильтр товаров и цен по имени терминала

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

    Image Added

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

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

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

    Image Added

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Image Added

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

    -в поле Название товара (стоимости доставки) для добавления в корзину

    : "решение" известной проблемы большинства сервисов - имя товара из личного кабинета

    укажите название товара который будет добавлен в заказ как "

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

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

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

    несколько терминалов

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

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

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

    Info

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

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

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

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

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

    Image Added

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

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

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

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

    Image Added


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

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

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

    1. Для настройки интеграции с бонусной системой создайте и настройте бонусную программу в iikoCard;
    2. В действиях должно быть обязательно указано "Производить оплату со счета", чтобы у клиентов автоматически списывались бонусные баллы.
    3. Создайте в iikoOffice новый внешний тип оплаты для бонусной программы:
      Image Added
    4. Укажите тип: Безналичный расчёт
    5. Включите настройки:
      -Может приниматься извне
      -Можно комбинировать с другими типами оплаты
    6. Укажите код: например BONUS
    7. Привяжите этот тип оплаты к бонусной программе:
    8. Безналичный тип: система iikoCard
    9. В дополнительных настройках выберите Вашу бонусную программу.
    10. В личном кабинете в настройках укажите:
      Image Added
      Код оплаты бонусами: Код метода оплаты для бонусной программы
      Название бонусного кошелька: название бонусного счёта клиентов для Вашей бонусной программы
    11. Откройте меню Настройки - Бонусная система
      Image Added
    12. Активируйте бонусную систему
    13. Включите настройку Бонусная система из системы автоматизации.
    14. Настройка завершена!
    15. Если всё настроено верно, в Айко будет отправляться информация об оплате бонусными баллами.
    16. Клиенты будут видеть баланс на своём счёте в профиле после регистрации.

    Категории

    Для того чтобы вы могли в автоматическом режиме устанавливать опции "Применять скидки для категории" и "Учитывать в корзине при минимальной сумме заказа" в 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
    )

    Ингредиенты

  • Для того, чтобы активировать режим ингредиентов "Сколько угодно ингредиентов в одном количестве" Вам необходимо у групповых модификаторов установить максимальное количество 1, а минимальное 0. А так же у группы модификаторов установить максимальное количество > 1
  • Для того, чтобы активировать режим ингредиентов "Сколько угодно ингредиентов в любом количество" Вам необходимо у групповых модификаторов установить максимальное значение > 1, а так же у группы модификаторов установить максимальное значение > 1
  • Для того, чтобы активировать режим ингредиентов "Один ингредиент в одном количестве" Вам необходимо у группы модификаторов максимальное значение установить 1, а минимальное <= 1
  • Для того, чтобы установить флаг для обаятельного выбора ингредиентов, Вам необходимо поставить галочку у группы модификаторов - обязательный выбор