> ## 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. # Карточка клиента > Карточка клиента (физлицо/юрлицо), паспорта и KYC, рейтинги и чёрный список, связь клиента с его арендами. Полный перечень полей клиента и паспортов — в таблицах ниже; отдельного глоссария у этой страницы нет. ## Модель данных ### Клиент | Поле | Назначение | | ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | UUID | Неизменяемый внешний идентификатор | | Имя / название | Имя клиента или название организации | | Тип клиента | Физлицо или Юрлицо | | Форма юрлица | Для юрлиц: ИП, ТОО, АО или ПК | | Пол | Мужской или Женский | | Телефон | Телефон (индексируется) | | Email | Электронная почта | | Аватар | Изображение клиента; при смене генерируется превью | | Документ юрлица | KYC юрлица; при удалении документа ссылка обнуляется | | Документ физлица | KYC физлица; при удалении документа ссылка обнуляется | | Способ привлечения | Как клиент привлечён; при удалении справочного значения ссылка обнуляется | | Персональная скидка | Постоянная скидка клиента; удалить такую скидку, пока она привязана, нельзя | | Пользователь | Ссылка на общий аккаунт пользователя; через него — программа лояльности (см. [Программу лояльности](/ru/logic/clients-loyalty/loyalty-program)) | | Рейтинги | Рейтинги / метки / чёрный список (присваиваются через отдельную связь) | | Номер договора | Генерируется автоматически | | Договор подписан / Дата подписания / Действует до | Статус подписания договора | | Архивация | Мягкое удаление / архивация клиента: единая связанная запись «Архивация» со способом, автором и причиной (см. [Инвентарь](/ru/logic/inventory#архивация-вместо-жёсткого-удаления)) | | Доп. данные | Произвольные дополнительные поля | Номер договора присваивается **лениво** — при первом сохранении уже существующего клиента. Берётся общий на компанию счётчик (с блокировкой строки, чтобы номера не пересекались), формат — `№YY-NNNN` (две последние цифры года + 4-значный номер). У только что созданного клиента номер не присваивается — он появится при следующем сохранении. ### Паспорта (KYC) Разделены на две модели — для физлиц и юрлиц. | Модель | Ключевые поля | | ---------------- | ------------------------------------------------------------------------------------------------- | | Документ физлица | ИИН (12–14 символов), Номер документа, Кем выдан, Дата выдачи, Действует до, Дата рождения, Адрес | | Документ юрлица | БИН (ровно 12 символов), Директор, IBAN, БИК, Банк, Адрес | Валидатор ИИН допускает длину **12–14** символов, хотя казахстанский ИИН всегда 12 цифр. При массовом импорте значение дополнительно обрезается до 14 символов. ### Рейтинги и чёрный список Рейтинг клиента — это цветная метка, назначаемая клиенту через присвоение рейтинга. | Поле | Назначение | | -------------------- | --------------------------------------------------------------------------------------------- | | Название | Название метки | | Цвет | HEX-цвет (проверяется по формату вида `#RRGGBB` или `#RGB`) | | Чёрный список | Если включено — клиенты с этой меткой синхронизируются в общий чёрный список | | Порог по числу аренд | Авто-назначить метку, когда **количество** завершённых аренд клиента достигло заданного числа | | Порог по обороту | Авто-назначить метку, когда **сумма** завершённых аренд клиента достигла заданной суммы | | Лимит долга | Описательное поле | ## Как это работает ### Синхронизация с чёрным списком Метка с включённым признаком «Чёрный список» при назначении клиенту автоматически заводит запись в общем чёрном списке, доступном другим компаниям в системе: * при добавлении клиенту метки чёрного списка запускается синхронизация клиента в общий чёрный список; * запись создаётся только если чёрный список **расшарен** для компании; в неё попадают имя, телефон, ИИН, БИН и текст комментариев; * снятие признака «Чёрный список» у метки удаляет записи (если они не используются другими компаниями); удаление самой связи метки с клиентом тоже очищает список. ### Авто-назначение меток по порогам У метки можно заполнить один или оба порога, и каждый порог сравнивается со своим показателем клиента: * **порог по числу аренд** — с количеством завершённых аренд клиента; * **порог по обороту** — с суммой итоговых сумм к оплате по тем же завершённым арендам. Достаточно, чтобы клиент прошёл **любой** из заполненных порогов — метка назначается по принципу «или», а не «и». Клиент с одной крупной арендой получает метку по обороту, даже если по количеству аренд он до порога не дотягивает. В расчёт идут только активные аренды в статусе «Завершена». У клиента без завершённых аренд оборот не считается, и метка по обороту ему не назначается. Проверка выполняется в двух моментах, и оба используют одно и то же правило: * при завершении аренды — метка появляется у этого клиента, если его показатели дотянулись до порога; * при создании или изменении самой метки — она разово навешивается на всех клиентов компании, уже прошедших порог. ### Как клиент связан с арендами У каждой аренды есть ссылка на клиента, а у клиента — обратный список его аренд. Карточка клиента в списке аннотирует агрегаты по арендам: | Аннотация | Что считает | | --------------------- | -------------------------------------------------------------------------------------- | | Количество аренд | Число аренд в статусах «В аренде» / «Завершена» / «Должник» | | Сумма аренд | Сумма итоговых сумм к оплате по этим статусам | | Оплачено | Сумма оплаченного по этим арендам | | Долг | Долг: max(Σ(итоговая сумма к оплате − оплачено), 0) по статусам «В аренде» / «Должник» | | Долг по просроченным | Долг по арендам в статусе «Просрочена» | | Дата последней аренды | Максимальное плановое начало по завершённым | | Суммарное время | Суммарная длительность аренд | | ИИН / БИН | Прокинутые из паспортов | В детальной карточке клиента дополнительно отдаётся текущий выданный клиенту инвентарь. ## Связанные страницы Накопительный баланс клиента и его начисление/списание. Уровни лояльности и дизайн Wallet-карт. Агенты, приводящие клиентов, и их вознаграждение. Общий обзор модуля.