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

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

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

• Установка и базовая настройка модуля
• Настройки обновления товаров
• Настройки обновления заказов
• Настройки вебхук
• Сопоставление методов доставки и оплаты

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

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

Рисунок 1.

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

Рисунок 2.

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


Рисунок 3.

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

Рисунок 4.

Рассмотрим подробнее общие настройки.

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

Организация в зависимости от метода доставки  - если на стороне iiko действует несколько организаций (например, ресторан, кафе, пицца) можно для каждого метода указать для какой организации он будет действовать.

Ручная скидка - применение той скидки, которая установлена на стороне iiko. При активации настройки появится дополнительная настройка "Отправлять оплату бонусами как скидку" (рис.5).


Рисунок 5.

Источник товаров - опция влияет на выгрузку товаров. Из списка нужно выбрать, что выгружать в качестве категорий из iiko.

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

Рисунок 6.

Поэтому при настройка источника товаров, если работа производится через iikoWeb, то необходимо выбирать как источник "Внешнее меню" (рис.7). При данном выборе изменятся настройки далее.  Подгрузится пункт "Меню", соответственно в выплывающем списке будут выводится списки меню которые созданы на стороне iiko. 

Рисунок 7.

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

Источник категорий - опция влияет на выгрузку товаров. Из списка нужно выбрать, что выгружать в качестве категорий из iiko - группы, категории или выгружать товары без категорий (рис.8).

Рисунок 8.

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

Рисунок 9.

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

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

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

Рисунок 10.

Настройки обновления заказа
Из магазина в iiko передаются заказы. Рассмотрим подробнее настройки (рис.11).

Рисунок 11.

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

Передавать комментарий из заказа - если активна, в iiko будет передаваться комментарий из соответствующего поля в заказе.

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

Передавать КЛАДР улицы - онлайн позволяет быстро найти необходимые сведения территориального объекта РФ, например, почтового индекса по адресу объекта.
КЛАДР (Классификатор адресов Российской Федерации) — ведомственный классификатор ФНС России, созданный для распределения территорий между налоговыми инспекциями и автоматизированной рассылки корреспонденции.

Отображать на странице оформления заказа поле "Количество персон"

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

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

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


Рисунок 12.

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

- В настройках раздела "Доставка и оплата" указать метод оплаты для бонусной программы;

- Настроить webhook уведомления об изменении баланса в https://iiko.biz (бонусная iiko), вкладка "Настройки", далее вкладка "Webhookуведомления", кнопка "Изменить" (рис.13).

Рисунок 13.

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


Рисунок 14. 

Эти данные берутся из настроек модуля iiko (рис.12, п.2 и п.3).

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

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

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

Рисунок 15.

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

Также, если автоматическое обновление неактивно, с помощью импорта можно периодически обновлять каталог и товары. 

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

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

Рисунок 16.

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

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

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

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

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

Рисунок 17.

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

Все готово. На этом мы рассмотрели, как настроить интеграцию сайта с системой iiko.