Интеграция с iiko

В данной статье рассмотрим интеграцию интернет-магазина на платформе AdvantShop с системой iiko через модуль.

Iiko – это программа автоматизации работы ресторана, увеличения эффективности процессов и улучшения обслуживания клиентов. Модуль интеграции с системой iiko позволяет выгружать и синхронизировать каталог на сайте с меню из iiko; выгружать и синхронизировать заказы и их статусы; использовать программу лояльности iikoCard, при подключении бонусной системы на стороне AdvantShop (доступно с тарифа "Pro"). Бонусы синхронизируются.

• Установка и базовая настройка модуля
• Настройки обновления товаров
  • Ручная скидка
  • Источник товаров
    • Справочник товаров
    • Внешнее меню
    • Источник цен
  • Обновлять
  • Настройки синхронизации
• Настройки вебхуков
• Импорт каталога и заказов
• Модификаторы
• Сопоставление методов доставки и оплаты
• Купоны

 

Установка и базовая настройка модуля

Чтобы приступить к настройке модуля, его потребуется установить. Перейдите в раздел "Модули" - "Магазин модулей", найдите в списке модуль iiko и нажмите под ним на кнопку "Установить" (рис. 1).

Рисунок 1.

После установки модуля станет доступна его единственная настройка – "Api Login" (рис. 2).

Рисунок 2.

В этом поле необходимо указать API-ключ для интеграции с iiko. Его можно получить в настройках системы iiko в разделе "Внешние заказы" - "Настройки Cloud API", вкладка "Основное", затем выбрать нужный "API ключ" (рис. 3), либо через поддержку сервиса.


Рисунок 3.

После указания API-ключа сохраняем настройки модуля. Если ключ указан действительный, в модуле появятся дополнительные настройки (рис. 4). 

Рисунок 4.

Рассмотрим следующие настройки:

• Организация по умолчанию, Терминал по умолчанию – из выпадающих списков нужно выбрать, с какой организацией и терминалом будет связываться модуль. Данные подгружаются по API-ключу из iiko, ввести их самостоятельно не получится.
• Организация в зависимости от метода доставки – если на стороне iiko действует несколько организаций (например, ресторан, кафе, пицца) можно для каждого метода указать для какой организации он будет действовать.

 

Настройки обновления товаров

Заметка

Если в модуле отсуствуют настройки, проверьте корреткность указанного API-ключа.

Рассмотрим настройки скидок и источников товаров ниже.

 

Ручная скидка

При использовании функции "Ручной скидки" все данные о скидках берутся из магазина Адвантшоп и передаются для синхронизации в систему iiko при оформлении заказа (рис. 5).

Рисунок 5.

Мы рассмотрим пример создания такой скидки в iikoOffice. Пройдите в раздел "Дисконтная система" - "Скидки и надбавки".

• Затем, нажмите Добавить скидку с типом "Скидки и надбавки" в первом окне (рис. 6.1). 
• В настройках второго окна скидки, включите опцию "Можно назначать вручную" (рис. 6.2).
• В третьем назначьте "Метод применения: К полной сумме заказа" и "Тип: Скидка с Фиксированной суммой", включив опцию "Назначать сумму" (рис. 6.3).

Рисунок 6.

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

При включении "Ручной скидки" в настройках модуля, будет показана дополнительная настройка: "Отправлять оплату бонусами как скидку".

Отправлять оплату бонусам как скидку – если в заказе была оплата бонусами, то сумма оплаченная бонусами будет указана как скидка со свободной суммой в системе iiko.

 

Источник товаров

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

1. Справочник товаров – используется для загрузки товаров в магазин, при работе с системой iikoOffice (рис. 7).

Рисунок 7.

Товары и категории можно будет импортировать в магазин через 5 минут, после того как в iikoOffice в разделе "Обмен данными" - "Выгрузка меню", товары были добавлены для выгрузки и была произведена выгрузка по нажатию на кнопку "Выгрузить".

Опция справочника также включает отображение дополнительной настройки: "Источник категорий".

Источник категорий – опция определяющая каким образом будут созданы категории для товаров в магазине. Есть три источника категорий:

• Товары без категорий – система не импортирует категории.
• Список групп – в магазине создаются категории на основе номенклатурных групп.
• Список категорий – в магазине создаются категории на основе Категории, присвоенной импортируемым товарам на вкладке "Дополнительная информация" в iikoOffice.

2. Внешнее меню – используется для загрузки товаров в магазин, при работе с системой iikoWeb (рис. 8). Личный кабинет iikoWeb доступен по ссылке вида: https://3хх-7хх-9хх.iikoweb.ru/.

Рисунок 8.

