Редактирование: ошибки-чекина-гостя

Путь: 08_Решение_проблем/Лояльность_и_чекин/ошибки-чекина-гостя.md

Содержимое (Markdown)

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

Раздел описывает ошибки, возникающие при чекине гостя в заказ: номер карты уже занят, рекомендуемая скидка, чёрный список, дубли при загрузке, гость не найден, конфликт категорий. Большинство ошибок диагностируются по логу чекина (`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` (принудительная перезапись):

```sql
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. Оставить одну правильную категорию, лишние убрать. При неясности — сопоставить логически с программами или уточнить у клиента, какую категорию оставить.

Отмена