Руководство по установке - Модуль Интеграция с iiko

1. Установка

2. Учетные данные iiko api

Перейдите в настройки модуля: Настройки > Настройки модулей > Интеграция с iiko. На вкладке «Авторизация» заполните поля «Логин iiko api », «пароль iiko api». Нажмите кнопку «Сохранить». Если учетные данные iiko api введены верно, после сохранения появятся остальные вкладки, в противном случае будет выдано сообщение об ошибке.

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

3. Службы доставки

Перейдите в административной части Магазин > Настройки > Службы доставки и создайте службы доставки «Самовывоз», «Доставка».

4. Платежные системы

Перейдите в административной части Магазин > Настройки > Платежные системы и создайте платежные системы «Оплата картой на сайте», «Наличными или картой курьеру», «Наличными или картой в ресторане». Для последних двух укажите «Тип оплаты»: «Наличными». На вкладке «Ограничения» укажите ограничения по службам доставки

Данный шаг может отличаться в зависимости от принимаемых типов оплат.

5. Создание свойств заказа

Перейдите в администратвной части Настройки > Настройки продукта > Список мастеров и запустите мастер «Создание свойств заказа для модуля «Интеграция с iiko» (grain:iiko.saleprops.create), при этом выберите существующий тип плательщика либо создайте новый.

После завершения мастера будут созданы необходимые свойства заказа и их символьные коды будут автоматически прописаны в настройках модуля на вкладке «Интернет-магазин».

Для многосайтовой конфигурации 1С-Битрикс предпочтительнее создавать новый тип плательщика.

6. Создание инфоблоков

Перейдите в административной части Контент > Инфоблоки и создайте следующие инфоблоки (а при необходимости также типы инфоблоков) для:

1. Инфоблок для хранения ресторанов. Данный инфоблок может быть системным, особенно если ресторан только один и его данные могут не выводится в публичной части, но они необходимы для синхронизации меню.
2. Инфоблок(и) для хранения меню для каждого ресторана. Настройте права доступа и автоматическое создание картинки анонса из детальной картинки. На вкладке «Торговый каталог» установите галочку «Является торговым каталогом». В настройках модуля «Торговый каталог» проверьте, что галочка «Разрешить покупку при отсутствии товара (включая разрешение отрицательного количества товара)» установлена.

Необходимые свойства инфоблоков будут созданы автоматически после настройки синхронизации.

7. Настройка синхронизации

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

Перейдите в настройки модуля: Настройки > Настройки модулей > Интеграция с iiko и выполните следующие действия:

1. На вкладке «Синхронизация ресторанов» выберите созданный инфоблок для хранения ресторанов. Нажмите кнопку «Сохранить». После обновления страницы, заново перейдите на вкладку «Синхронизация ресторанов» и в блоке синхронизации нажмите «Запланировать сейчас». Дождитесь выполнения синхронизации и обновите страницу (если агенты выполняются не на crontab, а на хитах, необходимо обновить страницу сразу же после запланированной синхронизации).

   

2. На вкладке «Синхронизация блюд» выберите созданный(е) инфоблок(и) для хранения меню и тип(ы) цен (а при необходимости создайте тип(ы) цен на странице административной части Магазин > Настройки > Цены > Типы цен). Нажмите кнопку «Сохранить». После обновления страницы, заново перейдите на вкладку «Синхронизация блюд» и в блоке синхронизации нажмите «Запланировать сейчас». Дождитесь выполнения синхронизации и обновите страницу.
3. Перейдите на вкладку «Синхронизация адресов» и при необходимости запланируйте синхронизацию.

8. Настройки выгрузки заказов iiko

Перейдите в настройки модуля: Настройки > Настройки модулей > Интеграция с iiko. На вкладке «Интернет-магазин» выполните следующие действия:

1. Установите галочку «Отправлять заказы в iiko».
2. Выберите тип плательщика.
3. Выберите платежные системы для онлайн оплаты. При выборе данных платежных систем при заказе, заказ будет отправляться в iiko только после совершения оплаты.
4. Выберите платежные системы (типы оплат) iiko, используемые для для оплаты на месте и для онлайн оплаты (а при их отсутствии запросите их создание у обслуживающей организации). Тип оплат должен иметь возможность выгрузки как уже совершенный.
5. Выберите службы доставки битрикс, используемые для доставки и самовывоза
6. Если вы планируете задавать скидки в системе 1С-Битрикс, настройте выгрузки скидок в iiko одним из двух способов: как скидку со свободной суммой или как совершенный платеж в заранее созданной платежной системе в iiko (для создания такой платежной системы или скидки со свободной суммой в системе iiko, обратитесь к обслуживающей организации)

9. Размещение компонентов

Перейдите в публичную часть сайта и создайте необходимые страницы и разместите компоненты. Все компоненты модуля находятся в дереве компонентов визуального редактора в разделе «Интеграция с iiko». Если данный раздел не появился, нажмите Компоненты > Обновить в над деревом компонентов. Для функционирования модуля необходимы 2 страницы:

1. Создайте страницу для размещения меню и разместите на ней компонент «Список блюд» («grain:iiko.section»). Выберите инфоблок с блюдами. В параметре «Количество элементов на странице» укажите значение 1000. Данный компонент отнаследован от стандартного компонента «Элементы раздела» («bitrix:catalog.section») и имеет аналогичные настройки.
2. Создайте страницу оформления заказа и разместите на ней компонент «Оформление заказа» («grain:iiko.order»). В параметрах компонента укажите путь к странице оплаты - странице с размещенным компонентом «Подключение платежной системы» («bitrix:sale.order.payment»).

Если в вашем шаблоне сайта отсутствует библиотека bootstrap не менее 4 версии, необходимо в параметрах компонентов установить галочку «Подключить библиотеку bootstrap (из ядра системы)»

10. Тестирование

Произведите тестирование настроенной системы. Логи синхронизаций и отправки заказов находятся в разделе административной части Сервисы > Интеграция с iiko > Журнал.

На время тестирования можно заблокировать отправку заказов в iiko, для этого установите константу (например, в файле /bitrix/php_interface/init.php):

define("GRAIN_IIKO_DO_NOT_POST_ORDERS",true);

Для запрета отправки заказов только для текущего сеанса, можно установить следующую переменную (например, через раздел административной части Настройки > Инструменты > Командная PHP-строка ):

$_SESSION["grain_iiko_do_not_post_orders"] = true;