Редактирование: поиск-гостя-в-crm

Путь: 04_Ежедневная_работа/поиск-гостя-в-crm.md

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

# Поиск гостя в CRM

Гость в системе лояльности ReMarked идентифицируется по **номеру карты** — это уникальный номер, по которому происходит авторизация на кассовом терминале. Данные по карте хранятся в таблице `cl_cardholders`.

## Что содержит карточка гостя

- Имя, телефон, пол
- Номер карты лояльности
- Дата регистрации (включая регистрацию в мобильном приложении)
- Кошельки (балансы бонусов)
- Категория клиента

## Как найти гостя

Гостя можно найти в личном кабинете CRM по одному из идентификаторов:

- номер карты (`card`);
- номер телефона (`phone`);
- внешний идентификатор (`external_id`).

### Получение ID гостя из адресной строки

После открытия карточки гостя ID берётся из URL. Пример:

```
.../guests.detail/id_48961144  →  ID гостя: 48961144
```

Этот ID используется в SQL-запросах и при постановке задач.

## Как понять, что гостя чекинили через плагин

ПЛ ReMarked начинает отрабатывать по гостю в тот момент, когда в таблице `loyalty_transactions` транзакция переходит в статус `success`. Данные приходят с кассы напрямую, ждать загрузки заказа из iiko не нужно.

> **Нет транзакции в таблице `loyalty_transactions` = гостя не чекинили через наш плагин.**

## Важно про привязку карты к заказу

1. Карту можно привязать **только пока заказ доступен для редактирования**. Если уже сделан пречек — карту не провести для начисления.
2. Без пречека баллы на карте не отобразятся, пока перед закрытием чека не будет вызван тип оплаты.
3. Авторизация гостя считается успешной, когда в верхнем левом углу кассы появилось сообщение о привязке.

Отмена