Поля объектов CRM

Если вы разрабатываете интеграции для Битрикс24 с помощью AI-инструментов (Codex, Claude Code, Cursor), подключите MCP-сервер, чтобы ассистент использовал официальную REST-документацию.

В блоке общие поля приведен перечень стандартных полей, которые используются во всех типах объектов CRM.

В блоках по типам объектов приведены перечни стандартных полей, характерных для этого типа объекта:

Используйте метод crm.item.fields с указанием типа объекта в entityTypeId, чтобы получить полный перечень полей для объекта, в том числе пользовательских.

Общие поля

Название
тип

Описание

assignedById
user

Идентификатор пользователя ответственного за элемент

createdBy
user

Идентификатор пользователя, который создал элемент

createdTime
datetime

Время создания элемента

entityTypeId
integer

Идентификатор типа сущности

id
integer

Идентификатор элемента

lastActivityBy
user

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

lastActivityTime
datetime

Время, последнего проявления активности в таймлайне

opened
boolean

Является ли элемент открытым

parentId...
crm_entity

Поле-родитель. Элемент другого типа объекта CRM, который привязан к данному элементу.
Каждое такое поле имеет код parentId + {parentEntityTypeId}

ufCrm...
crm_userfield

Пользовательское поле. Смотрите раздел Пользовательские поля в CRM: обзор методов.

  • Значения множественных полей отдаются в виде массива
  • Значение поля типа file отдаются в виде объекта:
  • id — идентификатор
  • url — ссылка на файл на портале
  • urlMachine — ссылка на файл для приложения

updatedBy
user

Идентификатор пользователя, который изменил элемент

updatedTime
datetime

Время последнего изменения элемента

utmCampaign
string

Обозначение рекламной кампании

utmContent
string

Содержание кампании.
Например, для контекстных объявлений

utmMedium
string

Тип трафика. Возможные значения:

  • CPC — объявления
  • CPM — баннеры

utmSource
string

Рекламная система. Yandex-Direct, Google-Adwords и другие

utmTerm
string

Условие поиска кампании.
Например, ключевые слова контекстной рекламы

webformId
integer

Идентификатор crm формы

Поля по объектам

Лид

Название
тип

Описание

dateCreateShort
datetime

Время создания элемента (краткий формат).
Поле выключено

dateModifyShort
datetime

Время последнего изменения элемента (краткий формат).
Поле выключено

companyId
crm_company

Идентификатор компании, привязанной к элементу

contactId
crm_contact

Идентификатор контакта, привязанного к элементу

stageId
crm_status

Строковый идентификатор стадии элемента

isConvert
boolean

Сконвертирован ли лид.
Поле выключено

statusDescription
text

Дополнительно о стадии

stageSemanticId
string

Группа стадии. Возможные значения:

  • P — в работе
  • S — успешная
  • F — неуспешная

productId
string

Идентификатор товара.
Устарело.
Поле выключено

opportunity
double

Сумма

currencyId
crm_currency

Идентификатор валюты элемента

sourceId
crm_status

Строковый идентификатор типа источника

sourceDescription
text

Дополнительно об источнике

title
string

Название элемента

name
string

Имя

lastName
string

Фамилия

secondName
string

Отчество

shortName
string

Фамилия Имя.
Краткий формат: например 'Иванов Иван' -> 'Иванов И.'.
Поле выключено

companyTitle
string

Название компании

post
string

Должность

address
text

Адрес.
Устарело.
Поле выключено

comments
text

Комментарий

originatorId
string

Внешний источник

originId
string

Идентификатор элемента во внешнем источнике

dateClosed
datetime

Время закрытия элемента

birthdate
date

Дата рождения

honorific
crm_status

Строковый идентификатор типа обращения

hasPhone
boolean

Имеется ли у элемента телефон

hasEmail
boolean

Имеется ли у элемента почта

hasImol
boolean

Имеется ли у элемента открытые линии

login
string

