Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 23 Next »

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

  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, затем нажмите Добавить выбранные товары
    (warning) Частая ошибка: Добавляемые товары не должны иметь тип Модификатор, иначе с выгрузкой меню возникнут проблемы
  12. Как только меню для выгрузки сформировано, нажмите Выгрузить
  13. Зайдите в личный кабинет FoodSoul Интеграция → Автоматизация
  14. Поставьте галочку iikoDelivery и заполните поля в настройках:
    Пользователь: логин пользователя в API iikoDelivery
    Пароль: пароль пользователя в API iikoDelivery
    Организация: название Вашей организации как оно указано в аккаунте
    Не путайте эти доступы с доступами для входа в личный кабинет iiko.biz
    (warning) на деле подключение API происходит не сразу, возможно придётся подождать некоторое время, чтобы всё заработало и выгрузка прошла успешно
  15. Нажмите Сохранить
  16. Если всё правильно, список товаров должен выгрузиться в личный кабинет.
  17. Номенклатура из айко будет автоматически выгружаться в личный кабинет раз в сутки. При синхронизации меню будет полностью заменено, это нужно учитывать при редактировании.
  18. Заказы, оформленные через сайт или приложение, будут поступать в Айко.


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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

Например:

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Для настройки внешних источников заказа в айко выберите пункт меню Доставка → Реклама
  • Добавьте новый источник заказа
  • Введите название
  • Укажите источники заказа, один или несколько через ";":
ПлатформаИсточник заказа в Айко
Приложение AndroidFoodSoul - android
Приложение IOSFoodSoul - 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: бонусная программа

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

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

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

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

Категории

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