> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/obmen/dop.-polya/polzovatelskie-polya.md).

# Пользовательские поля

Пользовательские поля для заявок позволяют администраторам собирать дополнительную информацию о клиенте, которая фиксируется не в профиле, а непосредственно в заявке в момент её создания.

В отличие от полей направлений и валют, пользовательские поля:

* являются глобальными (применяются ко всем направлениям);
* фиксируются в заявке и не изменяются при последующих операциях;
* сохраняются в истории заявки и используются для обработки, проверки и аналитики.

Используйте пользовательские поля, чтобы запросить у клиентов:

* контактные данные (например, Telegram, WhatsApp, никнеймы);
* идентификаторы и служебные данные;
* дополнительные сведения, необходимые для выполнения заявки;
* любую информацию, которая относится к пользователю, но важна именно в контексте конкретной заявки.

Количество и тип пользовательских полей не ограничены.

В панели управления перейдите в раздел: **"Пользователи — Пользовательские поля".**

{% tabs %}
{% tab title="Настройка" %}

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-656b9fe7bb09753fc0560bd005d979ca54bc245d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="На сайте" %}

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-62da37276d5f4cc742d977798180b58f51704bb0%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="В карточке заявки" %}

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-a4ff0e2a2045c5e4e94c9a871ece516a27de62f7%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

***

## Создание нового пользовательского поля

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-cdf5259a4f95090983c549b98627e15e4d6b6f73%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Нажмите кнопку **«Добавить поле»,** расположенную в правом верхнем углу.

В открывшемся окне заполните поле:

* **Название —** укажите название поля, которое будет отображаться клиентам.

  Можно вводить название сразу на нескольких языках, переключаясь между вкладками (например, RU / EN).

Нажмите кнопку **«Добавить»**, чтобы сохранить созданное поле.

После этого поле появится в общем списке пользовательских полей.

***

### Редактирование пользовательского поля

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-cbd725d63aa5dfb95f80d306295e06e76bd0b427%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

1. Найдите нужное поле в списке.
2. Нажмите на его название, чтобы перейти в режим редактирования.

***

### Настройка пользовательского поля

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-4d4247b66669bac3059e3d2b4705b40122ec052b%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

В режиме редактирования доступны следующие параметры:

{% stepper %}
{% step %}

### Название поля

Название, которое будет отображаться клиенту в форме оформления заявки.

Поддерживает мультиязычность.
{% endstep %}

{% step %}

### ID ключа

Уникальный идентификатор поля, используемый системой.

{% hint style="info" %}

## Важно:

Пожалуйста, заполняйте поле ID ключа, строго следуя рекомендациям ниже. Корректно заданный ключ гарантирует правильную работу системы.
{% endhint %}

**Примеры корректных ключей:**

* telegram
* passport
* lastname
* firstname
* user\_email

**Общие рекомендации:**

* Используйте **только латинские буквы в нижнем регистре**, цифры и символ \_.
* Не используйте пробелы и специальные символы.
* Убедитесь, что ключ **уникален** и не повторяется в системе.
  {% endstep %}

{% step %}

### Мин. / Макс. количество символов

Позволяет задать ограничения на длину вводимого значения.

* Минимум — минимальное допустимое количество символов.
* Максимум — максимальное допустимое количество символов.

Если значения не указаны, ограничения не применяются.
{% endstep %}

{% step %}

### Обязательное поле

Если включено, клиент **обязан заполнить** данное поле при создании заявки.

Если выключено — поле становится необязательным.
{% endstep %}

{% step %}

### Удалять пробелы

Если включено, все пробелы в вводимом значении будут автоматически удалены перед сохранением данных.

**Полезно для:**

* идентификаторов;
* логинов;
* номеров аккаунтов.
  {% endstep %}

{% step %}

### Начинается с / Заканчивается на

Позволяет задать проверку на начальные или конечные символы вводимого значения.

**Например:**

* номер телефона должен начинаться с +;
* код должен заканчиваться определённой последовательностью символов.
  {% endstep %}

{% step %}

### Тип валидатора

Позволяет применить готовую проверку формата данных.

Доступные варианты (пример):

* ФИО (RU / EN);
* номер телефона;
* Telegram-никнейм;
* IBAN;
* и другие.

При ошибке валидации клиенту будет показано корректное сообщение с примером.
{% endstep %}

{% step %}

### Статус

Определяет, активно ли поле.

* **Включено —** поле отображается клиентам и участвует в проверках.
* **Выключено —** поле игнорируется системой и не отображается в форме заявки.
  {% endstep %}
  {% endstepper %}

***

### Как работают пользовательские поля в заявке

* Все пользовательские поля относятся к типу `user_order`.
* Значения этих полей фиксируются в момент создания заявки.
* Даже если пользователь изменит свои данные позже, в заявке останется сохранённый снимок данных.
* Пользовательские поля отображаются в деталях заявки отдельным блоком перед основной информацией о клиенте.

***

### Важно знать

* Пользовательские поля **не зависят от направления обмена.**
* Поля валидируются перед созданием заявки.
* Все значения сохраняются в системе как часть заявки и доступны для просмотра администраторам.
* Система полностью поддерживает расширение: в будущем можно добавить другие типы пользовательских полей без изменения текущей логики.