Сеть из нескольких точек
Главное в двух строках: ключ iiko один на всю сеть, вводишь его в Нямбот один раз. Точки различаются организациями — их iiko отдаёт по тому же ключу.
Шаг 1. Сначала в iikoWeb#
Открой «Настройки Cloud API» → свою интеграцию → вкладку «Подключенные точки» и добавь туда все рестораны сети.
Это не формальность: точки, которой нет во вкладке, Нямбот не увидит вовсе, а iiko на любой запрос по ней ответит ошибкой «doesn't belong to your api login included organization list». Если организация не появилась в мастере — почти всегда причина здесь.
Внешнее меню и источник цен#
В той же карточке интеграции задаётся, откуда берутся цены. Вариантов два:
- Одно меню на сеть + ценовые категории — обычный случай. Структура меню общая, а цены у точек разные: «Центр» дороже, «Окраина» дешевле. Тогда у каждой точки в Нямботе выбирается своя категория.
- Несколько внешних меню — когда у точек реально разный состав блюд, а не только цены.
Что выбрано, видно в списке интеграций iikoWeb — это свойство ключа, а не отдельной точки. Смешать источники внутри одного ключа нельзя.
Шаг 2. Подключение в Нямботе#
«Интеграции» → карточка iiko → «Подключить iiko». Вход один и тот же и для одной точки, и для сети: одна точка — это просто одна строка в таблице.
- Ключ. Если ключ уже заводился, выбери его из списка — вводить apiLogin повторно не нужно, Нямбот хранит его сам. Для нового ключа: apiLogin, название (пригодится, если ключей несколько — «Основной», «Резервный») и источник цен — как в iikoWeb у этого ключа: «Внешнее меню» или «Ценовая категория». От выбора зависит, появится ли на шаге 3 колонка выбора категории.
- Точки. Слева — организации из iiko, справа — твои торговые точки в Нямботе. Сопоставляешь вручную: одинаковые названия ничего не гарантируют, а ошибка означает заказы, уехавшие в чужой ресторан. Ненужные организации можно пропустить.
- Настройки. На каждую пару — терминальная группа, внешние меню и, если источник цен «Ценовая категория», своя категория точки. Разверни строку — там сопоставление способов оплаты Нямбота с типами оплаты этого ресторана. Без него заказ уйдёт в кассу с ошибкой, поэтому не пропускай: типы оплаты у каждого ресторана свои, и подгружаются они при раскрытии строки.
- Готово. Сводка и запуск. Результат показывается по строкам: если одна точка не легла, остальные всё равно подключены — повторять их не нужно.
💳 Если оплату задать не у всех точек, Нямбот предупредит и всё равно подключит их: настроить можно позже в карточке подключения. Но пока оплата не сопоставлена, заказы с такой точки в кассу не уйдут.
Если свободных точек в Нямботе меньше, чем организаций, заведи недостающие в разделе «Торговые точки» и вернись в мастер. Создать точку прямо из мастера нельзя: у точки задаются зоны доставки, а у организации iiko их нет.
🔑 Ключ сохраняется сразу после первого шага, ещё до «Подключить». Так и задумано: все следующие шаги — организации, терминальные группы, меню, категории — Нямбот запрашивает у iiko уже от имени этого ключа. Если закрыть мастер на середине, ключ останется в сегменте «Ключи POS» с подписью «К ключу пока не привязана ни одна точка». Это не мусор: к нему можно вернуться и достроить сеть позже, а если он больше не нужен — удалить корзиной (пока к ключу не привязана ни одна точка, удаление разрешено).
Где посмотреть, что к чему привязано: «Заведения кассы»#
«Интеграции» → вкладка «POS-системы» → сегмент «Заведения кассы». Это ответ на вопрос, которого раньше не было нигде: какие рестораны iiko вообще видит твой ключ и какие твои точки на них стоят.
Что в таблице:
| Колонка | Что показывает |
|---|---|
| Заведение | Название ресторана в iiko, его адрес и ИНН — по ним ты убеждаешься, что это именно тот ресторан, о котором думаешь |
| Ключ POS | Через какой ключ читается это заведение. Одно и то же заведение под двумя ключами — две строки: у ключей разные права и разный набор данных |
| Кассы | Терминальные группы. Зелёная точка — касса отвечает прямо сейчас, красная — не отвечает (заказ не уйдёт), серая — не опрашивали. Рядом часовой пояс, которым живёт точка, и метка «В спячке» |
| Программы кассы | Сколько программ лояльности активно и сколько их всего. Жёлтая метка — часть программ действует не на всю сеть |
| Торговые точки Нямбота | Твои ТТ, стоящие на этом заведении. Пусто — заведение видно по ключу, но не используется |
| Версия кассы | Версия RMS, метка iikoCloud и метка «Подтверждение доставок» (о ней ниже) |
| Синхронизировано | Когда справочник последний раз читался. «Ошибка чтения» — касса не ответила, а не «данных нет» |
Строки заводит синхронизация — править их можно только в кассе.
⚠️ Метка «Подтверждение доставок» означает, что в кассе включено ручное подтверждение. Если при этом не включено авто-подтверждение, каждый онлайн-заказ висит в «Неподтв.», пока его не подтвердит кассир. Это самая частая причина «заказ ушёл, но на кухне его не видят».
Охват программ лояльности: вся сеть или отдельные рестораны#
В iikoCard у программы есть галочка «Программа действует во всех точках продажи сети». Если её снять, выбираются конкретные организации — и тогда программа работает только там.
Нямбот это читает и показывает:
- в сегменте «Заведения кассы» — сколько программ и сколько из них ограничены (жёлтая метка, в подсказке — какая именно и на скольких заведениях);
- на странице «Маркетинг» (вкладка iiko) — колонкой «Охват» в таблицах «Все программы кассы» и «Бонусная программа»: «Вся сеть» либо «Выбранные заведения: N».
💡 Это не косметика. Проценты баллов и акции кассы Нямбот показывает гостю; если программа ограничена другими ресторанами, на этой точке он их не покажет — иначе гость увидел бы обещание, которого касса не выполнит.
Что настраивается на каждую точку отдельно#
- цены (в том числе через ценовую категорию);
- стоп-лист — он всегда локальный, это нормально;
- терминальная группа;
- способы оплаты;
- доставка.
Что общее на всю сеть#
- сам ключ iiko;
- структура меню (при одном внешнем меню);
- программа лояльности iikoCard и кошелёк гостя — баллы у гостя общие на сеть (если программа не ограничена отдельными ресторанами, см. «Охват программ» выше);
- купонные серии — они принадлежат заведению кассы, поэтому купон гасится на любой твоей точке этого заведения.
Добавить точку позже#
Заводить ключ заново не нужно. Добавь организацию во вкладку «Подключенные точки» в iikoWeb, потом в Нямботе найди свой ключ в сегменте «Ключи POS» (вкладка «POS-системы») и нажми «Добавить точку» — откроется тот же поток, но сразу с шага «Точки»: ключ уже выбран, вводить его не надо.
Две точки Нямбота на одной организации iiko#
Так бывает, когда «Центр» и «Окраина» ведутся в одной базе RMS и различаются только ценовой категорией. Порядок такой же, как при добавлении любой точки: сегмент «Ключи POS» → нужный ключ → «Добавить точку» → та же организация → вторая торговая точка → её ценовая категория.
Нямбот не даст завести дубль: две точки на одной организации с одинаковой категорией получили бы одинаковые меню и цены, и такая пара отклоняется. С разными категориями — штатный сценарий.
Сменился ключ#
Меняешь в одном месте: «Интеграции» → вкладка «POS-системы» → сегмент «Ключи POS» → кнопка «Обновить ключ» в строке нужного ключа.
Что произойдёт:
- Нямбот сначала проверит новый ключ у кассы. Нерабочий не сохранится — иначе одним действием легли бы синхронизация и приём заказов сразу на всех точках этого ключа.
- Если такой ключ уже заведён у тебя вторым ключом — Нямбот откажет. Слить их молча нельзя: точки разъехались бы между двумя записями.
- Новый ключ подхватят все точки этого ключа сразу — переподключать их по одной не нужно.
- Заново определятся доступные модули (доставка, iikoCard) — их состав берётся у кассы.
Что при этом НЕ меняется:
- Организации и терминалы точек остаются прежними. Если новый ключ выдан на другой ресторан, где этих организаций нет, точки останутся привязаны к недоступным — синхронизация и отправка заказов начнут падать. Меняй ключ на тот же кабинет; если кабинет действительно другой — точки нужно пересоздать.
- Меню и цены сами не пересинхронизируются. Запусти «Синхронизировать всё» после смены ключа.
- Вебхуки не перерегистрируются. Адрес и токен привязаны к организации, а не к ключу, и остаются прежними. Но в iikoWeb в настройке веб-хуков останется имя старого API-логина, поэтому после смены ключа загляни в сегмент «Вебхуки» и нажми «Проверить»: если покажет «Не совпадает» — там же кнопка записи настройки в кассу.
Сколько точек можно#
Лимит точек — из твоей лицензии Нямбота, а не из iiko. Сколько бы организаций ни было у ключа, завести больше точек, чем разрешает тариф, не получится: об этом скажет сообщение при создании точки.
Частые вопросы#
Организации нет в списке на шаге «Точки». Её нет во вкладке «Подключенные точки» в iikoWeb. Добавь и повтори шаг 1.
Почему нельзя привязать две точки к одной организации? Можно — но только если у них разные ценовые категории. Как это сделать, описано выше в разделе «Две точки Нямбота на одной организации iiko».
В одной точке цена другая — это нормально? Да, если у точек разные ценовые категории. Нямбот хранит отличия по точкам и показывает гостю цену именно его точки — в витрине, корзине и чеке.
Скидка показалась только в одной точке. Так бывает по двум причинам, и они разные. Первая: у точек разные ценовые категории — процент считается от разной цены. Вторая: программа в iikoCard ограничена конкретными ресторанами (снята галочка «действует во всех точках продажи сети»). Что именно у тебя — видно в сегменте «Заведения кассы» в колонке «Программы кассы».
В сегменте «Заведения кассы» одно и то же заведение двумя строками. Значит, оно подключено двумя ключами. Это нормально: у ключей разные права и разный набор данных — например, ценовые категории видит только тот ключ, у которого источник цен «Ценовая категория».
Стоп-лист сработал только в одной точке. Тоже верно: стоп-лист ведёт касса конкретного ресторана.
Синхронизация идёт долго и с паузами. Так задумано — iiko разрешает одному ключу не больше 5 точек в минуту. Подробнее — в разделе Подключение.