Включается по обращению в поддержку.
Возможности
Подключения
- Организация заводит столько подключений, сколько у неё касс: разные кассовые системы и несколько учётных записей одной системы живут рядом.
- У подключения есть название, протокол, признак «Работает» и список точек, которые оно обслуживает.
- Список обслуживаемых точек задаётся целиком: точка, снятая из списка, отвязывается от подключения.
- Точку обслуживает ровно одно подключение — то, на которое она ссылается.
- Подключение можно выключить, не удаляя: настройки и коды остаются на месте.
Настройки протокола
- Набор полей объявляет сам протокол. Типовые группы: учётные данные, источник меню, отправка заказов, комментарий к заказу, статусы и синхронизация, курьеры, точка в кассе.
- Ключи и пароли показываются маской и наружу не отдаются.
- Часть списков подтягивается из кассы: организации учётной записи, внешние меню, ценовые категории, типы оплаты. Если касса не ответила, форма называет причину, а не показывает пустой список.
- Значения наследуются каскадом от организации к подключению и дальше к точке. Видно, что унаследовано, а что задано явно, и унаследованное можно вернуть.
- У подключения iiko источник меню один — внешнее меню iikoWeb, выбор из номенклатуры iikoOffice в настройках недоступен.
- У подключения iiko в настройках есть и обмен заказами с кассой:
- «Забирать заказы из кассы» — заказ, заведённый прямо в iiko, появляется у нас; «Заказы из кассы — с источником iiko» — без неё такой заказ получает источник «внешний сайт»;
- «Забирать правки состава из кассы» — позиции, изменённые в iiko, переносятся в заказ у нас, подарки акций остаются подарками;
- «Отменять заказ в кассе» — отменённый у нас заказ снимается и в iiko; отмена, пришедшая из самой кассы, обратно не отправляется;
- «Номер заказа кассы в описании» — когда касса приняла заказ, её номер дописывается в описание заказа у нас;
- «Курьер аутсорс-доставки в кассе» — сотрудник iiko, которого касса получает курьером заказов с внешней доставкой; без него касса помечает такие заказы проблемными;
- «Подстраивать прошедшее время доставки» (по умолчанию включена) — если время доставки уже прошло, касса получает ближайшее достижимое: сейчас плюс срок доставки зоны.
Точки и коды
- Код точки в кассе задаётся в карточке точки. Его можно ввести руками, а можно выбрать из списка, который отдала касса: с именем, городом и адресом. Занятые точки помечены и повторно не выбираются.
- Коды позиций собраны в блок «Коды в кассах» на карточках блюда, категории, модификатора, группы модификаторов, зоны доставки и точки: свой код в каждом подключении.
- Тот же блок есть в карточке акции («Маркетинг» → акция → «Коды в кассах»). Если подключение умеет отдать список, код акции выбирается по названию из единого списка кассы: в нём вместе типы скидок и программы лояльности, вид отдельно выбирать не нужно. Рядом с пунктом видно, каким точкам подключения он доступен. Если выбрана программа, запасной тип скидки выбирается из того же списка, и его можно снять. Список спрашивается у кассы по нажатию, а не при открытии карточки. У касс без списка поле остаётся обычным. Сейчас список отдаёт iiko.
- Если список недоступен совсем или пуст, виден ответ кассы и кнопка «Ввести вручную»; от ручного ввода можно вернуться к списку. Если часть списка не получена, остальными пунктами можно пользоваться, а отсутствие кода в такой части не значит, что кода нет. В ручном режиме программа лояльности по-прежнему берётся из отдельного списка программ кассы.
- Если сохранённого кода нет в списке, он остаётся на кнопке, а под формой появляется предупреждение. Если выбранный тип скидки есть не у всех точек акции (а если точки не заданы — не у всех точек подключения), под формой видно, где он есть: заказы остальных точек касса не примет. Выбор при этом не запрещён. Предупреждение появляется после первого открытия списка.
- Связь бывает рабочей, кандидатом (подобран по названию и ждёт подтверждения) и без пары — это код кассы, которому не нашлось позиции. Число кодов без пары видно прямо в списке подключений.
- Видно и то, что один и тот же код кассы занят сразу несколькими позициями.
Действия и обмен
- Кнопки действий у подключения объявляет протокол. В общем ряду у iiko — «Проверить связь», а его действия с вебхуком вынесены в свой блок (ниже); у остальных касс кнопок действий нет. Импорт и очистка меню — в разделе «Импорт из кассы».
- Вебхук — отдельный блок над «Настройками протокола», а не строка в общем списке кнопок. Он появляется у протоколов, объявивших хоть одно из трёх действий с адресом кассы: «Зарегистрировать вебхук», «Проверить вебхук» и «Снять вебхук» — из общего списка кнопок протокола эти три убраны.
- Блок вебхука показывает по каждой обслуживаемой точке две независимые отметки — отправляли ли мы туда адрес и что нашла последняя проверка у кассы, — а ещё до нажатия «Зарегистрировать вебхук» список других подключений, уже настроенных на те же точки кассы.
- «Зарегистрировать вебхук» перед выполнением всегда спрашивает общее подтверждение, не называя другие подключения. Если список других подключений был виден заранее, регистрация после этого подтверждения проходит сразу. Если конфликт с другим подключением обнаруживается только после нажатия — блок о нём заранее не предупреждал, — задаётся второй, именной вопрос с названиями этих подключений; согласие на него регистрирует адрес и здесь.
- Импорт курьеров: перед импортом видно, кого касса отдаёт, кто из этих людей уже заведён, на каких точках они работают и кого импорт пропустит.
- Итог любого действия показывается отчётом, а если действие шло по каждой точке — с разбором по точкам.
Состояние синхронизации
- Сводка по подключениям и точкам: три раздела — «Меню», «Цены», «Наличие» — со статусом у каждого: «Синхронно», «Есть расхождения», «Давно не синхронизировалось», «Ошибка», «Нет кода в кассе».
- Рядом со статусом видно, когда сверялось, сколько нашлось расхождений, когда проходил последний прогон и сколько позиций сейчас на стопе.
- Сам разбор расхождений и перенос меню — отдельная работа, Синхронизация меню, цен и стоп-листов с кассой.
Как настроить
Где это лежит
Подключения живут в настройках организации, раздел «Интеграции»: слева список, в нём у каждой записи видно протокол, число обслуживаемых точек и число кодов без пары. Разбор меню и цен — отдельный раздел «Импорт из кассы» в меню.
Порядок действий
- «Новое подключение» — название и протокол.
- У сохранённой записи открываются «Настройки протокола»: учётные данные и поведение обмена.
- «Обслуживает точки» — какие точки заведения работают через эту кассу.
- В карточке каждой точки задаётся её код в кассе.
- У iiko «Проверить связь» показывает, ответила ли касса с этими учётными данными.
Код точки в кассе
- «Заведение» → «Рестораны» → точка → вкладка «Учёт».
- В блоке «Коды в кассах» у подключения, которое обслуживает точку, нажать кнопку «Выбрать в кассе» рядом с полем кода и выбрать точку кассы из списка: с именем, городом и адресом. Если касса свои точки не перечисляет, код вводится в поле руками.
- «Задать код». Повторить для каждой точки.
Если заведение работает с кассой по прежней интеграции, на той же вкладке есть поля «Внешний код (id)» и «ID терминала»: они видны, пока прежняя интеграция их читает. У iiko в «Внешний код (id)» вписывается идентификатор организации iiko, к которой относится точка, а в «ID терминала» — идентификатор её терминальной группы (у интеграции через iiko.biz — терминала доставки); затем «Сохранить». Через iikoTransport заказ точки без ID терминала уходит в iiko без терминальной группы.
Что нужно со стороны кассы
Учётные данные выдаёт поставщик кассы, и у разных систем это разное: ключ учётной записи обмена, адрес сервера с логином и паролем, токен личного кабинета, идентификатор приложения с парой ключей. Часть систем требует, чтобы в кассе заранее были заведены коды заведений, меню под доставку, коды способов оплаты и отдельные позиции под доставку и наценку.
Что должно быть настроено и ограничения
- Схема подключений включается по запросу. Пока она не включена, подключения завести и связать с точками можно, но заказы и меню идут прежним путём.
- Раздел доступен администратору организации.
- Нужна касса с интерфейсом обмена и учётная запись в ней. У части систем такой интерфейс — отдельно приобретаемый модуль или лицензия: они покупаются у поставщика кассы и в стоимость Смартомато не входят.
- Для R-Keeper через модуль ProCart нужна лицензия XML-Save Order на стороне кассы; сам модуль оплачивается его разработчику.
- У точки должен быть код в кассе: без него по этой точке не работает ни один раздел обмена.
- Позиции меню должны быть сопоставлены кодам кассы, иначе заказ с ними не уедет.
- Касса держит один адрес для событий на всю свою организацию. Если по этому адресу уже настроен кто-то другой, включение перебьёт его — поэтому перед подтверждением показывается, кто ещё на этот адрес претендует.
- Первичная выдача учётных данных у отдельных систем занимает несколько рабочих дней на стороне поставщика кассы.
- Меню из iiko с 01.11.2026 загружается только из внешнего меню iikoWeb: его заводят в самой iiko. У заведений, не заведших внешнее меню, меню из iiko перестаёт обновляться; заказы и стоп-листы при этом работают. Если внешнего меню в iiko нет, импорт заканчивается ошибкой, а не «успехом» с пустым меню. Источник меню сам не переключается: внешнее меню — это другое меню, и молчаливое переключение пересобрало бы каталог заведения.
Чего нет
- Протокол у заведённого подключения не меняется: под другую кассу заводится другое подключение.
- Подключением заводятся не все кассовые системы, а те, для которых описана форма настроек; остальные кассы подключаются иначе и в этом списке не появляются.
- Точка не может обслуживаться двумя подключениями сразу. Код в чужой кассе задать можно, но заказы туда не уйдут — строка кода так и помечена.
- Одну и ту же точку кассы нельзя занять двумя точками заведения.
- Не каждый протокол умеет перечислить свои точки — тогда код вводится руками.
- Не каждый протокол умеет принять адрес, по которому касса шлёт события.
- Подключение, по которому уже уходили заказы, не удаляется — только выключается: иначе теряется след, куда ушёл чек.
- Позиция без кода в кассу не уезжает. Кандидатов система предлагает, но подтверждает их человек.
- Статус в сводке говорит про последний проход процедуры, а не про то, что связь жива прямо сейчас.
- Состав обмена различается по кассам: где-то статусы заказа только приходят из кассы и не уходят обратно, где-то касса сама считает стоимость доставки.
- Подключение iiko не поддерживает режим «оплата уходит в кассу только после оплаты гостем»: оплата картой уходит вместе с заказом. Организацию с таким режимом на новое подключение не переводят.
- Заказ из кассы у подключения iiko не импортируется, если он заведён в кассе больше месяца назад, если его терминальная группа не привязана ни к одной точке подключения (причина видна в журнале интеграции) или если он снят в кассе до того, как попал к нам, а проекция статусов не переводит такой статус в отмену.
- Внутренняя валюта по типу оплаты кассы для заказа, импортированного из кассы iiko, не проставляется: он получает валюту по общим настройкам.
Примеры
Первое подключение одиночной точки
- Заведение получает у поставщика кассы учётные данные для обмена.
- В настройках, раздел «Интеграции», создаётся подключение: название и протокол.
- В «Настройках протокола» вводятся учётные данные и выбирается источник меню.
- У iiko — «Проверить связь»: отчёт показывает, ответила ли касса с этой учётной записью.
- В «Обслуживает точки» отмечается точка.
- В карточке точки задаётся её код в кассе — руками или выбором из списка кассы.
- Дальше меню переносится процедурами импорта.
Добавление точки к работающему подключению
- Точка заводится в кабинете обычным порядком.
- В карточке подключения она добавляется в «Обслуживает точки».
- В карточке точки выбирается её точка в кассе; занятые в списке помечены.
- В сводке у точки появляются разделы «Меню», «Цены» и «Наличие» — до шага 3 они стоят в статусе «Нет кода в кассе».
Разбор «заказ не ушёл в кассу»
- В сводке смотрят статус подключения и нужной точки.
- Статус «Нет кода в кассе» означает, что код точки не задан.
- Если код задан, но помечен как чужой, точку обслуживает другое подключение.
- Если у точки всё в порядке, смотрят «Коды в кассах» на карточке позиции: позиция без кода в кассу не уезжает.
- Последним проверяют, что само подключение включено.