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 2 Next »

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

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

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

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

3. При создании ключа укажите тип заказов:

  • Шаблон прав - Delivery или Full rights
  • Тип использования - для сайта ресторана

4. Сформируйте в iiko внешнее меню для выгрузки (Обмен данными → Выгрузка меню)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Результата выполнения акции из личного кабинета FoodSoul передаётся в айко как сумма скидки. Рекомендуем настроить синхронизацию скидок с айко или настраивать автоматические акции 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 - нет;


  • No labels