Misea
Pro

Подключаем iiko — шаг за шагом

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

Подключаем iiko — шаг за шагом

Подключение занимает 10–20 минут, и почти всё это время уходит на то, чтобы найти в iiko четыре значения. Ниже — где они лежат.

Кто может это сделать: только владелец аккаунта Misea. На каком тарифе: Pro.

Если сейчас не до этого — в конце статьи есть раздел «Сделайте за меня»: вы оставляете телефон, вам перезванивают и подключают.

Что понадобится под рукой

  • Компьютер, с которого вы обычно заходите в iiko.
  • Письмо от iiko с адресом вашего сервера (или доступ к iikoOffice — адрес виден и там).
  • Логин и пароль сотрудника iiko, у которого есть право работать с внешними программами.

Шаг 1. Откройте раздел «Интеграции»

  1. В левом меню Misea нажмите Управление — раздел раскроется.
  2. Нажмите Интеграции.

Что вы увидите: страницу «Интеграции с системами учёта» с подписью «Подключите iiko, чтобы синхронизировать меню и столы». Наверху карточка «Статус iiko» — сейчас там написано «Не подключено» и «Требуется настройка». Ниже — блок «Подключение интеграции» с четырьмя шагами: Система → Данные доступа → Проверка → Синхронизация.

Если точек у вас больше одной, под заголовком блока будет ещё строка: «Это подключение — сервер „по умолчанию": обслуживает все точки. Серверы для отдельных точек — ниже». Это нормально, читайте дальше.

Шаг 2. Выберите систему

  1. Нажмите на карточку iiko («Популярная система учёта для HoReCa») — у неё появится подсветка.
  2. Нажмите «Далее» внизу справа.

Рядом есть карточка Quick Resto с меткой «Скоро» — она не нажимается, это нормально.

Шаг 3. Скажите, как вы открываете iiko

Misea спросит: «Как вы обычно открываете iiko в работе?» Выберите одну из трёх карточек:

  • 💻 «Через программу iikoOffice на компьютере в ресторане» — «У вас на рабочем столе есть иконка iikoOffice или iikoFront, программа запускается из меню „Пуск"». Это самый частый случай в России.
  • 🌐 «Через сайт iiko в браузере» — «Вы заходите в iiko через адрес в браузере, никакая программа не установлена».
  • 🛟 «Этим занимается вендор или айтишник» — откроется форма заявки, про неё раздел «Сделайте за меня» в конце статьи.

Под карточками Misea сама подсказывает: «Не уверены? Откройте iikoOffice — если такой программы у вас не установлено, выбирайте „через сайт"».

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

Ошиблись с выбором? Вверху формы с полями есть ссылка «← Изменить тип установки» — она вернёт вас к этим трём карточкам. Кнопка «Назад» внизу уводит на шаг «Система», а не сюда.

Вариант А. У вас iikoOffice на компьютере

Наверху формы написано: «Введите 4 значения из iiko. Не знаете где их найти? Нажмите „📷 Покажите где это" рядом с каждым полем». Такая кнопка есть у трёх полей из четырёх (логин и пароль делят одну подсказку) — она открывает картинки с пояснениями.

Все четыре поля обязательные, у каждого стоит красная звёздочка *.

Поле 1. «URL сервера iiko»

Так поле подписано на экране — не «адрес», а именно URL сервера iiko. Это адрес, по которому Misea будет стучаться в вашу кассовую программу.

Где взять: iiko присылает его письмом, строкой «Домен» — выглядит примерно так: https://670-063-303.iiko.it. Ровно такая подсказка стоит серым внутри поля. Этот же адрес видно в адресной строке iikoOffice при подключении.

Можно вставить и с хвостом /resto, и без него — оба варианта Misea поймёт. Если забыли написать https://, она подставит его сама, как только вы уйдёте из поля.

Никакой подтверждающей строки под полем не появится — Misea не проверяет адрес на лету и не пишет «подключимся к…». Правильность адреса выяснится только на шаге «Проверка», так что не ждите здесь никакой реакции: её не будет.

Если сервер iiko стоит прямо у вас в заведении, впишите его адрес вместе с портом — например, http://192.168.1.10:8080.

Поля 2 и 3. «Логин сотрудника iiko» и «Пароль»

Это не ваш личный пароль от чего угодно, а учётная запись сотрудника внутри iiko, которому разрешено работать с внешними программами. Под этими полями Misea так и пишет: «Это тот сотрудник iiko, у которого в карточке стоит галка „доступ к API"».

Где взять:

  1. Откройте iikoOffice.
  2. Зайдите в раздел «Сотрудники».
  3. Найдите сотрудника, у которого в правах стоит галка «Доступ к API» (в некоторых версиях она называется «доступ к интеграциям»).
  4. Его логин впишите в поле «Логин сотрудника iiko», пароль — в поле «Пароль».

Если такой галки нет ни у кого — поставьте её сами тому сотруднику, чей логин собираетесь использовать (обычно это администратор или менеджер), сохраните карточку и используйте эти логин и пароль.

