На данном веб-сайте используются файлы cookie. Продолжая просматривать наш веб-сайт, вы соглашаетесь с использованием файлов cookie. Подробнее об использовании файлов cookie.
Документация
Полная информация для оперативного решения ваших вопросов
Интеграция Гутакса с iiko
Iiko — одна из самых популярных программ для автоматизации ресторанов, кафе, баров. Это комплексная программа контроля и управления заказами, работой персонала, складом и ассортиментом, движением средств, доставкой. Хранит историю, статистику заказов, прибыли и помогает владельцу видеть полную картину бизнеса. Гутакс выступает в качестве проводника и обменника информацией c iiko и передает информацию через API-ключ.
Для чего нужна интеграция сайта и приложения с iiko:
- Для актуализации меню и формирования единой базы управления заказами. Регулярная синхронизация и обновление каталога товаров с фото, ценами. Если изменяется что-то в iiko, автоматически информация также меняется на сайте и в приложении.
- Синхронизация заказов и обновление статусов. Заказ клиента с сайта или приложения автоматически отправляется в iiko, работники ресторана видят его и начинают работу. Когда статус заказа меняется, мы автоматически показываем это клиенту в приложении.
- Управление программой лояльности и бонусной системой. Клиент может пользоваться бонусами офлайн в ресторане и онлайн в приложении или на сайте. При оформлении заказа мы запрашиваем текущие бонусы из программы iiko и даем возможность использовать их при заказе.
С какими модулями iiko интеграция:
1. С iiko.transport синхронизируем и обновляем меню, каталог товаров, управляем заказами, отслеживаем статус заказов и наполнение приложения, сайта новыми товарами. При интеграции с данным модулем необходимо, чтобы доставочный терминал в заведении (тот, на который будут приходить заказы с доставки), работал в круглосуточном режиме, компьютер не должен уходить в спящий режим, интернет должен быть стабильным. Иначе, заказы, поступившие в Гутакс в то время, когда терминал недоступен, не попадут в iiko.
2. С iiko.card управляем бонусной системой и выстраиваем отношения с постоянными посетителями, настраиваем систему лояльности.
Общая схема
Гутакс и dadata. Dadata преобразует адреса к единому формату. Интеграция нужна для доставки еды, составления маршрута, хранения данных клиента.
Гутакс и мобильное приложение, сайт. На сайте или в приложении клиенты формируют заказы, оформляют доставку, оплачивают. Тем временем Гутакс хранит и отображает каталог товаров, цены, различные параметры товаров, способ оплаты, доставки и другие настройки для заказа, синхронизирует их с iiko.
Если при заказе клиентом, Гутакс не смог связаться с iiko в течение 15 секунд и передать заказ, включается повторная отправка заказа. Также Гутакс перенаправляет не отправленные заказы на резервный адрес электронной почты или в Телеграм.
Изначально все настройки формируются в платформе Гутакс, а потом клиенты их видят на сайте и в приложении.
Гутакс и мобильное приложение, сайт. На сайте или в приложении клиенты формируют заказы, оформляют доставку, оплачивают. Тем временем Гутакс хранит и отображает каталог товаров, цены, различные параметры товаров, способ оплаты, доставки и другие настройки для заказа, синхронизирует их с iiko.
Если при заказе клиентом, Гутакс не смог связаться с iiko в течение 15 секунд и передать заказ, включается повторная отправка заказа. Также Гутакс перенаправляет не отправленные заказы на резервный адрес электронной почты или в Телеграм.
Изначально все настройки формируются в платформе Гутакс, а потом клиенты их видят на сайте и в приложении.
Настройка автоматической интеграции на примере 1-й точки заведения в 1-м городе в Панели управления Гутакс
В разделе Справочники находим пункт Обмен заказами, через который подключается и настраивается pos-система для конкретного города. Если заведения находятся в разных городах, тогда для каждого нужного настроить подключение. Чтобы добавить pos-систему нажимаем кнопку Добавить и выбираем из списка iiko. Далее заполняем поля. Поля, отмеченные звездочкой обязательны к заполнению.
Название — название точки, для которой настраиваем интеграцию с iiko, рекомендуем не более 20 символов;
Город — город, в котором находится заведение;
Профессия — основное направление доставки;
Сортировка — нужна для расположения элементов в нужном вам порядке. Чем меньше значение, тем выше элемент в списке. Укажите любое число от 0 до 500;
Параметры интеграции — как будет работать интеграция, что передавать с помощью интеграции. Варианты:
Город — город, в котором находится заведение;
Профессия — основное направление доставки;
Сортировка — нужна для расположения элементов в нужном вам порядке. Чем меньше значение, тем выше элемент в списке. Укажите любое число от 0 до 500;
Параметры интеграции — как будет работать интеграция, что передавать с помощью интеграции. Варианты:
-
Автоматически синхронизировать товары — cинхронизировать товары, стоп-листы, отправлять и получать заказы.
Обновлять профиль клиента — обновлять профиль клиента, работать с бонусами клиента. - Обновлять описание — обновлять только описание товаров.
- Обновлять картинки — обновлять только фото товаров.
Секретный ключ Dadata.ru — секретный ключ из Личного кабинета dadata.ru
После заполнения всех полей нажимаем Сохранить.
Подключение iiko к Гутакс
Переходим для этого в раздел Магазины — Поставщики, вкладка Адреса поставщика. На вкладке указаны все адреса заведений. Чтобы добавить новый адрес, нажимаем кнопку Добавить. В открывшемся окне заполняем поля:
Название — название точки.
Улица или место — адрес заведения.
Дом — номер дома.
Стр/корп. — номер строения.
Подъезд — номер подъезда.
Кв./офис — номер квартиры или офиса.
Время приема заказов — устанавливаем прием заказов на каждый день с учетом готовки и доставки. Если время приема на какой либо день не установить, то прием заказов в этот день будет недоступен (например, если заведение не работает в выходные дни).
Режим работы адреса — указываем, если хотим, чтобы режим работы отображался в приложении для клиента. Режим работы адреса может быть отличен от режима приема заказов, т.к. не учитывает время готовки и отображается, для того, чтобы клиенты могли посетить заведение.
Тип доставки — выбираем тип доставки: доставка, самовывоз, в ресторане.
Отправить заказ — параметр принятия заказов в заведении. Принимать заказы можно через почту, telegram или во внешнюю систему. Для настройки интеграции выбираем — Во внешнюю систему.
Программа — выбираем Iiko Transport
Api Login — для работы интеграции необходим API-ключ для подключения: логин (User Id) из модуля Iiko Transport. После ввода API-ключа нужно получить идентификатор ресторана и доставочного терминала. Для этого нажимаем на ссылки Получить ИД ресторана и Получить ИД терминала.
Идентификатор ресторана — устанавливаем полученный идентификатор. Если ресторанов несколько, убеждаемся, что наименование идентификатора совпадает с названием ресторана.Название — название точки.
Улица или место — адрес заведения.
Дом — номер дома.
Стр/корп. — номер строения.
Подъезд — номер подъезда.
Кв./офис — номер квартиры или офиса.
Время приема заказов — устанавливаем прием заказов на каждый день с учетом готовки и доставки. Если время приема на какой либо день не установить, то прием заказов в этот день будет недоступен (например, если заведение не работает в выходные дни).
Режим работы адреса — указываем, если хотим, чтобы режим работы отображался в приложении для клиента. Режим работы адреса может быть отличен от режима приема заказов, т.к. не учитывает время готовки и отображается, для того, чтобы клиенты могли посетить заведение.
Тип доставки — выбираем тип доставки: доставка, самовывоз, в ресторане.
Отправить заказ — параметр принятия заказов в заведении. Принимать заказы можно через почту, telegram или во внешнюю систему. Для настройки интеграции выбираем — Во внешнюю систему.
Программа — выбираем Iiko Transport
Api Login — для работы интеграции необходим API-ключ для подключения: логин (User Id) из модуля Iiko Transport. После ввода API-ключа нужно получить идентификатор ресторана и доставочного терминала. Для этого нажимаем на ссылки Получить ИД ресторана и Получить ИД терминала.
Идентификатор доставочного терминала — устанавливаем полученный идентификатор. Если терминалов несколько, убеждаемся, что наименование и адрес терминала совпадает с названием точки, которую настраиваем.
Папки, из которых получать товары — устанавливаем ссылку на папку с товарами для доставки из модуля Iiko Transport
Наличные — поле для идентификатора оплаты наличными, если настроен в ресторане. Нажимаем на ссылку Получить типы оплаты. Идентификаторы подключают данные, которые уже есть в iiko заведения и передают их в Гутакс. Если в заведении подключены все типы оплаты, то и в Гутакс они отобразятся. Например, если только наличные, то отобразится идентификатор типа оплаты Наличные.
Картой курьеру — поле для идентификатора оплаты картой по приходу курьера.
Бонусами — поле для идентификатора оплаты бонусами.
Онлайн оплата — поле для идентификатора оплаты онлайн.
Id товара «доставка» — устанавливаем id товара «доставка», созданного специально в iiko для добавления к сумме заказа стоимости доставки, рассчитанной на сервере Гутакс.
Картой курьеру — поле для идентификатора оплаты картой по приходу курьера.
Бонусами — поле для идентификатора оплаты бонусами.
Онлайн оплата — поле для идентификатора оплаты онлайн.
Id товара «доставка» — устанавливаем id товара «доставка», созданного специально в iiko для добавления к сумме заказа стоимости доставки, рассчитанной на сервере Гутакс.
Отправлять кнопки — если настроена дополнительная отправка заказа в telegram, и активирована данная настройка, то в чат-боте будут отображаться кнопки: Принят, Выполнен, оплачен и Отменен. При нажатии сотрудником заведения на эти кнопки в чате под заказов, статус заказа будет изменятся в Панели управления, что позволяет клиенту быстро получать информацию о статусе его заказа.
Дополнительно отправить — параллельная отправка заказа с тремя вариантами: отправить в случае ошибки передачи во внешнюю систему, отправлять всегда или не отправлять.
Отправить в — если выбираем почту, нужно внести адрес электронной почты. Если выбираем telegram — вводим токен телеграмм бота, ID чата в телеграмм.
Телефон — поле для номера телефона, на который можно отправить заказ.
После того, как заполнены все поля, нажимаем Сохранить.
Дополнительно отправить — параллельная отправка заказа с тремя вариантами: отправить в случае ошибки передачи во внешнюю систему, отправлять всегда или не отправлять.
Отправить в — если выбираем почту, нужно внести адрес электронной почты. Если выбираем telegram — вводим токен телеграмм бота, ID чата в телеграмм.
Телефон — поле для номера телефона, на который можно отправить заказ.
После того, как заполнены все поля, нажимаем Сохранить.
Параметры передачи заказа в разделе Настройки — Заказы
В этой вкладке настраиваем каждый город, в котором находится заведение. Переходим в раздел Заказы — поле Показывать в карточке заказа в приложении, на сайте, у исполнителей и выбираем, как будет отображаться номер заказа у клиента.
- Порядковый номер заказа
- Буквенно-цифровой код заказа
- Номер заказа из внешней системы (номер из iiko)
Далее переходим в раздел Обмен заказами — Передавать заказ в другую систему.
Выбираем способ обмена заказами:
- Вручную;
- Сразу после создания заказа;
- Через определенное количество времени.
От выбранного пункта будет зависеть передача заказов в iiko. После настройки интеграции автоматически синхронизируется меню в iiko и каталог товаров в Гутакс. Клиент видит конечный результат синхронизации на сайте и в приложении. Для сети заведений настраиваем интеграцию для каждого города по этому же принципу.
Синхронизация с iiko transport
Далее обновляем подключение (в айко офис во вкладке Состояние подключения нажимаем Перезапуск очередей) и выгружаем меню (вкладка Обмен данными — Выгрузка меню — Выгрузить).
|
Затем, если есть сайт, то выполняем принудительную синхронизацию Панели управления Гутакс и сайта.