👤 Контрагент

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

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

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

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

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


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

{
    "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

содержит

One-to-Many

unitId

принадлежит

Many-to-One


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

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

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

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

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

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


Last updated

Was this helpful?