"Внешнее меню" включает отображение и использует дополнительные, связанные, настройки: "Меню", "Организация в зависимости от склада", "Источник цен".

Меню – в этой настройке выбираются настроенные вами в iikoWeb Внешние меню. Подробнее о том как создать Внешнее меню в iikoWeb. 

Заметка

Если товары или позиции были изменены на стороне iikoWeb, необходимо обновить само Внешнее меню на стороне iikoWeb.

После того как Внешнее меню будет настроено и создано, необходимо убедиться, что оно добавлено к активным меню в разделе "Настройки API Cloud" для той же организации, API которой вы использовали для интеграции (рис. 9).

Рисунок 9.

Организация в зависимости от склада – для каждого склада магазина в Адвантшоп можно установить свою организацию, соответствующую ему в системе iikoWeb. Например, товар может быть исключен из продажи для одной из организаций и тогда для склада, который привязан к этой организации, остаток товара обнулится (если включена опция "Обнулять остатки у товаров не в наличии").

 

Источник цен

Есть два вида источников цен – это "Внешнее меню" и "Ценовые категории".

Внешнее меню – устанавливает цены в соотвествии с ценами товаров, как они указаны для Внешнего меню, например, в iikoWeb.

Ценовые категории – устанавливает соответствие между настройками "Типы цен" в магазине и с "Ценовыми категориями" системы iiko.

Заметка

Для настройки соответствия типов цен и ценовых категорий небходимо на стороне магазина создать типы цен, а на стороне айко в качестве источника цен указать "ценовые категории".
Если в процессе работы на стороне айко поменяете источник цен, то на стороне магазина необходимо привести настройки в соответствие, иначе обновление товаров перестанет работать.

Рассмотрим связанные настройки "Ценовых категорий" (рис. 10).

Рисунок 10.

Ценовая категория для базовой цены – базовая ценовая категория, которая используется как стандартная цена у товара.

Связка типы цены с ценовой категорией iiko – список с выпадающими меню, где можно установить соотвествие между Ценовой категорией из iiko и Типом цены настроенным в магазине.

Действия с ценой, отсутствющей в ценовой категории – если у товара отсутствует ценовая категория, текущее значение Типа цены у такого товара будет изменено в соотвествии с выбранной опцией:

• Ничего не делать – ничего не произойдет с типовой ценой.
• Обнулить – значение типовой цены будет установлено как "0" в карточке товара, а базовая останется как есть.
• Удалить – значение типовой цены будет полностью удалено в карточке товара, а базовая останется как есть.

 

Обновлять

В данном поле прописывается, что необходимо обновлять у товаров при обмене данных (рис. 11).

Рисунок 11.

 

Настройки синхронизации между модулем и iiko

Рассмотрим подробнее настройки импорта товаров и заказов (рис. 12).

Рисунок 12.

1. Заменить фотографии товаров – фотографии товара будут заменены фотографиями из Iiko. Старые фотографии будут удалены.
2. Деактивировать товары не в наличии – если товар находится в стоп листе или не приходит при импорте меню, то он будет деактивирован.
3. Обнулять остатки у товаров не в наличии – если товар находится в стоп листе или не приходит при импорте меню, то остаток товара будет обнулен.
4. Отправлять заказы – если опция активна, заказы из магазина будут отправляться в iiko.

   Заметка

   Каждый заказ также можно отправить из раздела "Заказы" админ панели магазина, открыв нужный заказ и нажав на "Отправить" в секции iiko.

5. Передавать комментарий из заказа – если активна, в iiko будет передаваться комментарий из соответствующего поля в заказе.
6. Передавать название пункта выдачи – в комментарии к заказу будет добавляться пункт выдачи.
7. Передавать КЛАДР улицы – онлайн позволяет быстро найти необходимые сведения территориального объекта РФ, например, почтового индекса по адресу объекта. КЛАДР (Классификатор адресов Российской Федерации) – ведомственный классификатор ФНС России, созданный для распределения территорий между налоговыми инспекциями и автоматизированной рассылки корреспонденции.
8. Загружать модификаторы как товары – если опция активна, товары с типом "модификатор" будут добавляться в каталог сайта как отдельные карточки товаров. По умолчанию "модификаторы" в каталоге сайта не создаются. Подробнее в главе Модификаторы.
9. Рассчитывать скидку из iiko – используется при применении скидочных купонов, созданных в iiko, во время оформления заказа в магазине.

Об использовании вебхуков расскажем в главе ниже.

 

Настройки вебхуков

Заметка

Если в модуле отсуствуют настройки, проверьте корреткность указанного API-ключа.

Использование вебхуков необходимо для синхронизации заказов и бонусов. При активации настройки "Использовать вебхуки" появится таблица сопоставления статусов заказа магазина и статусов в iiko (рис. 13, п.1). Статусы из iiko прописываются вручную.


