👤 Контрагент

Клиент представляет конечного контрагента внутри юнита. Контрагенты создаются внутри конкретного юнита и могут иметь собственные кошельки и транзакции.

💡 Отличие от инвойса:

• Контрагент не имеет срока жизни в отличии от инвойса и доступен для многоразового приема депозитов.

• Контрагент работает как сущность для приёма и перевода средств на юнит.

• В отличие от инвойса, контрагент может иметь несколько кошельков одной валюты (основной набор кошельков + субсчета), что позволяет гибко распределять средства.

---

📘 Основная структура

{
    "id": 432,
    "uuid": "8b4dc367-25d0-42cb-ab1a-a97ee739c572",
    "clientId": 458,
    "name": "John Doe",
    "email": "[email protected]",
    "unitId": 635,
    "rootUnitId": 102,
    "wallets": [ /* Wallet objects */ ],
    "labels": [],
    "createdAt": "2024-04-09T11:43:18.461Z",
    "updatedAt": "2024-04-09T11:43:18.461Z"
}

---

🧩 Поля сущности

Поле	Тип	Nullable	Описание
id	number	❌	Уникальный идентификатор клиента в системе.
uuid	string	❌	Уникальный UUID клиента.
clientId	number	❌	Внутренний идентификатор клиента.
name	string	❌	Имя клиента или контрагента.
email	string	✅	Email клиента.
unitId	number	❌	Идентификатор юнита, к которому принадлежит клиент.
rootUnitId	number	❌	Идентификатор корневого юнита.
wallets	array<Wallet>	✅	Список кошельков клиента. См. Wallet
labels	array<string>	✅	Дополнительные метки или теги для клиента.
createdAt	string (ISO 8601)	❌	Дата создания клиента.
updatedAt	string (ISO 8601)	❌	Дата последнего обновления клиента.

---

🔗 Связанные сущности

Поле	Связь	Сущность	Тип связи
wallets	содержит	Wallet	One-to-Many
unitId	принадлежит	Unit	Many-to-One

---

⚙️ Использование

Контрагенты используются для:

• Создания индивидуальных кошельков с разными валютами;

• Приёма депозитов;

• Учёта транзакций и общей финансовой истории;

• Группировки средств по подразделениям (юнитам).

---