Документация

Полная информация для оперативного решения ваших вопросов

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

Iiko — одна из самых популярных программ для автоматизации ресторанов, кафе, баров. Это комплексная программа контроля и управления заказами, работой персонала, складом и ассортиментом, движением средств, доставкой. Хранит историю, статистику заказов, прибыли и помогает владельцу видеть полную картину бизнеса. Гутакс выступает в качестве проводника и обменника информацией c iiko и передает информацию через API-ключ.

Для чего нужна интеграция сайта и приложения с iiko:

  • Для актуализации меню и формирования единой базы управления заказами. Регулярная синхронизация и обновление каталога товаров с фото, ценами. Если изменяется что-то в iiko, автоматически информация также меняется на сайте и в приложении.
  • Синхронизация заказов и обновление статусов. Заказ клиента с сайта или приложения автоматически отправляется в iiko, работники ресторана видят его и начинают работу. Когда статус заказа меняется, мы автоматически показываем это клиенту в приложении.
  • Управление программой лояльности и бонусной системой. Клиент может пользоваться бонусами офлайн в ресторане и онлайн в приложении или на сайте. При оформлении заказа мы запрашиваем текущие бонусы из программы iiko и даем возможность использовать их при заказе.

С какими модулями iiko интеграция:

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

2. С iiko.card управляем бонусной системой и выстраиваем отношения с постоянными посетителями, настраиваем систему лояльности.

Общая схема

Гутакс и dadata. Dadata преобразует адреса к единому формату. Интеграция нужна для доставки еды, составления маршрута, хранения данных клиента.
Гутакс и мобильное приложение, сайт. На сайте или в приложении клиенты формируют заказы, оформляют доставку, оплачивают. Тем временем Гутакс хранит и отображает каталог товаров, цены, различные параметры товаров, способ оплаты, доставки и другие настройки для заказа, синхронизирует их с iiko.
Если при заказе клиентом, Гутакс не смог связаться с iiko в течение 15 секунд и передать заказ, включается повторная отправка заказа. Также Гутакс перенаправляет не отправленные заказы на резервный адрес электронной почты или в Телеграм.
Изначально все настройки формируются в платформе Гутакс, а потом клиенты их видят на сайте и в приложении.

Настройка автоматической интеграции на примере 1-й точки заведения в 1-м городе в Панели управления Гутакс

В разделе Справочники находим пункт Обмен заказами, через который подключается и настраивается pos-система для конкретного города. Если заведения находятся в разных городах, тогда для каждого нужного настроить подключение. Чтобы добавить pos-систему нажимаем кнопку Добавить и выбираем из списка iiko. Далее заполняем поля. Поля, отмеченные звездочкой обязательны к заполнению.


Название — название точки, для которой настраиваем интеграцию с iiko, рекомендуем не более 20 символов;
Город — город, в котором находится заведение;
Профессия — основное направление доставки;
Сортировка — нужна для расположения элементов в нужном вам порядке. Чем меньше значение, тем выше элемент в списке. Укажите любое число от 0 до 500;
Параметры интеграции — как будет работать интеграция, что передавать с помощью интеграции. Варианты:
  • Автоматически синхронизировать товары — cинхронизировать товары, стоп-листы, отправлять и получать заказы.
    Обновлять профиль клиента — обновлять профиль клиента, работать с бонусами клиента.
  • Обновлять описание — обновлять только описание товаров.
  • Обновлять картинки — обновлять только фото товаров.
API-ключ Dadata.ru — API-ключ с сервиса Dadata необходим для перевода адресов в единый формат и добавления их в заказы. Если к единому  формату не привести, не будет правильного распознавания адресов, и заказы не дойдут до клиентов. Подробная статья, как получить ключ с сервиса по ссылке: Как получить API-ключ
Секретный ключ Dadata.ru — секретный ключ из Личного кабинета dadata.ru
После заполнения всех полей нажимаем Сохранить.

Подключение iiko к Гутакс 

Переходим для этого в раздел Магазины — Поставщики, вкладка Адреса поставщика. На вкладке указаны все адреса заведений. Чтобы добавить новый адрес, нажимаем кнопку Добавить. В открывшемся окне заполняем поля:
Название — название точки.
Улица или место — адрес заведения.
Дом — номер дома.
Стр/корп. — номер строения.
Подъезд — номер подъезда.
Кв./офис — номер квартиры или офиса.
Время приема заказов — устанавливаем прием заказов на каждый день с учетом готовки и доставки. Если время приема на какой либо день не установить, то прием заказов в этот день будет недоступен (например, если заведение не работает в выходные дни).