Логин.
Устарело.
Поле выключено

isReturnCustomer
boolean

Является ли элемент повторным

searchContent
text

Информация для полнотекстового поиска.
Служебное поле

isManualOpportunity
boolean

Установлен ли ручной режим расчеты суммы

movedBy
user

Идентификатор пользователя, который последним сменил стадию

movedTime
datetime

Время последней смены стадии

phoneMobile
string

Мобильный телефон

phoneWork
string

Рабочий телефон

phoneMailing
string

Телефон для рассылок

emailHome
string

Личный E-mail

emailWork
string

Рабочий E-mail

emailMailing
string

Почта для рассылок

skype
string

Skype

icq
string

ICQ

imol
string

IMOL

email
string

E-mail

phone
string

Телефон

observers
user[]

Список идентификаторов пользователей, которые являются Наблюдателями

contactIds
crm_contact[]

Список идентификаторов контактов, привязанных к элементу

fm
multifield

Массив мультиполей.
Подробнее о мультиполях можно почитать в разделе crm_multifield
Структура мультиполя:

  • id — Уникальный идентификатор
  • typeId — Тип мультиполя
  • valueType — Тип значения
  • value — Значение

Сделка

Название
тип

Описание

dateCreateShort
datetime

Время создания элемента (краткий формат).
Поле выключено

dateModifyShort
datetime

Время последнего изменения элемента (краткий формат).
Поле выключено

leadId
crm_lead

Идентификатор лида, на основании, которого создан элемент

companyId
crm_company

Идентификатор компании, привязанной к элементу

contactId
crm_contact

Идентификатор контакта, привязанного к элементу

quoteId
crm_quote

Идентификатор предложения, привязанного к элементу

title
string

Название элемента

productId
string

Идентификатор товара.
Устарело. Поле выключено

categoryId
crm_category

Идентификатор воронки (направления) элемента

stageId
crm_status

Строковый идентификатор стадии элемента

stageSemanticId
string

Группа стадии

  • P — в работе
  • S — успешная
  • F — неуспешная

isNew
boolean

Является ли сделка новой

isRecurring
boolean

Является ли сделка повторной

isReturnCustomer
boolean

Является ли элемент повторным

isRepeatedApproach
boolean

Является ли сделка повторным обращением

closed
boolean

Является ли сделка закрытой

typeId
crm_status

Строковый идентификатор типа сделки

opportunity
double

Сумма

isManualOpportunity
boolean

Установлен ли ручной режим расчеты суммы

taxValue
double

Сумма налога

currencyId
crm_currency

Идентификатор валюты элемента

probability
integer

Вероятность, %

comments
text

Комментарий

begindate
date

Дата начала элемента

begindateShort
datetime

Время начала элемента (краткий формат).
Поле выключено

closedate
date

Дата завершения элемента

closedateShort
datetime

Время окончания элемента (краткий формат).
Поле выключено

eventDate
datetime

Дата события

eventDateShort
datetime

Дата события (краткий формат).
Поле выключено

eventId
crm_status

Строковый идентификатор типа события

eventDescription
text

Описание события

locationId
location

Идентификатор местоположения.
Служебное поле

sourceId
crm_status

Строковый идентификатор типа источника

sourceDescription
text

Дополнительно об источнике

originatorId
string

Внешний источник

originId
string

Идентификатор элемента во внешнем источнике

additionalInfo
string

Дополнительная информация

searchContent
text

Информация для полнотекстового поиска.
Служебное поле

orderStage
string

Статус оплаты сделки

movedBy
user

Идентификатор пользователя, который последним сменил стадию

movedTime
datetime

Время последней смены стадии

isWork
boolean

Является ли сделка в работе.
Поле выключено

isWon
boolean

Является ли сделка выигранной.
Поле выключено

isLose
boolean

Является ли сделка проваленной.
Поле выключено

receivedAmount
string

Полученная сумма.
Поле выключено

lostAmount
string

