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

Настройка и подключение в личном кабинете

Для полноценной интеграции API iikoTransport требуется версия iiko 7.1.7+, подробнее можете уточнить у специалистов технической поддержки iiko.

1. Откройте Личный кабинет iikoWeb → Настройки iikoTransport → Клиенты API, либо в программе iikoOffice вам доступен пункт Обмен данными → Настройка iikoTransport

2. Для работы с iikoTransport в айко необходимо добавить интеграцию, и указать для неё API Логин, при этом Айко автоматически сгенерирует API Ключ

3. При создании новой интеграции укажите шаблон прав Full Rights(Все права) или Delivery(Права на работу с доставками) для сайта ресторана.

4. Заполните в программе товары для выгрузки меню:

Если Вы используете веб-офис iikoWeb, выберите меню для сайта в выпадающем списке Внешние меню. Если данное поле пустое, сформируйте меню в разделе iikoWeb → Внешние меню.
Подробнее можете ознакомиться по данной ссылке.

Если Вы используете для настроек программу iikoOffice, сформируйте внешнее меню для выгрузки в разделе Обмен данными → Выгрузка меню

  • Чтобы добавить новую категорию нажмите Добавить группу... введите название и нажмите Сохранить
  • Чтобы добавить в категорию товары в верхней таблице выберите группу, а в нижней выбирайте элементы нажимая Shift или Ctrl, затем нажмите Добавить выбранные товары.
  • Вместе с выгружаемыми блюдами создайте в меню папку для модификаторов и добавьте в неё модификаторы для этих блюд.
    (или переключите бегунок чтобы выгружались модификаторы, печатаемые в чеке)
  • В личном кабинете, на сайте и в приложении меню будет отображаться том же виде в котором оно заполнено в айко.
  • К каждому блюду в этом же разделе можно прикрепить изображение, указать название и описание.

Есть несколько ограничений на выгрузку:

  • Поддерживается уровень вложенности категорий не больше двух, если необходимо спуститься в каталоге на уровень ниже можно воспользоваться настройкой "Фильтр по названию группы меню".
  • Номенклатурные позиции среди выгружаемых не могут повторяться.

5. Далее в окне iikoTransport откройте настройки организации (Общие настройки → Организации)
Должна стоять галочка Включить работу через iikoTransport


6. В программе должны быть зарегистрированные терминалы доставки:

  • В программе iikoOffice выберите пункт меню Доставка → Терминалы доставки - это список "точек" на которые будут поступать заказы.
  • В списке должен быть хотя бы один зарегистрированный терминал. Выберите и нажмите Зарегистрировать, если таких нет.

6. Зайдите в Личный кабинет FoodSoul → Интеграции → Автоматизация
7. Выберите iikoTransport
8. Заполните обязательные поля настроек:

  • Логин: API Ключ iikoTransport, который Вы сгенерировали ранее.
  • Название организации: название организации, точно так как оно указано в Вашем аккаунте iiko.

9. Сохраните изменения.

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

Внимание! Выгрузка меню происходит сразу и полностью, текущие товары в личном кабинете будут удалены и заменены на новые.

11. Переключите иконку-глаз справа сверху - чтобы автоматическая интеграция работала она должна быть зеленой.
Меню будет автоматически обновляться раз в сутки. (warning) При синхронизации меню заменяется полностью, учитывайте это при редактировании и вносите необходимые изменения в iiko.(warning)

На этом всё) Далее посмотрим дополнительные настройки для полноценной интеграции Вашей системы.

Подробнее с процессом подключения API Вы можете ознакомиться по ссылке.

Адрес сервера