Режим работы адреса — указываем, если хотим, чтобы режим работы отображался в приложении для клиента. Режим работы адреса может быть отличен от режима приема заказов, т.к. не учитывает время готовки и отображается, для того, чтобы клиенты могли посетить заведение.
Тип доставки — выбираем тип доставки: доставка, самовывоз, в ресторане.
Отправить заказ — параметр принятия заказов в заведении. Принимать заказы можно через почту, telegram или во внешнюю систему. Для настройки интеграции выбираем — Во внешнюю систему.
Программа — выбираем Iiko Transport
Api Login — для работы интеграции необходим API-ключ для подключения: логин (User Id) из модуля Iiko Transport. После ввода API-ключа нужно получить идентификатор ресторана и доставочного терминала. Для этого нажимаем на ссылки Получить ИД ресторана и Получить ИД терминала.
Идентификатор ресторана — устанавливаем полученный идентификатор. Если ресторанов несколько, убеждаемся, что наименование идентификатора совпадает с названием ресторана.
Идентификатор доставочного терминала — устанавливаем полученный идентификатор. Если терминалов несколько, убеждаемся, что наименование и адрес терминала совпадает с названием точки, которую настраиваем.
Папки, из которых получать товары — устанавливаем ссылку на папку с товарами для доставки из модуля Iiko Transport

Наличные — поле для идентификатора оплаты наличными, если настроен в ресторане. Нажимаем на ссылку Получить типы оплаты. Идентификаторы подключают данные, которые уже есть в iiko заведения и передают их в Гутакс. Если в заведении подключены все типы оплаты, то и в Гутакс они отобразятся. Например, если только наличные, то отобразится идентификатор типа оплаты Наличные.
Картой курьеру — поле для идентификатора оплаты картой по приходу курьера.
Бонусами — поле для идентификатора оплаты бонусами.
Онлайн оплата — поле для идентификатора оплаты онлайн.
Id товара «доставка»  — устанавливаем id товара «доставка», созданного специально в iiko для добавления к сумме заказа стоимости доставки, рассчитанной на сервере Гутакс. 

Отправлять кнопки — если настроена дополнительная отправка заказа в telegram, и активирована данная настройка, то в чат-боте будут отображаться кнопки: Принят, Выполнен, оплачен и Отменен. При нажатии сотрудником заведения на эти кнопки в чате под заказов, статус заказа будет изменятся в Панели управления, что позволяет клиенту быстро получать информацию о статусе его заказа. 
Дополнительно отправить — параллельная отправка заказа с тремя вариантами: отправить в случае ошибки передачи во внешнюю систему, отправлять всегда или не отправлять.
Отправить в — если выбираем почту, нужно внести адрес электронной почты. Если выбираем telegram — вводим токен телеграмм бота, ID чата в телеграмм.
Телефон — поле для номера телефона, на который можно отправить заказ.
После того, как заполнены все поля, нажимаем Сохранить.

Параметры передачи заказа в разделе Настройки — Заказы 

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

  • Порядковый номер заказа
  • Буквенно-цифровой код заказа
  • Номер заказа из внешней системы (номер из iiko)

Далее переходим в раздел Обмен заказами — Передавать заказ в другую систему.

Выбираем способ обмена заказами:

  • Вручную;
  • Сразу после создания заказа;
  • Через определенное количество времени.

От выбранного пункта будет зависеть передача заказов в iiko. После настройки интеграции автоматически синхронизируется меню в iiko и каталог товаров в Гутакс. Клиент видит конечный результат синхронизации на сайте и в приложении. Для сети заведений настраиваем интеграцию для каждого города по этому же принципу.

Синхронизация с iiko transport

Далее обновляем подключение (в айко офис во вкладке Состояние подключения нажимаем Перезапуск очередей) и выгружаем меню (вкладка Обмен данными — Выгрузка меню — Выгрузить).


Затем, если есть сайт, то выполняем принудительную синхронизацию Панели управления Гутакс и сайта.

Заказать звонок

Заполните ваши контактные данные, и мы свяжемся с вами в ближайшее время

Нажимая кнопку Отправить, я принимаю политику конфиденциальности

Успешно

Данные отправлены.
Мы свяжемся с вами в ближайшее время.

Закрыть

Попробуйте бесплатно

Заполните ваши контактные данные, и мы свяжемся с вами в ближайшее время

Нажимая кнопку Отправить, я принимаю политику конфиденциальности

Успешно

Данные отправлены.
Мы свяжемся с вами в ближайшее время.

Закрыть

Попробовать

Оставить заявку