Утраченная сумма.
Поле выключено

hasProducts
boolean

Содержит ли элемент товары.
Поле выключено

observers
user[]

Список идентификаторов пользователей, который являются Наблюдателями

contactIds
crm_contact[]

Список идентификаторов контактов, привязанных к элементу

Контакт

Название
тип

Описание

companyId
crm_company

Идентификатор компании, привязанной к элементу

sourceId
crm_status

Строковый идентификатор типа источника

sourceDescription
text

Дополнительно об источнике

name
string

Имя

lastName
string

Фамилия

secondName
string

Отчество

shortName
string

Фамилия Имя.
Краткий формат: например 'Иванов Иван' -> 'Иванов И.'.
Поле выключено

photo
file

Фотография

post
string

Должность

address
text

Адрес.
Устарело. Поле выключено

comments
text

Комментарий

leadId
crm_lead

Идентификатор лида, на основании, которого создан элемент

export
boolean

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

typeId
crm_status

Строковый идентификатор типа сделки

originatorId
string

Внешний источник

originId
string

Идентификатор элемента во внешнем источнике

originVersion
string

Версия оригинала

birthdate
date

Дата рождения

honorific
crm_status

Строковый идентификатор типа обращения

hasPhone
boolean

Имеется ли у элемента телефон

hasEmail
boolean

Имеется ли у элемента почта

hasImol
boolean

Имеется ли у элемента открытые линии

searchContent
text

Информация для полнотекстового поиска. Служебное поле

categoryId
crm_category

Идентификатор воронки (направления) элемента

login
string

Логин.
Устарело. Поле выключено

emailHome
string

Личный E-mail

emailWork
string

Рабочий E-mail

emailMailing
string

Почта для рассылок

phoneMobile
string

Мобильный телефон

phoneWork
string

Рабочий телефон

phoneMailing
string

Телефон для рассылок

imol
string

IMOL

email
string

E-mail

phone
string

Телефон

observers
user[]

Список идентификаторов пользователей, который являются Наблюдателями

companyIds
crm_company[]

Список идентификаторов компаний, привязанных к элементу

fm
multifield

Массив мультиполей.
Подробнее о мультиполях можно почитать в разделе crm_multifield
Структура мультиполя:

  • id — Уникальный идентификатор
  • typeId — Тип мультиполя
  • valueType — Тип значения
  • value — Значение

Компания

Название
тип

Описание

title
string

Название элемента

logo
file

Логотип

address
text

Адрес.
Устарело. Поле выключено

addressLegal
text

Юридический адрес.
Устарело

bankingDetails
string

Банковские реквизиты

comments
text

Комментарий

typeId
crm_status

Строковый идентификатор типа сделки

industry
crm_status

Строковый идентификатор типа индустрии

revenue
double

Годовой оборот

currencyId
crm_currency

Идентификатор валюты элемента

employees
crm_status

Строковый идентификатор типа кол-ва сотрудников

leadId
crm_lead

Идентификатор лида, на основании, которого создан элемент

originatorId
string

Внешний источник

originId
string

Идентификатор элемента во внешнем источнике

originVersion
string

Версия оригинала

hasPhone
boolean

Имеется ли у элемента телефон

hasEmail
boolean

Имеется ли у элемента почта

hasImol
boolean

Имеется ли у элемента открытые линии

isMyCompany
boolean

Является ли компания моей компанией

searchContent
text

Информация для полнотекстового поиска.
Служебное поле

categoryId
crm_category

Идентификатор воронки (направления) элемента

emailHome
string

Личный E-mail

emailWork
string

Рабочий E-mail

emailMailing
string

Почта для рассылок

phoneMobile
string

Мобильный телефон

phoneWork
string

Рабочий телефон

phoneMailing
string

Телефон для рассылок

imol
string

IMOL

email
string

E-mail

phone
string

Телефон

ufLogo
file

Логотип (генератор документов)

ufStamp
file

Печать организации (генератор документов)