Поле 4. «API-логин iikoCloud»

Это отдельный ключ, который iiko выдаёт для обмена заказами. Без него Misea не сможет отправлять заказы с сайта на кассу и не увидит стоп-лист, поэтому поле обязательное.

Где взять:

  1. Откройте iikoOffice.
  2. В левом меню нажмите «Администрирование».
  3. Выберите пункт «Внешние сервисы» — откроется список внешних подключений.
  4. Нажмите «Создать», в типе выберите «Внешние заказы», в имени напишите, например, Misea, и сохраните.
  5. В карточке созданной записи найдите поле «API Login» и скопируйте его целиком.

Что вы увидите: строку из 32 символов — цифры и латинские буквы, без пробелов, например 63c3141faf914eedb097af182dcc9286. Ровно эта строка стоит серым внутри поля как образец.

Если под полем появилась надпись «Обычно 32 hex-символа без пробелов. Проверьте, что скопировали значение полностью» — значит вы скопировали не всё или прихватили лишний пробел. Скопируйте ещё раз. Это подсказка, а не запрет: кнопка «Далее» продолжит работать, но на проверке связь не поднимется.

Вариант Б. Вы заходите в iiko через браузер

Поле будет одно — «API-логин из iiko», тоже обязательное.

Где взять:

  1. Зайдите в iikoWeb (или iiko.biz) под учётной записью владельца ресторана.
  2. В левом меню откройте раздел «Приложения».
  3. Нажмите «Добавить приложение», впишите имя (например, Misea) и сохраните.
  4. В карточке созданного приложения скопируйте «API Login» — те же 32 символа.

Шаг 4. Проверьте соединение

  1. Нажмите «Далее».
  2. На шаге «Проверка» вы увидите строку «Проверим, что данные верны и система доступна. После успешной проверки перейдём к синхронизации».
  3. Нажмите «Проверить соединение».

Кнопка «Проверить соединение» серая и не нажимается? Значит вы заполнили не все поля. Под кнопкой в этом случае написано «Заполните данные доступа на шаге 2». Нажмите «Назад» и допишите пропущенное — для варианта А нужны все четыре значения. Если попробовать двинуться дальше с пустыми полями, Misea покажет предупреждение «Заполните URL сервера, логин, пароль и iikoCloud apiLogin».

Проверка занимает до полуминуты — кнопка на это время меняет надпись на «Проверяем...».

Что будет при успехе: в правом верхнем углу всплывёт зелёное уведомление «Подключено» с пояснением «Запустили первичный импорт: точки, сотрудники, меню. Это займёт пару минут». Мастер сам перейдёт на шаг «Синхронизация», а карточка наверху страницы сменится на «Подключено». Уведомление живёт несколько секунд и пропадает — если вы отвлеклись и не увидели его, смотрите на карточку «Статус iiko» вверху.

Что будет при отказе: под кнопкой появится плашка с объяснением. Тексты на экране такие:

  • «Неверный логин или пароль iiko. Проверьте — это тот сотрудник, у которого в карточке iikoOffice стоит „доступ к API"?»
  • «У сотрудника нет прав на API. В iikoOffice → Сотрудники → карточка сотрудника отметьте „доступ к интеграциям"».
  • «API-логин не подходит. Скопируйте его ещё раз — там 32 символа без пробелов».
  • «Не достучались до сервера iiko. Проверьте, что URL начинается с https:// и сервер сейчас включён».

В этих четырёх случаях в плашке будет кнопка «← Поправить данные» — она вернёт вас прямо к полям.

Если Misea не смогла разобрать, что именно не так, текст будет общий: «Проверка соединения не удалась. Если не получается — нажмите „Помогите подключить" и мы сделаем за вас», а кнопка в плашке будет другая — «🛟 Помогите подключить». Она открывает ту же форму заявки, что описана в конце статьи.

Шаг 5. Обязательно проверьте, что данные реально приехали

Это важнее, чем предыдущий шаг, и вот почему: надпись «Подключено» ещё не доказывает, что логин и пароль верные. На проверке Misea лишь запрашивает у iiko список столов, а iiko на неверный доступ иногда отвечает не ошибкой, а пустым списком. Со стороны это выглядит как успех.

Настоящая проверка — глазами, через 5–10 минут после подключения:

  1. Откройте Управление → Точки. Там должны появиться ваши заведения из iiko.
  2. Откройте Команда → Сотрудники. Там должны появиться люди из iiko.
  3. Откройте Каталог → Меню и нажмите «Синхронизироваться с кассой» вверху справа. Кнопка сменит надпись на «Синхронизирую…», рядом появится серая строка «Идёт в фоне — можно покинуть страницу», а через минуту-другую в списке появятся ваши блюда.

Если везде пусто — доступы неверные, даже если написано «Подключено». Вернитесь на шаг 4 и введите данные заново или оставьте заявку (см. ниже).

Шаг 6. Загрузите меню и столы, включите мгновенные события

