value и unrestricted_value — это текст подсказки одной строкой. Их показывают в списке подсказок человеку. Поля не предназначены для автоматических интеграций, потому что их формат может со временем измениться.
Вот как заполняются поля value и unrestricted_value для разных справочников:
unrestricted_value
Поле value содержит краткое наименование организации (data.name.short_with_opf). Если краткое наименование не указано, поле value содержит полное наименование (data.name.full_with_opf).
Поле unrestricted_value всегда равно value.
Поле value содержит краткое наименование банка (data.name.short). Если краткое наименование не указано, поле value содержит платежное наименование (data.name.payment).
Поле unrestricted_value всегда равно value.
Поле value содержит ФИО одной строкой (data.surname + data.name + data.patronymic).
Если запрос соответствует только части ФИО, в поле value возвращается эта часть:
query = викт → value = Виктор query = ольга за → value = Ольга Захарова query = захарова елена к → value = Захарова Елена Константиновна |
Поле unrestricted_value всегда равно value.
Поле value содержит адрес эл. почты одной строкой (data.local + @ + data.domain).
Если в запросе нет «собачки», в поле value возвращается только локальная часть:
query = vikt → value = viktor query = olga@ → value = olga@mail.ru query = elena@bank. → value = elena@bank.ru |
Поле unrestricted_value всегда равно value.
Поля value и unrestricted_value заполняются в соответствии с конфигурацией справочника.