iikoCard: справочник гостей и привязка идентификаторов. Наличие телефона в доставке не следует автоматически считать подтверждением участия в каждой программе. Экраны поиска различаются по версии.
Как проявляется проблема
- Телефон не находится, но карта гостя существует.
- На портале карточка есть, на кассе поиск пуст.
- Гость виден, а ожидаемого счета или баланса нет.
Что проверить сначала
- Выбраны другая организация, программа или фильтр.
- Телефон и карта относятся к разным либо устаревшим карточкам.
- Используемый способ идентификации не соответствует настройке.
Быстрая диагностика
| Что наблюдаем | Что проверить | Как понять результат |
|---|---|---|
| Список пуст | Выберите нужную организацию и проверьте фильтры | Появление карточки указывает на условия просмотра |
| Карта есть, телефон не ищется | Сравните контакт в подтвержденной карточке | Старый контакт не означает отсутствие гостя |
| Нет баланса | Проверьте выбранную программу и счет | Карточка и участие в программе — отдельные сущности |
Три точки наблюдения
Полная формулировка из статьи
Выберите нужную организацию и проверьте фильтры Сравните контакт в подтвержденной карточке Проверьте выбранную программу и счет

Маршрут диагностики
Маршрут проверок
Полная формулировка из статьи
Шаг 1. Уточните у гостя способ первоначальной регистрации: пластиковая карта, электронная карта или телефон. Сохраните маску идентификатора и примерное время последнего успешного визита. Не просите присылать полный номер карты в открытый чат. Сначала нужно найти существующую запись, а не создавать новую под текущий способ обращения. Шаг 2. На портале проверьте организацию и условия просмотра списка. Официальная справка сообщает, что начальный пустой список требует выбора организации и обновления. Для проверки уберите лишнее ограничение программы, если это разрешено вашему доступу. Если карточка найдена, запишите ее внутренний идентификатор и сравните с записью, которую пытается найти касса. Шаг 4. Проверьте, какой идентификатор фактически получает считыватель. Видимый номер карты и считанные данные могут требовать отдельного разбора оборудования или настройки. Сравните с разрешенным ручным способом поиска этой же карточки. Если вручную запись находится, а считывателем нет, не делайте вывод об отсутствии гостя: локализуйте разницу двух способов. Шаг 7. После разрешенного исправления повторите поиск тем способом, которым пользуется персонал. Убедитесь, что находится одна нужная карточка, а не однофамилец или дубликат. История счета и покупок остается на подтвержденной записи. Затем проверьте штатную привязку гостя к тестовому заказу, не выполняя ненужного движения бонусов.
Скриншоты и фрагменты документации

Карточка клиента доставки с контактной и дисконтной информацией. Источник: Руководство пользователя iikoDelivery 7.9, с. 58. Архивная иллюстрация: интерфейс и названия могут отличаться от установленной версии. Руководство пользователя iikoDelivery 7.9 · стр. 58. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.

Окно быстрого поиска клиента по контактным данным. Источник: Руководство пользователя iikoDelivery 7.9, с. 59. Архивная иллюстрация: интерфейс и названия могут отличаться от установленной версии. Руководство пользователя iikoDelivery 7.9 · стр. 59. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.

Список клиентов в справочнике iikoDelivery. Источник: Руководство пользователя iikoDelivery 7.9, с. 56. Архивная иллюстрация: интерфейс и названия могут отличаться от установленной версии. Руководство пользователя iikoDelivery 7.9 · стр. 56. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Пошаговое решение
Отмечайте выполненные проверки. Отметки действуют до перезагрузки страницы.

Иллюстрация рабочего процесса; сгенерированное фото, не интерфейс iiko. 
Иллюстрация рабочего процесса; сгенерированное фото, не интерфейс iiko.
Развилка результата
Полная формулировка из статьи
Критерий результата: Один подтвержденный идентификатор приводит к правильной карточке. Организация и программа совпадают; отображаемый счет относится к этому гостю. Дубликат не создан, чужая запись не изменена. Кассовый способ поиска проверен отдельно от поиска на портале. Передача специалисту: Нужны маска идентификатора, программа, организация, время и различие портала с кассой. Полный идентификатор передавайте защищенно при необходимости. Если есть две похожие карточки, не выбирайте одну наугад: дальнейшее изменение требует подтверждения владельца.
Как понять, что проблема решена
Один подтвержденный идентификатор приводит к правильной карточке. Организация и программа совпадают; отображаемый счет относится к этому гостю. Дубликат не создан, чужая запись не изменена. Кассовый способ поиска проверен отдельно от поиска на портале.
Как снизить риск повторения
При регистрации подтверждайте контакт и записывайте способ идентификации. Для смены номера заведите отдельный процесс проверки владельца. Персоналу объясните разницу общего списка, участника программы и счета. Периодически разбирайте дубликаты только по согласованному реестру.
Если проблема осталась
Нужны маска идентификатора, программа, организация, время и различие портала с кассой. Полный идентификатор передавайте защищенно при необходимости. Если есть две похожие карточки, не выбирайте одну наугад: дальнейшее изменение требует подтверждения владельца.
Что передать в поддержку
Скопируйте шаблон и заполните его без паролей, API-ключей, данных карт и сведений о гостях.
Проблема: iikoCard не находит гостя по телефону или карте: диагностика Версия и компонент iiko: Ресторан / рабочее место: Время сбоя и часовой пояс: Точный текст сообщения: Что ожидалось / что произошло: Какие проверки выполнены: Результат каждой проверки: Идентификатор операции (если допустимо):
Где помогает Menu 360
Menu 360 интегрируется с iiko для передачи заказов и сопоставления блюд и поддерживает автоматические допродажи в электронном меню. Например, к горячему можно предложить гарнир с понятной ценой. Поиск гостя, бонусы и идентификацию проверяйте в используемой системе лояльности: наличие интеграции Menu 360 с кассой не означает подключения кошелька iikoCard.
Вопросы и ответы
Нужно сразу зарегистрировать гостя заново?
Нет. Сначала исключите другую организацию, старый телефон и существующую карту.
Гость найден, почему не видно бонусов?
Проверьте конкретную программу и связанный счет, а затем его историю.
Источники и применимость
Официальная документация служит основой проверки возможностей iiko. Последовательность диагностики и контрольные примеры разработаны редакцией Menu 360; это не подтверждение ошибки именно в вашей конфигурации.