ufDirectorSign
file

Подпись директора (генератор документов)

ufAccountantSign
file

Подпись гл. бухгалтера (генератор документов)

observers
user[]

Список идентификаторов пользователей, который являются Наблюдателями

contactIds
crm_contact[]

Список идентификаторов контактов, привязанных к элементу

fm
multifield

Массив мультиполей.
Подробнее о мультиполях можно почитать в разделе crm_multifield
Структура мультиполя:

  • id — Уникальный идентификатор
  • typeId — Тип мультиполя
  • valueType — Тип значения
  • value — Значение

Предложение

Название
тип

Описание

dateCreateShort
datetime

Время создания элемента (краткий формат).
Поле выключено

dateModifyShort
datetime

Время последнего изменения элемента (краткий формат).
Поле выключено

leadId
crm_lead

Идентификатор лида, на основании, которого создан элемент

dealId
crm_deal

Идентификатор сделки, привязанной к элементу

companyId
crm_company

Идентификатор компании, привязанной к элементу

contactId
crm_contact

Идентификатор контакта, привязанного к элементу

personTypeId
integer

Идентификатор типа плательщика

mycompanyId
crm_company

Идентификатор «моей» компании

title
string

Название элемента

stageId
crm_status

Строковый идентификатор стадии элемента

closed
boolean

Является ли сделка закрытой

opportunity
double

Сумма

isManualOpportunity
boolean

Установлен ли ручной режим расчеты суммы

taxValue
double

Сумма налога

currencyId
crm_currency

Идентификатор валюты элемента

comments
text

Комментарий

commentsType
integer

Идентификатор типа комментария.
Возможные значения:

  • 0 — неизвестно
  • 1 — текст
  • 2 — bb-код
  • 3 — HTML

begindate
date

Дата начала элемента

begindateShort
datetime

Время начала элемента (краткий формат).
Поле выключено

closedate
date

Дата завершения элемента

closedateShort
datetime

Время окончания элемента (краткий формат).
Поле выключено

quoteNumber
string

Номер предложения

content
text

Содержание

contentType
integer

Идентификатор типа содержания.
Возможные значения:

  • 0 — неизвестно
  • 1 — текст
  • 2 — bb-код
  • 3 — HTML

terms
text

Условия

termsType
integer

Идентификатор типа условия.
Возможные значения:

  • 0 — неизвестно
  • 1 — текст
  • 2 — bb-код
  • 3 — HTML

storageTypeId
integer

Идентификатор типа хранения

storageElementIds
integer[]

Массив файлов

locationId
location

Идентификатор местоположения. Служебное поле

clientTitle
string

Название клиента

clientAddr
string

Адрес клиента

clientContact
string

Контакты клиента

clientEmail
string

E-mail клиента

clientPhone
string

Телефон клиента

clientTpId
string

ИНН Клиента

clientTpaId
string

ТПП Клиента

searchContent
text

Информация для полнотекстового поиска. Служебное поле

hasProducts
boolean

Содержит ли элемент товары.
Поле выключено

actualDate
date

Актуально до

contactIds
crm_contact[]

Список идентификаторов контактов, привязанных к элементу

Счет

Название
тип

Описание

xmlId
string

Внешний код

title
string

Название элемента

movedBy
user

Идентификатор пользователя, который последним сменил стадию

movedTime
datetime

Время последней смены стадии

categoryId
crm_category

Идентификатор воронки (направления) элемента

stageId
crm_status

Строковый идентификатор стадии элемента

previousStageId
crm_status

Идентификатор типа предыдущей стадии

begindate
date

Дата начала элемента

closedate
date

Дата завершения элемента

companyId
crm_company

Идентификатор компании, привязанной к элементу

contactId
crm_contact

Идентификатор контакта, привязанного к элементу

opportunity
double

Сумма

isManualOpportunity
boolean

Установлен ли ручной режим расчеты суммы

taxValue
double

Сумма налога

currencyId
crm_currency

