ID полей Битрикс24 в 2025: инструкция по поиску и использованию идентификаторов

Введение

При работе с API Битрикс24 или настройке сложных бизнес-процессов часто возникает необходимость знать точные идентификаторы полей системы. В этой статье мы подробно разберем, как найти ID любого поля в Битрикс24, включая поле ответственного, пользовательские поля и системные идентификаторы элементов.

Что такое ID полей в Битрикс24

ID поля — это уникальный идентификатор, который присваивается каждому полю в системе Битрикс24. Эти идентификаторы используются для:

• Работы с REST API
• Настройки веб-хуков
• Создания пользовательских интеграций
• Автоматизации бизнес-процессов
• Импорта и экспорта данных

Знание правильных ID полей критически важно для корректной работы любых автоматизированных процессов в CRM.

Способы получения ID полей в Битрикс24

1. Использование REST API для получения списка полей

Наиболее надежный способ получить все ID полей — воспользоваться методами REST API:

• crm.deal.fields — для получения полей сделок
• crm.lead.fields — для получения полей лидов
• crm.contact.fields — для получения полей контактов
• crm.company.fields — для получения полей компаний

Пример запроса для получения полей сделок:

https://your-domain.bitrix24.ru/rest/your-user-id/your-webhook-code/crm.deal.fields

2. Инспектор браузера для поиска ID полей

Простой способ найти ID поля без использования API:

1. Откройте карточку элемента (сделки, лида, контакта)
2. Нажмите F12 для открытия инспектора браузера
3. Найдите нужное поле в HTML-коде
4. Найдите атрибут name или id элемента формы

Обычно ID поля содержится в названии элемента формы и имеет структуру вида: TITLE, OPPORTUNITY, ASSIGNED_BY_ID.

3. Использование тестового REST-клиента

В Битрикс24 есть встроенный инструмент для тестирования REST API:

1. Перейдите в раздел «Разработчикам» → «REST API»
2. Используйте тестовый клиент для выполнения запросов
3. Выполните запрос к методу получения полей

Основные системные ID полей

Общие поля для всех сущностей CRM

• ID — уникальный идентификатор записи
• TITLE — название/заголовок
• ASSIGNED_BY_ID — ID ответственного сотрудника
• CREATED_BY_ID — ID создателя записи
• MODIFY_BY_ID — ID последнего редактора
• DATE_CREATE — дата создания
• DATE_MODIFY — дата последнего изменения

Специфические поля сделок

• OPPORTUNITY — сумма сделки
• CURRENCY_ID — валюта
• STAGE_ID — стадия сделки
• PROBABILITY — вероятность
• CLOSEDATE — планируемая дата закрытия
• TYPE_ID — тип сделки
• SOURCE_ID — источник

Поля лидов

• NAME — имя
• LAST_NAME — фамилия
• SECOND_NAME — отчество
• COMPANY_TITLE — название компании
• STATUS_ID — статус лида
• SOURCE_ID — источник
• PHONE — телефон
• EMAIL — email

ID поля ответственного в Битрикс24

Поле ответственного имеет особое значение в CRM-системе. Во всех сущностях Битрикс24 ID поля ответственного — ASSIGNED_BY_ID.

Особенности работы с полем ответственного

• Значение поля — это ID пользователя в системе
• Можно получить список всех пользователей через метод user.get
• При создании новой записи поле заполняется автоматически
• Изменение ответственного влияет на права доступа к записи

Пользовательские поля и их идентификаторы

Пользовательские поля в Битрикс24 имеют специальную структуру ID:

• UF_CRM_XXX — для полей, добавленных через интерфейс
• Где XXX — уникальный числовой или текстовый идентификатор

Как найти ID пользовательского поля

1. Перейдите в настройки CRM
2. Выберите нужную сущность (Сделки, Лиды, Контакты)
3. Найдите раздел «Пользовательские поля»
4. ID поля отображается в списке или в URL при редактировании

Практические примеры использования ID полей

Пример 1: Получение данных через REST API

Запрос для получения сделки с определенными полями:

crm.deal.get?id=123&select[]=TITLE&select[]=OPPORTUNITY&select[]=ASSIGNED_BY_ID

Пример 2: Обновление поля ответственного

Обновление ответственного за сделку:

crm.deal.update?id=123&fields[ASSIGNED_BY_ID]=456

Пример 3: Работа с пользовательскими полями

Установка значения пользовательского поля:

crm.deal.update?id=123&fields[UF_CRM_123456789]=новое_значение

Получение ID элементов в Битрикс24

Помимо ID полей, часто требуется получить ID самих элементов системы:

ID записей CRM

• Отображается в URL при просмотре записи
• Доступен через методы crm.*.list
• Возвращается при создании новой записи

ID пользователей

• Получить через метод user.get
• Отображается в профиле пользователя
• Используется в полях ответственного

Частые ошибки при работе с ID полей

Ошибка 1: Неправильный формат ID

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

Ошибка 2: Игнорирование регистра

ID полей в Битрикс24 чувствительны к регистру. Используйте точное написание: ASSIGNED_BY_ID, а не assigned_by_id.

Ошибка 3: Неучет множественных полей

Некоторые поля могут содержать массивы значений (например, телефоны, email). Учитывайте это при работе с API.

Инструменты для работы с ID полей

Postman или аналогичные REST-клиенты

Удобны для тестирования API-запросов и получения структуры полей.

Браузерные расширения

Существуют специальные расширения для работы с Битрикс24 API, которые упрощают получение ID полей.

Встроенные инструменты Битрикс24

Используйте встроенный REST-клиент для быстрого получения информации о полях.

Автоматизация работы с ID полей

Создание справочника полей

Рекомендуется создать и поддерживать актуальный справочник ID полей для вашего портала, включающий:

• Системные поля всех сущностей
• Пользовательские поля
• Поля, добавленные через маркетплейс
• Описание назначения каждого поля

Мониторинг изменений

При обновлениях Битрикс24 могут добавляться новые поля. Регулярно обновляйте справочник полей.

Заключение

Знание ID полей в Битрикс24 — основа для эффективной работы с API и автоматизации бизнес-процессов. Используйте REST API методы для получения актуальной информации о полях, ведите документацию по используемым идентификаторам и регулярно обновляйте справочники.

Особое внимание уделите полю ответственного (ASSIGNED_BY_ID), так как оно играет ключевую роль в управлении доступом и распределении задач в CRM.

Наша команда предоставляет профессиональные услуги по настройке и внедрению Битрикс24. Мы поможем вам правильно настроить интеграции, автоматизировать бизнес-процессы и оптимизировать работу с CRM-системой. Обращайтесь к нам за консультацией по любым вопросам, связанным с настройкой Битрикс24 под ваши бизнес-потребности.