Рисунок 13.

Важно!

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

Для настройки синхронизации необходимо: 

• В настройках раздела "Доставка и оплата" указать метод оплаты для бонусной программы;
• Настроить webhook уведомления об изменении баланса в https://iiko.biz (бонусная iiko), вкладка "Настройки", далее вкладка "Webhookуведомления", кнопка "Изменить" (рис. 14).

Рисунок 14.

Откроется дополнительное окно, где необходимо указать "URL отправки webhook-уведомлений" и пароль (рис. 15).


Рисунок 15. 

Затем эти данные указываются в настройках модуля (рис. 13, п.2 и п.3).

Отправлять списание/пополнение бонусов из заказа – при активации настройки будут отправляться все транзакции по бонусной карте, но отправка заказов в iiko работать не будет.

 

Импорт каталога и заказов

Переходим на вкладку "Импорт" в настройках модуля. Доступны импорт каталога, товаров и заказов (рис. 16).

Рисунок 16.

Чтобы выгрузить товары и распределить их по нужным категориям после настройки модуля, требуется поочередно запустить эти процессы: сначала выгрузить категории, потом товары.
Также, если автоматическое обновление неактивно, с помощью импорта можно периодически обновлять каталог и товары. 

 

Модификаторы

Рассмотрим как работать с модификаторами, их особенностями и таблицей модификаторов.

На вкладке "Настройки" есть следующие настройки синхронизации модификаторов (рис. 17).

Рисунок 17.

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

Значение для выделения доп опций в модификаторах (Должно находиться в описании) – модификаторы можно записывать в качестве дополнительных опций товара. В этом поле задаётся ключевое слово из модификатора, по которому он будет записываться в дополнительную опцию.

Значение для выделения модификаций цвета в модификаторах (Должно находиться в описании) – модификаторы можно записывать в качестве модификаций цвет и размер. В этом поле задается ключевое слово из модификатора, по которому он будет записываться в дополнительную опцию. 

Заметка

Индивидуальные модификаторы могут быть изменены сейчас только внутри карточки товара.

На вкладке "Модификаторы" можно найти таблицу загруженных вместе с товарами групп модификаторов (рис. 18).

Рисунок 18.

При необходимости, группу модификаторов можно удалить в этой таблице нажав на крестик ✖. По нажатию на карандаш 🖉 откорется окно редактирования "Типа группы модификаторов" (рис. 19).

Рисунок 19.

По нажатию на название группы модификаторов, будет открыта таблица самих модификаторов (рис. 20).

Рисунок 20.

При необходимости, модификаторы можно удалить в этой таблице нажав на крестик ✖. Или поменять их порядок сортировки в соотвествующей 

 

Сопоставление методов доставки и оплаты

Во вкладке "Доставка и оплата" модуля можно связать методы доставки и оплаты между сайтом и iiko (рис. 21).

Рисунок 21.

Методы доставки – выставляется соответствие методов доставки в магазине и iiko.

Заметка

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

Чтобы загрузить методы оплаты, имеющиеся в iiko, нажимаем на кнопку "Импортировать методы оплаты".

В левом столбце выводятся методы доставки/оплаты на сайте; в правом – выпадающий список с методами в iiko. Чтобы выставить сопоставления, выбираем из выпадающих списков подходящие варианты и сохраняем настройки модуля.

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

Вы также можете привязывать к стоимости доставки определенные товары, которые будут добавляться в заказ после оформления (рис. 22).

Рисунок 22.

В поле "Стоимость доставки" указывается стоимость доставки, при которой будет добавлен товар. По кнопке "Привязать товар" откроется окно со списком товаров – в нем можно будет выбрать товар, который необходимо будет добавлять к заказу.

 

Купоны

Чтобы купоны iiko корректно работали, нужно убедиться, что настройка "Рассчитывать скидку из iiko" (рис. 11) включена. Далее, на вкладке модуля "Купоны" необходимо "Добавить купон" (рис. 23).

Рисунок 23.

По нажатию на кнопку, откроется окно добавления купона (рис. 24).

Рисунко 24.

Где нужно указать номер купона созданный на стороне iiko Biz (рис. 25).

Рисунок 25.

Интеграция через модуль iiko поддерживает фиксированные и процентные скидки, товары допродажи и подарок к заказу. После применения купона в корзине будут добавлены:

Подарок (рис. 26, п.1), все возможные скидки указанные в акции на стороне айко запишутся в сумму купона (рис. 26, п.2), а товары допродажи отобразяться внизу корзины (рис. 26, п.3).

Рисунок 26.

На этом мы завершаем разбор функционала и особенностей модуля.