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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Например:

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

• Оставьте галочки только для точки Краснодар и сохраните, чтобы приказ вступил в действие.

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

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

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

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

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

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

• Для того, чтобы выгрузить товар с выбором параметра у группы модификаторов необходимо указать в свойствах максимальное количество 1, минимальное количество 1 и поставить галочку "обязательный выбор".
   По умолчанию все группы модификаторов с такими настройками выгружаются как параметры товара
   Вы можете отменить это поведение если включите в настройках соответствующий переключатель:
  Интеграция → Автоматизация → Не выгружать модификаторы товара, как параметры

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

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

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

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

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

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

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

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

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

• Для настройки внешних источников заказа в айко выберите пункт меню Доставка → Реклама
• Добавьте новый источник заказа
• Введите название
• Укажите источники заказа, один или несколько через ";":

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Откройте в 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
)