> 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/polzovateli/polzovatelskie-polya.md).

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

Раздел «Пользовательские поля» используется для создания дополнительных полей, которые клиент заполняет при оформлении заявки на обмен.

Путь в панели управления:

«Пользователи» — «Пользовательские поля»

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

Например:

* Telegram;
* Ф.И.О.;
* номер паспорта;
* номер договора;
* дополнительный телефон;
* IBAN;
* БИК банка;
* комментарий к выплате;
* адрес кошелька;
* любые другие данные.

После создания заявки введённая информация сохраняется в карточке заявки и становится доступна операторам.

***

## Для чего нужны пользовательские поля

Стандартной формы заявки не всегда достаточно.

Во многих случаях обменному пункту необходимо получить от клиента дополнительные сведения.

Например:

* запросить Telegram для связи;
* получить Ф.И.О. получателя;
* запросить номер договора;
* собрать банковские данные;
* запросить дополнительные идентификаторы;
* получить комментарий по операции.

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

Администратор самостоятельно создаёт нужные поля через панель управления и сразу начинает использовать их в заявках.

***

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

Когда клиент открывает форму создания заявки:

1. Система загружает все активные пользовательские поля.
2. Клиент заполняет необходимые данные.
3. При создании заявки система выполняет проверку заполнения.
4. Если данные корректны — заявка создаётся.
5. Значения сохраняются внутри заявки.
6. Оператор видит заполненные данные в карточке заявки.

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

***

## Особенности работы

Важно понимать несколько особенностей данного раздела.

{% stepper %}
{% step %}

### Поля являются глобальными

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

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

Например:

если создано поле Telegram и оно активно, клиент увидит его независимо от выбранного направления обмена.
{% endstep %}

{% step %}

### Поля сохраняются в заявке

После создания заявки значения фиксируются внутри неё.

Даже если позже изменить настройки поля или удалить его из системы, старые заявки сохранят ранее введённые данные.
{% endstep %}

{% step %}

### Порядок отображения настраивается

Порядок полей в списке напрямую влияет на порядок отображения клиенту.

При необходимости поля можно перетаскивать мышкой и менять их расположение.
{% endstep %}
{% endstepper %}

***

## Создание нового поля

Чтобы добавить новое поле:

1. Откройте раздел «Пользователи» — «Пользовательские поля».
2. Нажмите кнопку «Добавить поле».
3. Укажите название поля.
4. Нажмите кнопку создания.
5. Откройте созданное поле на редактирование.
6. Настройте параметры.
7. Сохраните изменения.

После создания рекомендуется сразу проверить:

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

{% stepper %}
{% step %}

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

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

Примеры:

* Telegram
* Ф.И.О.
* Номер паспорта
* Номер договора
* IBAN
* БИК банка
* Дополнительный телефон

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

Для каждого языка системы можно указать собственное название.
{% endstep %}

{% step %}

### ID ключа

ID ключа — это внутренний идентификатор поля.

Он используется системой для хранения данных.

**Требования к ключу**

Разрешено использовать:

* латинские буквы;
* цифры;
* нижнее подчёркивание `_`.

Запрещено использовать:

* пробелы;
* специальные символы;
* кириллицу.

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

```
telegram
fullname
passport_number
iban
bank_bik
contract_number
```

Каждый ключ должен быть уникальным.

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

{% step %}

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

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

**Если включено**

Поле обязательно для заполнения.

Пока клиент не введёт корректное значение, заявка не будет создана.

**Если выключено**

Поле можно оставить пустым.

Заявка будет создана без заполнения данного значения.
{% endstep %}
{% endstepper %}

### Ограничение по количеству символов

Для каждого поля можно задать минимальную и максимальную длину значения.

{% stepper %}
{% step %}

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

Позволяет запретить слишком короткие значения.

Например:

Telegram — минимум 5 символов.
{% endstep %}

{% step %}

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

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

Например:

Комментарий — максимум 255 символов.
{% endstep %}

{% step %}

### Значение 0

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

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

Настройка автоматически удаляет пробелы перед сохранением значения.

Полезно для:

* телефонов;
* IBAN;
* банковских реквизитов;
* кодов;
* идентификаторов.

Пример:

Клиент вводит: **GB82 WEST 1234 5698 7654 32**

Система сохранит: **GB82WEST12345698765432**

### Начинается с

Позволяет указать обязательное начало значения.

Примеры:

```
@
+
GB
```

Если значение начинается иначе, система покажет ошибку.

Например:

если указано начало `@`, то значение: **telegram\_user** будет отклонено.

А значение: **@telegram\_user** будет принято.

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

Позволяет указать обязательное окончание значения.

Например:

```
.com
.ru
USD
```

Если значение не соответствует правилу, система покажет ошибку.

Если ограничение не требуется — оставьте поле пустым.

### Валидаторы

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

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

### Статус поля

Каждое поле можно временно отключить.

{% stepper %}
{% step %}

#### Включено

Поле показывается клиенту и участвует в проверках.
{% endstep %}

{% step %}

#### Выключено

Поле скрывается из формы заявки.

При этом настройки поля сохраняются и его можно включить повторно в любой момент.
{% endstep %}
{% endstepper %}

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

{% stepper %}
{% step %}

### На стороне клиента

Поля отображаются в форме создания заявки.

Клиент видит название поля и вводит требуемое значение.
{% endstep %}

{% step %}

### В панели управления

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

Это позволяет использовать дополнительные данные во время обработки обмена.
{% endstep %}
{% endstepper %}

***

## Что происходит при создании заявки

При оформлении заявки система выполняет следующий алгоритм:

1. Загружает список активных полей.
2. Проверяет обязательность заполнения.
3. Проверяет ограничения по длине.
4. Проверяет начало и окончание значения.
5. Проверяет валидатор.
6. Сохраняет данные в заявку.
7. Создаёт заявку.

Если хотя бы одна проверка не пройдена, клиент получает сообщение об ошибке и должен исправить данные.

***

## Удаление поля

Поле можно удалить из системы.

После удаления:

* поле исчезает из формы заявки;
* новые заявки его больше не используют;
* старые заявки сохраняют ранее введённые значения.

Перед удалением рекомендуется сначала отключить поле и убедиться, что оно больше не используется.

***

## Практические примеры

{% stepper %}
{% step %}

#### Telegram клиента

* Название: Telegram
* Ключ: telegram
* Начинается с: @
* Обязательное: Да
  {% endstep %}

{% step %}

### Номер паспорта

* Название: Номер паспорта
* Ключ: passport\_number
* Обязательное: Да
  {% endstep %}

{% step %}

### IBAN

* Название: IBAN
* Ключ: iban
* Валидатор: IBAN
* Удалять пробелы: Да
  {% endstep %}
  {% endstepper %}

## Рекомендации

Используйте пользовательские поля только для действительно необходимых данных.

Не стоит перегружать форму заявки большим количеством полей.

Для большинства обменников достаточно:

* Telegram;
* дополнительного телефона;
* Ф.И.О. получателя;
* номера договора (при необходимости).

Чем проще форма заявки, тем выше конверсия клиента в успешный обмен.

***

## Коротко

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/guide/polzovateli/polzovatelskie-polya.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.