📚 RM.Loyalty.docs
➕ Новая статья

ошибки чекина гостя

✏️ Редактировать

Ошибки чекина (авторизации) гостя

Раздел описывает ошибки, возникающие при чекине гостя в заказ: номер карты уже занят, рекомендуемая скидка, чёрный список, дубли при загрузке, гость не найден, конфликт категорий. Большинство ошибок диагностируются по логу чекина (GuestCheckin) и решаются в iikoOffice или в БД CRM.

Общее правило. Привязка гостя к заказу прошла успешно, когда в верхнем левом углу появляется подтверждающее сообщение. Строго запрещается авторизовать гостя после пречека.

Номер карты уже занят

Симптом. Гость не привязывается к заказу. В логе:

ERROR: Card number 110 is already bound to client Сергей Валерьевич (e408436f-...)

Полная строка лога:

[2026-04-24 13:42:21,614] ERROR [11] - Got System.InvalidOperationException in GuestCheckin
System.InvalidOperationException: Card number 1102120 is already bound to client Данил Ранюк (5bd94f48-3e4d-49f4-a3bc-35633e8bc450).

Причина. Данные гостя записаны некорректно (лишний символ или изменившиеся данные) — карта числится привязанной к гостю в разделе «Гости банкетов и резервов».

Решение.

  1. iikoOffice → раздел «Гости банкетов и резервов».
  2. Найти и удалить гостя с этим номером карты.
  3. Повторно проверить чекин гостя.

Действия 1-й / 2-й линии ТП CRM при обращении: найти профиль гостя; запросить полное видео ошибки привязки/чекина на кассе; снять лог с кассы за дату ошибки; сформировать задачу по инструкции «Оформление задачи в ПЛ».

Рекомендуемая скидка у гостя

Симптом.

ERROR: discountCard.Type (..., Name = Скидка 10% Карта) cannot be applied by card number

В iikoOffice в «Гости банкетов и резервов» у гостя выставлена «Рекомендуемая скидка».

Решение. Проверить раздел «Клубные карты» и удалить карту, если она там создана.

Гость в чёрном списке (высокий риск)

Симптом. В логе:

[2025-04-11 13:29:49,335] ERROR [18] - Got Resto.Front.Api.Exceptions.EntityUsingException in GuestCheckin
Resto.Front.Api.Exceptions.EntityUsingException: Client in blacklist.

Причина. Гость попал в раздел «Высокий риск».

Решение. Удалить гостя из раздела «Высокий риск» в кабинете.

Дубль гостя при загрузке

Симптом. Гость с таким номером уже существует — запись получает статус double в таблице загрузки.

Решение. Перевести записи в статус hard_update (принудительная перезапись):

UPDATE `guests_load_raw_data`
SET `status` = 'hard_update'
WHERE `point` = [point_id] AND `status` = 'double';

Гость не найден по телефону или номеру карты

Симптом.

Не удалось найти гостя по введённому номеру телефона или номеру карты: {0}

Одна из самых частых ошибок. Проверять по пунктам (от частого к редкому), пока не найдётся проблема:

  1. Убедиться, что вводимый номер/карта реально есть в CRM.
  2. В таблице cl_guests → колонка provider → должно быть remarked. Любой другой провайдер — исправить (если есть права; если нет — в чат «ТехПо ПЛ / Программа Лояльности ReMarked»).
  3. Проверить в cl_guests наличие обязательных полей name, fio, phone. При отсутствии любого — перерегистрировать гостя по форме регистрации.
  4. У гостя в cl_guests и cl_cardholders (cardholders) должен стоять общий поинт. Если не так — исправить вручную (при отсутствии прав — в чат ТехПо ПЛ).
  5. Проверить включённость API Системы лояльности Remarked и Конфигурации плагина для проблемной кассы. В разделе «Модуль лояльности» первые 5 пунктов должны быть включены (кроме «добавления гостей»).

Причина проверки провайдера: отдел ПЛ ввёл проверку, чтобы не было авторизаций гостя с неправильным провайдером. После исправления провайдера в таблицах cl_guests и cl_wallets на remarked сообщить клиенту: «Ошибка исправлена, попробуйте провести заказ ещё раз».

Unexpected error — ссылка на объект (конфликт категорий / нет кошелька)

Симптом. «Unexpected error while sending request — Ссылка на объект не указывает на экземпляр объекта». Указывает на проблему в отработке логики ПЛ по гостю.

Причина 1. Нет кошелька (обычно master_cashback). У большинства гостей должен быть как минимум master_cashback; возможно отсутствует другой основной кошелёк. Проверить активные программы начисления в ЛК (Программы лояльности) — там указаны названия используемых кошельков.

Решение. Перерегистрировать гостя по форме регистрации.

Причина 2. Конфликт категорий. Несколько категорий, выполняющих одну функцию (например, скидка 10% и скидка 5%). Категорий может быть несколько, только если они выполняют разные функции (например, скидка 10% + бонусы 5%).

Решение для конфликта.

  1. ЛК клиента → Программы лояльности → убедиться, что категории действительно конфликтуют (одна функция, разный процент).
  2. Раздел «Обновления» → посмотреть, кто и когда назначил категорию (вероятно, выдали вручную).
  3. Оставить одну правильную категорию, лишние убрать. При неясности — сопоставить логически с программами или уточнить у клиента, какую категорию оставить.