На шаге «Синхронизация» в мастере написано: «Загрузите меню и столы в Misea. Меню нужно синхронизировать в первую очередь». Там две кнопки, и они ведут себя по-разному.

  1. «Импорт меню из POS →» — это не кнопка, а переход: она уводит вас со страницы «Интеграции» в раздел Каталог → Меню. Так и задумано, под кнопкой это написано: «Импорт меню теперь в разделе „Товары": предпросмотр, автоматическая нормализация категорий и подтверждение перед сохранением». Оказавшись в «Товарах», нажмите там «Синхронизироваться с кассой». Чтобы вернуться к мастеру, снова откройте Управление → Интеграции — он останется на том же шаге.
  2. «Синхронизировать столы» — работает прямо здесь. Что вы увидите: кнопка сменит надпись на «Синхронизация...», побежит полоса прогресса с подписями «Подключение → Меню → Обработка → Готово», а затем под ней появится строка вида «Столы: загружено 12.» и уведомление «Столы синхронизированы». Столы понадобятся для QR-кодов.
  3. Галка «Синхронизировать столы автоматически каждый час» оставляется на ваше усмотрение: она нужна, только если вы часто двигаете столы в iiko.

Ниже кнопок Misea показывает итог последней загрузки строкой «Последний раз: категорий 24, товаров 163, столов 32» — по ней и видно, приехало что-нибудь или нет.

Затем поднимитесь к карточке «Мгновенные события из iiko» и нажмите «Включить» — с ней стоп-лист и смены будут приезжать за секунды, а не за минуты. Что вы увидите: кнопка на секунду станет «Подключаемся…», потом всплывёт «Подписка активирована: 1 точек», а надпись в карточке сменится с «Не включено» на «Включено». Подробнее — в статье iiko и Misea: что и куда переезжает.

Если точек несколько, а серверов iiko — тоже несколько

Обычно один сервер iiko обслуживает всю сеть, и тогда ничего делать не надо: подключение, которое вы только что сделали, работает на все точки. Misea так и пишет внизу блока: «Сейчас все точки работают через один сервер — это нормально. Свой сервер нужен, только если у точки отдельный iiko».

Если у какой-то точки свой отдельный сервер iiko (другой адрес, другие доступы):

  1. Прокрутите страницу «Интеграции» вниз до блока «Серверы iiko по точкам».
  2. Нажмите «+ Подключить сервер точки». Кнопка сменит надпись на «Отмена» — это значит форма раскрылась ниже.
  3. Выберите точку из списка «Точка».
  4. Дальше — те же вопросы и те же поля, что на шагах 3–4 выше.
  5. Нажмите «Проверить соединение», затем «Подключить сервер».

Что вы увидите: точка появится в списке со статусом «● Работает» и строкой «Меню обновлялось …» (или «Ещё не синхронизировалось», пока меню не приезжало).

Баллы и программа лояльности при этом остаются общими на всю сеть — они не делятся по серверам.

Как отключить такой сервер. В строке каждого сервера есть кнопка «Изменить». Кнопка «Удалить» появляется только у серверов отдельных точек — у самой верхней строки с меткой «По умолчанию» её нет и быть не должно: это ваше основное подключение, его отключают не отсюда, а перенастройкой мастера. Нажав «Удалить», подтвердите: точка переключится на основной сервер, а если тот её не обслуживает — перестанет синхронизироваться совсем. Меню и чеки при этом никуда не денутся.

Сделайте за меня

Если на любом шаге стало непонятно — не мучайтесь.

  1. Нажмите «🛟 Нужна помощь с подключением?» внизу блока (кнопка есть на любом шаге).
  2. Откроется окно с пояснением: «Оставьте контакты — наш менеджер перезвонит и подключит iiko за вас. Доступ к iikoOffice или контакт вашего вендора пригодится при разговоре».
  3. Заполните форму. Со звёздочкой * только два поля — «Имя» и «Телефон»; «Email» подписан «(если нужно)», «Код AnyDesk» — «(если установлен)». В списке «Удобное время» уже стоит «В любое время», можно поменять на «Будни днём (10:00–18:00)», «Будни вечером (18:00–22:00)» или «Выходные».
  4. Если у вас установлена программа удалённого доступа AnyDesk, впишите её код — тогда подключим всё сами, без созвона.
  5. Нажмите «Отправить заявку».

Что вы увидите: «Спасибо! Перезвоним в течение 1 рабочего дня» и строку «Запрос #…» с номером. Рядом появятся кнопки «Хочу попробовать сам» (вернуться к мастеру) и «Закрыть».

Кнопка «Отправить заявку» серая. Значит имя короче двух букв или в телефоне меньше семи цифр — Misea так и напишет под полем: «Имя должно быть от 2 символов», «Телефон должен содержать минимум 7 цифр».

«Слишком много заявок за сутки». Заявку в этот день уже отправляли. Напишите на support@misea.ru — адрес есть в самом сообщении.

Куда смотреть дальше