Если адрес API для Вашего сервера отличается от стандартного (https://api-ru.iiko.services/) укажите его в этом поле, иначе поле необходимо оставить пустым.

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

Укажите название номенклатурной категории товаров из айко. В личный кабинет будут выгружены только товары из этой категории.

(warning) Опция не участвует при выгрузке внешнего меню iikoWeb (warning)

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

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

(warning) Опция не участвует при выгрузке внешнего меню iikoWeb (warning)

Выгрузка внешнего меню

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

1. В Личном кабинете FoodSoul откройте раздел Интеграции - Автоматизация.

2. Найдите поле Название внешнего меню

3. Укажите название меню, так же как оно указано в веб офисе iikoWeb (iikoWeb → Внешние меню).

(warning) Если данное поле не заполнено, по умолчанию выгружается меню для выгрузки из iikoOffice (Обмен данными → Выгрузка меню). (warning)

Ценовые категории

Выгрузите меню с учётом ценовой категории, которая заранее была настроена в айко. Цена и состав товаров могут различаться для разных сайтов или ресторанов.

1. В Личном кабинете FoodSoul откройте раздел Интеграции - Автоматизация.

2. Найдите поле Название ценовой категории для внешнего меню

3. Укажите название ценовой категории, с которой должен будет работать сайт, так же как оно указано в айко.

(warning) Ценовые категории работают только с внешними меню iikoWeb. (warning)

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

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

Откройте справочник iikoOffice Розничные продажи -> Типы оплат. Укажите настройки способа оплаты или создайте новый:

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

В личном кабинете FoodSoul заполните поля настроек:

  • Код оплаты наличными
  • Код оплаты картой при получении
  • Код оплаты онлайн

Каждое поле соответствуют способу оплаты заказа, который выбирается на сайте или в приложении.
Укажите Код типа оплаты, который Вы настраивали в iiko.

Проводить оплату онлайн автоматически

Включите эту опцию, чтобы передать Айко статус онлайн оплаты Проведена.

Передача типа заказа

В Айко будет передаваться разный тип заказа в зависимости от условий. В Личном кабинете FoodSoul → Интеграции → Автоматизация найдите поля настроек:

  • Тип заказа для самовывоза
  • Тип заказа для доставки
  • Тип заказа для предзаказа cамовывоза
  • Тип заказа для предзаказа доставки

Откройте справочник iiko Розничные продажи → Типы заказов.

Укажите в нужном поле Название типа заказа из справочника.

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

Есть два способа настроить синхронизацию статуса заказа:

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

В Личном кабинете FoodSoul включите опцию Интеграции → Автоматизация → Callback Api.

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

Изменения поступают не моментально, в течение нескольких минут.

2. Webhook-уведомления

В Личном кабинете FoodSoul отключите опцию Интеграции → Автоматизация → Callback Api.

Скопируйте ссылку ниже: Интеграции → Автоматизация → WebHook

Зайдите в интерфейс веб-офиса iikoWeb в раздел настройки Webhook уведомлений

Вставьте ссылку, которую вы копировали выше в поле Uri для уведомлений о изменении статуса заказа и сохраните изменения.

При необходимости поставьте фильтры - галочки в блоке Доставка: Статус заказа и Ошибки.

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

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

Синхронизируются только стандартные статусы заказа:

Статус заказа в айкоСтатус заказа в личном кабинете
Не обработанаНе обработан

Не подтверждена

Не обработан
ОжидаетОжидает отправки на кухню
Пора готовитьНа кухне
ГотовитсяНа кухне
ПриготовленПриготовлен
Ждет отправкиОжидает отправки
ОтправленВ пути
ДоставленВыполнен
ЗакрытВыполнен
ОтмененОтменен

Передача акций и скидок

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

В айко можно передать сумму локальной скидки. Откройте справочник iiko Меню и цены → Скидки.

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

2. В Личном кабинете FoodSoul → Интеграции → Автоматизация найдите поле Название гибкой скидки

3. Укажите Название скидки которую Вы добавляли в справочнике.

4. Если в личном кабинете FoodSoul присутствует скидка к заказу, она будет передана в айко как сумма в рублях.

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

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

Товар в подарок

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

Есть несколько вариантов. Например:

- добавить в акции действие скидка 100% на выбранный товар
https://ru.iiko.help/articles/#!iikocard/topic-64/a/h3_15

- отдельно добавить в меню бесплатные товары для использования в акции и скрыть через личный кабинет FoodSoul
после переключения иконки публикации товара или категории она сохраняется

- в личном кабинете FoodSoul также есть акции с процентной или фиксированной скидкой на выбранные товары, эта скидка может быть передана в айко как локальная
(warning) помните про то что скидки айко кард применяются независимо согласно условиям акций в программе (warning)

Промокод

Промокод передается в айко как код купона айко кард(coupon).
https://ru.iiko.help/articles/#!iikocard/topic-15

Название промокода и код купона iikoCard должны совпадать, в этом случае айко отметит что купон с нужным кодом был активирован при заказе.

С помощью условия "Купон" в айко можно проверить был ли активирован данный промокод.

Передача терминала доставки

Вы можете указать iiko основной терминал для доставки заказов. В этом случае выбор терминала будет зависеть от выбора гостя в приложении точки самовывоза/района/города.

1. В Личном кабинете FoodSoul → Интеграции → Автоматизация найдите блоки Районы и Точки самовывоза

2. В поле Название терминала для доставки заказа укажите Название терминала доставки из iiko.

3. Из выпадающего списка ниже можете выбрать новый элемент и кликнуть Добавить. Таким образом можно настроить разные терминалы iiko для разных точек доставки.

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

Настройки бонусной программы

По умолчанию оплата бонусными баллами передаётся так же как акция - в виде суммы скидки.

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

1. Для настройки интеграции с бонусной системой создайте и настройте бонусную программу в iikoCard;

2. Настройте для бонусной программы метод оплаты.

3. Далее В личном кабинете Личном кабинете FoodSoul → Интеграции → Автоматизация укажите:

  • Код оплаты бонусами: Код метода оплаты для бонусной программы, который вы добавили в iiko.
  • Название бонусного кошелька: название бонусного счёта клиентов для Вашей бонусной программы.

4. Откройте раздел Личный кабинет FoodSoul → Настройки - Бонусная система

5. Активируйте бонусную систему

6. Включите настройку Бонусная система из системы автоматизации.

Настройка завершена!

Информация об оплате заказа бонусами будет передаваться в айко. Гости будут видеть количество баллов, которые начислены в iikoCard по совпадению номера телефона.

Дополнительные настройки товаров и категорий

Для категории вы можете в автоматическом режиме устанавливать опции "Применять скидки для категории" и "Учитывать в корзине при минимальной сумме заказа"

Откройте справочник iiko Обмен данными → Выгрузка меню

В карточке категории в поле "техническая информация" укажите в формате JSON:

{"minimal_sum": true, "discount": true}
  • minimal_sum - true или false, true - товары из категории учитываются в минимальной сумме для заказа; false - не учитываются
  • discount - true или false; true -  скидки на товары в категории включены; false - выключены;

Для товара вы можете в автоматическом режиме устанавливать "Лейбл" и "Публикацию на главной странице сайта"

Откройте справочник iiko Обмен данными → Выгрузка меню

В карточке товара в поле "техническая информация" укажите в формате JSON:

{"labels_ids":[6621,6615], "recommend": true}
  • 6621,6615 - номера API ID лэйблов из Личного кабинета Foodsoul → Настройки → Номерклатура  → Лэйблы для товаров, они должны быть заранее созданы.
  • recommend - true или false; Публикация товара на главной странице сайта(звёздочка) true - есть; false - нет;

Выгружать пищевую ценность продуктов

  • Выгружать пищевую ценность продуктов к каждому параметру товара индивидуально

Включите опцию чтобы выгрузить общие БЖУ и Калорийность для товаров и модификаторов.

  • Выгружать пищевую ценность на 100 грамм в описание товара

Включите чтобы дополнительно выгрузить БЖУ и Калорийность на 100гр в описании товаров.

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

  • Проверять доступность модификаторов для выгрузки по опции "не печатать в чеке" вместо "включено в меню"

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

Брать организацию из терминала

Включите для Колл-центра iiko с сетью терминалов доставки. Приложение будет изменять ID организации в зависимости от выбранного терминала.

Опция используется только если со стороны технической поддержки iiko настроен данный функционал.


  • No labels