...
2. Для работы с iikoTransport в айко необходимо добавить клиентаинтеграцию, сгенерировать и указать для него неё API Логин и , при этом Айко автоматически сгенерирует API Ключ
3. При создании ключа укажите тип заказов:
...
новой интеграции укажите шаблон прав Full Rights(Все права) или Delivery(Права на работу с доставками) для сайта ресторана.
4. Сформируйте в iiko . Заполните в программе товары для выгрузки меню:
Если Вы используете веб-офис iikoWeb, выберите меню для сайта в выпадающем списке Внешние меню. Если данное поле пустое, сформируйте меню в разделе iikoWeb → Внешние меню.
Подробнее можете ознакомиться по данной ссылке.
Если Вы используете для настроек программу iikoOffice, сформируйте внешнее меню для выгрузки (в разделе Обмен данными → Выгрузка меню)
- Чтобы добавить новую категорию нажмите Добавить группу... введите название и нажмите Сохранить
- Чтобы добавить в категорию товары в верхней таблице выберите группу, а в нижней выбирайте элементы нажимая Shift или Ctrl, затем нажмите Добавить выбранные товары.
- Вместе с выгружаемыми блюдами создайте в меню папку для модификаторов и добавьте в неё модификаторы для этих блюд.
(или переключите бегунок чтобы выгружались модификаторы, печатаемые в чеке) - В личном кабинете, на сайте и в приложении меню будет отображаться том же виде в котором оно заполнено в айко.
- К каждому блюду в этом же разделе можно прикрепить изображение, указать название и описание.
...
- Поддерживается уровень вложенности категорий не больше двух, если необходимо спуститься в каталоге на уровень ниже можно воспользоваться настройкой "Фильтр по названию группы меню".
- Номенклатурные позиции среди выгружаемых не могут повторяться.
5. Далее в iiko окне iikoTransport откройте настройки организации (Общие настройки -> → Организации)
Должна стоять галочка Включить работу через iikoTransport
6. В программе должны быть зарегистрированные терминалы доставки:
- В iiko программе iikoOffice выберите пункт меню Доставка → Терминалы доставки - это список "точек" на которые будут поступать заказы.
- В списке должен быть хотя бы один зарегистрированный терминал. Выберите и нажмите Зарегистрировать, если таких нет.
...
Если адрес API для Вашего сервера отличается от стандартного (https://api-ru.iiko.services/) укажите его в этом поле, иначе оставьте поле необходимо оставить пустым.
Фильтр товаров по названию категории
Укажите название номенклатурной категории товаров из айко. В личный кабинет будут выгружены только товары из этой категории.
Опция не участвует при выгрузке внешнего меню iikoWeb
Фильтр по имени группы
Укажите название группы товаров из внешнего меню для выгрузки. В личный кабинет будут выгружены только товары из её подкатегорий, т е она будет считаться корнем меню.
Опция не участвует при выгрузке внешнего меню iikoWeb
Выгрузка внешнего меню
Используйте это поле для того чтобы выгрузить товары из внешнего меню iikoWeb, ресторан может иметь несколько разных внешних меню для разных сайтов.
1. В Личном кабинете FoodSoul откройте раздел Интеграции - Автоматизация.
2. Найдите поле Название внешнего меню
3. Укажите название меню, так же как оно указано в веб офисе iikoWeb (iikoWeb → Внешние меню).
Если данное поле не заполнено, по умолчанию выгружается меню для выгрузки из iikoOffice (Обмен данными → Выгрузка меню).
Ценовые категории
Выгрузите меню с учётом ценовой категории, которая заранее была настроена в айко. Цена и состав товаров могут различаться для разных сайтов или ресторанов.
1. В Личном кабинете FoodSoul откройте раздел Интеграции - Автоматизация.
2. Найдите поле Название ценовой категории для внешнего меню
3. Укажите название ценовой категории, с которой должен будет работать сайт, так же как оно указано в айко.
Ценовые категории работают только с внешними меню iikoWeb.
Передача кода способа оплаты
В Айко будет передаваться Способ оплаты который был выбран при оформлении заказа. Для этого необходимо настроить внешний тип оплаты.
Откройте справочник iiko iikoOffice Розничные продажи -> Типы оплат. Укажите настройки способа оплаты или создайте новый:
...
Укажите в нужном поле Название типа заказа из справочника.
Синхронизация статусов заказа
Есть два способа настроить синхронизацию статуса заказа:
После 1. После поступления заказа в Айко периодически будет происходить его проверка на изменение статуса. Синхронизируются только стандартные статусы заказа.
...
.
В Личном кабинете FoodSoul включите опцию Интеграции → Автоматизация → Callback Api.
После поступления заказа в Айко периодически будет происходить проверка на его изменение. Если статус доставки в айко был изменен, в личном кабинете статус заказа изменится на соответствующий.
Изменения поступают не моментально, в течение нескольких минут.
2. Webhook-уведомления
В Личном кабинете FoodSoul отключите опцию Интеграции → Автоматизация → Callback Api.
Скопируйте ссылку ниже: Интеграции → Автоматизация → WebHook
Зайдите в интерфейс веб-офиса iikoWeb в раздел настройки Webhook уведомлений
Вставьте ссылку, которую вы копировали выше в поле Uri для уведомлений о изменении статуса заказа и сохраните изменения.
При необходимости поставьте фильтры - галочки в блоке Доставка: Статус заказа и Ошибки.
Статус заказа изменится по возможности сразу после поступления уведомления от Айко.
| Информация |
|---|
|
Синхронизируются только стандартные статусы заказа:
| Статус заказа в айко | Статус заказа в личном кабинете |
|---|---|
| Не обработана | Не обработан |
Не подтверждена | Не обработан |
| Ожидает | Ожидает отправки на кухню |
| Пора готовить | На кухне |
| Готовится | На кухне |
| Приготовлен | Приготовлен |
| Ждет отправки | Ожидает отправки |
| Отправлен | В пути |
| Доставлен | Выполнен |
| Закрыт | Выполнен |
| Отменен | Отменен |
Передача акций и скидок
Скидки из программы лояльности iikoCard будут должны применяться к заказу автоматически, для них не нужно производить дополнительных настроек в личном кабинете FoodSoul.
...
4. Если в личном кабинете FoodSoul присутствует скидка к заказу, она будет передана в айко как сумма в рублях.Результата выполнения акции из личного кабинета FoodSoul передаётся в айко как сумма скидки
| Информация |
|---|
Применять систему лояльности iikoCard совместно с локальными скидками не рекомендуется! Используйте одно из двух: либо только локальные скидки, либо все скидки настраивайте в iikoCard. Условия программы лояльности применятся к заказу в айко уже с учётом результата акций настроенных в личном кабинете. Рекомендуем настроить синхронизацию скидок с айко или настраивать автоматические акции iikoCard таким образом чтобы были совпадения по действиям и условиям. |
Товар в подарок
Товар в подарок передаётся в айко как дополнительная позиция. Так что далее после получения заказа со стороны iikoCard необходимо сделать так чтобы этот товар считался бесплатным.
Есть несколько вариантов. Например:
- добавить в акции действие скидка 100% на выбранный товар
https://ru.iiko.help/articles/#!iikocard/topic-64/a/h3_15
- отдельно добавить в меню бесплатные товары для использования в акции и скрыть через личный кабинет FoodSoul
после переключения иконки публикации товара или категории она сохраняется
- в личном кабинете FoodSoul также есть акции с процентной или фиксированной скидкой на выбранные товары, эта скидка может быть передана в айко как локальная помните про то что скидки айко кард применяются независимо согласно условиям акций в программе
Промокод
Промокод передается в айко как код купона айко кард(coupon).
https://ru.iiko.help/articles/#!iikocard/topic-15
Название промокода и код купона iikoCard должны совпадать, в этом случае айко отметит что купон с нужным кодом был активирован при заказе.
С помощью условия "Купон" в айко можно проверить был ли активирован данный промокод.
Передача терминала доставки
Вы можете указать iiko основной терминал для доставки заказов. В этом случае выбор терминала будет зависеть от выбора гостя в приложении точки самовывоза/района/города.В айко должен передаваться терминал доставки, на который будут отправляться заказы. Для этого укажите в личном кабинете название группы терминала для доставки заказов.
1. В Личном кабинете FoodSoul → Интеграции → Автоматизация найдите блоки Районы и Точки самовывоза
2. В поле Название терминала для доставки заказа укажите Название терминала доставки из iiko.
...
4. Пункт По умолчанию действует для всех точек самовывоза или районов которым не присвоен терминал.
Выбор терминала будет зависеть от выбора гостя в приложении точки самовывоза/района/города.
Передача стоимости доставки
Вы можете указать товар, который будет дополнительно передаваться в iiko как стоимость доставки.
1. В Личном кабинете FoodSoul → Интеграции → Автоматизация найдите блок Районы
2. В поле Название товара (стоимости доставки) для добавления в корзину укажите Название товара из меню для выгрузки iiko.
3. Можно настроить разные товары доставки для разных районов. Из выпадающего списка ниже выберите новый элемент и кликните Добавить.
4. Пункт По умолчанию действует для всех районов, которым не был добавлен товар доставки.
Настройки бонусной программы
...
6. Включите настройку Бонусная система из системы автоматизации.
7. Также необходимо проверить формат номера телефона клиентов, чтобы у клиентов отображался корректный баланс бонусов. Для этого перейдите в раздел Настройки → Филиалы → раздел Настройки обработки телефона клиента. Настройки формата номера телефона должны совпадать с настройками формата номера из iikoCard.
Настройка завершена!
Информация об оплате заказа бонусами будет передаваться в айко. Гости будут видеть количество баллов, которые начислены в iikoCard по совпадению номера телефона.
...
- 6621,6615 - номера API ID лэйблов из Личного кабинета Foodsoul → Настройки → Номерклатура → Лэйблы для товаров, они должны быть заранее созданы.
- recommend - true или false; Публикация товара на главной странице сайта(звёздочка) true - есть; false - нет;
Выгружать пищевую ценность продуктов
- Выгружать пищевую ценность продуктов к каждому параметру товара индивидуально
Включите опцию чтобы выгрузить общие БЖУ и Калорийность для товаров и модификаторов.
- Выгружать пищевую ценность на 100 грамм в описание товара
Включите чтобы дополнительно выгрузить БЖУ и Калорийность на 100гр в описании товаров.
Выгрузка модификаторов
- Проверять доступность модификаторов для выгрузки по опции "не печатать в чеке" вместо "включено в меню"
После переключения опции логика выгрузки немного поменяется, в личный кабинет будут выгружены все модификаторы, кроме тех у которых в карточке номенклатуры не указано Печатать на чеке
Брать организацию из терминала
Включите для Колл-центра iiko с сетью терминалов доставки. Приложение будет изменять ID организации в зависимости от выбранного терминала.
Опция используется только если со стороны технической поддержки iiko настроен данный функционал.