> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yume.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Реферальные агенты

> Агенты, приводящие клиентов и заявки, реферал по аренде, статус выплаты и аналитика по агентам.

**Реферальное вознаграждение** — расход в пользу агента, приведшего клиента или заявку. Это отдельный механизм от
[бонусов](/ru/logic/clients-loyalty/bonuses) (баланс клиента) и [скидок](/ru/logic/rent/pricing) (уменьшение цены) —
все три считаются разными строками расчёта аренды и не смешиваются между собой.

Полный перечень полей — в таблице ниже; отдельного глоссария у этой страницы нет.

## Модель данных

### Реферальные агенты

| Модель             | Ключевые поля                                                                             |
| ------------------ | ----------------------------------------------------------------------------------------- |
| Реферальный агент  | Имя, Телефон, Доп. данные                                                                 |
| Реферал по аренде  | Аренда, Агент, Сумма (не отрицательная), Статус, Когда изменён статус, Кем изменён статус |
| Способ привлечения | Название — справочник каналов привлечения                                                 |

Статус реферала: **Выплачен** или **Ожидает**. Реферал по умолчанию создаётся в статусе «Ожидает».

## Как это работает

### Реферальная программа

<Steps>
  <Step title="Справочник агентов">
    Реферальный агент — простой справочник (Имя, Телефон, Доп. данные). Агенты создаются и редактируются в отдельном разделе.
  </Step>

  <Step title="Привязка к аренде">
    Менеджер создаёт реферал для конкретной заявки, указывая агента и сумму вознаграждения. Для завершённых/отменённых аренд создание запрещено без права на изменение завершённых аренд.
  </Step>

  <Step title="Отметка о выплате">
    Реферал переводится в статус «Выплачен» с фиксацией момента и автора изменения статуса.
  </Step>

  <Step title="Аналитика">
    Метрики по рефералам: общий счёт / сумма / среднее, история и агрегаты по агентам (общая сумма вознаграждений и выплаченная сумма, с фильтрацией по плановому окончанию аренды в заданном диапазоне).
  </Step>
</Steps>

<Info>
  Реферальное вознаграждение хранится и как отдельная сущность (Реферал по аренде с его суммой), и как денежная строка аренды «Реферальное вознаграждение». Первое — учёт по агентам, второе — влияние на расчёт прибыли аренды. Связь между ними см. в разделе [Прибыль и окупаемость](/ru/logic/profit-payback).
</Info>

## Связанные страницы

<CardGroup cols={2}>
  <Card title="Карточка клиента" icon="id-card" href="/ru/logic/clients-loyalty/client">
    Профиль клиента, документы и чёрный список.
  </Card>

  <Card title="Бонусы" icon="coins" href="/ru/logic/clients-loyalty/bonuses">
    Накопительный баланс клиента и его начисление/списание.
  </Card>

  <Card title="Программа лояльности" icon="gem" href="/ru/logic/clients-loyalty/loyalty-program">
    Уровни лояльности и дизайн Wallet-карт.
  </Card>

  <Card title="Клиенты, бонусы и рефералы" icon="users" href="/ru/logic/clients-loyalty">
    Общий обзор модуля.
  </Card>
</CardGroup>