Идентификатор валюты элемента

mycompanyId
crm_company

Идентификатор «моей» компании

sourceId
crm_status

Строковый идентификатор типа источника

sourceDescription
text

Дополнительно об источнике

comments
text

Комментарий

accountNumber
string

Номер счета

locationId
location

Идентификатор местоположения.
Служебное поле

observers
user[]

Список идентификаторов пользователей, которые являются Наблюдателями

contactIds
crm_contact[]

Список идентификаторов контактов, привязанных к элементу

Смарт-процесс

Название
тип

Описание

xmlId
string

Внешний код

title
string

Название элемента

movedBy
user

Идентификатор пользователя, который последним сменил стадию.
Доступно лишь при включенной настройке isStagesEnabled у соответствующего смарт-процесса

movedTime
datetime

Время последней смены стадии.
Доступно лишь при включенной настройке isStagesEnabled у соответствующего смарт-процесса

categoryId
crm_category

Идентификатор воронки (направления) элемента

stageId
crm_status

Строковый идентификатор стадии элемента.
Доступно лишь при включенной настройке isStagesEnabled у соответствующего смарт-процесса

previousStageId
crm_status

Идентификатор типа предыдущей стадии.
Доступно лишь при включенной настройке isStagesEnabled у соответствующего смарт-процесса

begindate
date

Дата начала элемента.
Доступно лишь при включенной настройке isBeginCloseDatesEnabled у соответствующего смарт-процесса

closedate
date

Дата завершения элемента.
Доступно лишь при включенной настройке isBeginCloseDatesEnabled у соответствующего смарт-процесса

companyId
crm_company

Идентификатор компании, привязанной к элементу.
Доступно лишь при включенной настройке isClientEnabled у соответствующего смарт-процесса

contactId
crm_contact

Идентификатор контакта, привязанного к элементу.
Доступно лишь при включенной настройке isClientEnabled у соответствующего смарт-процесса

opportunity
double

Сумма.
Доступно лишь при включенной настройке isLinkWithProductsEnabled у соответствующего смарт-процесса

isManualOpportunity
boolean

Установлен ли ручной режим расчеты суммы.
Доступно лишь при включенной настройке isLinkWithProductsEnabled у соответствующего смарт-процесса

taxValue
double

Сумма налога.
Доступно лишь при включенной настройке isLinkWithProductsEnabled у соответствующего смарт-процесса

currencyId
crm_currency

Идентификатор валюты элемента.
Доступно лишь при включенной настройке isLinkWithProductsEnabled у соответствующего смарт-процесса

opportunityAccount
double

Сумма в валюте учета.
Устарело. Поле выключено.
Доступно лишь при включенной настройке isLinkWithProductsEnabled у соответствующего смарт-процесса

taxValueAccount
double

Сумма налога в валюте учета.
Устарело. Поле выключено.
Доступно лишь при включенной настройке isLinkWithProductsEnabled у соответствующего смарт-процесса

accountCurrencyId
crm_currency

Валюта учета.
Поле выключено.
Доступно лишь при включенной настройке isLinkWithProductsEnabled у соответствующего смарт-процесса

mycompanyId
crm_company

Идентификатор «моей» компании.
Доступно лишь при включенной настройке isMycompanyEnabled у соответствующего смарт-процесса

sourceId
crm_status

Строковый идентификатор типа источника.
Доступно лишь при включенной настройке isSourceEnabled у соответствующего смарт-процесса

sourceDescription
text

Дополнительно об источнике.
Доступно лишь при включенной настройке isSourceEnabled у соответствующего смарт-процесса

observers
user[]

Список идентификаторов пользователей, который являются Наблюдателями.
Доступно лишь при включенной настройке isObserversEnabled у соответствующего смарт-процесса

contactIds
crm_contact[]

Список идентификаторов контактов, привязанных к элементу.
Доступно лишь при включенной настройке isClientEnabled у соответствующего смарт-процесса