Коды полей Битрикс24 в 2025: инструкция по работе с API и настройке интеграций

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

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

Коды полей в Битрикс24 — это уникальные идентификаторы, которые система использует для обращения к конкретным полям через API. Они необходимы для:

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

Коды полей для лидов

Лиды — это потенциальные клиенты, которые проявили интерес к вашему продукту или услуге. Основные коды полей для лидов:

Основные поля лидов

• ID — уникальный номер лида
• TITLE — название лида
• NAME — имя
• LAST_NAME — фамилия
• SECOND_NAME — отчество
• COMPANY_TITLE — название компании
• SOURCE_ID — источник лида
• SOURCE_DESCRIPTION — описание источника
• STATUS_ID — статус лида
• STATUS_DESCRIPTION — описание статуса
• POST — должность
• COMMENTS — комментарий
• CURRENCY_ID — валюта
• OPPORTUNITY — предполагаемая сумма
• OPENED — доступен для всех (Y/N)
• ASSIGNED_BY_ID — ответственный
• CREATED_BY_ID — кем создан
• MODIFY_BY_ID — кем изменен
• DATE_CREATE — дата создания
• DATE_MODIFY — дата изменения
• DATE_CLOSED — дата закрытия
• STATUS_SEMANTIC_ID — семантика статуса
• HONORIFIC — обращение
• BIRTHDATE — дата рождения

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

• PHONE — телефон (массив)
• EMAIL — электронная почта (массив)
• WEB — сайт (массив)
• IM — мессенджеры (массив)

Адресные данные лидов

• ADDRESS — адрес
• ADDRESS_2 — адрес (строка 2)
• ADDRESS_CITY — город
• ADDRESS_POSTAL_CODE — почтовый индекс
• ADDRESS_REGION — регион
• ADDRESS_PROVINCE — область
• ADDRESS_COUNTRY — страна
• ADDRESS_COUNTRY_CODE — код страны

Коды полей для сделок

Сделки представляют собой коммерческие возможности с конкретными суммами и этапами продаж:

Основные поля сделок

• ID — уникальный номер сделки
• TITLE — название сделки
• TYPE_ID — тип сделки
• STAGE_ID — стадия сделки
• PROBABILITY — вероятность
• CURRENCY_ID — валюта
• OPPORTUNITY — сумма
• IS_MANUAL_OPPORTUNITY — ручная сумма
• TAX_VALUE — налоговая ставка
• COMPANY_ID — компания
• CONTACT_ID — контакт
• QUOTE_ID — предложение
• BEGINDATE — дата начала
• CLOSEDATE — дата завершения
• ASSIGNED_BY_ID — ответственный
• CREATED_BY_ID — кем создана
• MODIFY_BY_ID — кем изменена
• DATE_CREATE — дата создания
• DATE_MODIFY — дата изменения
• OPENED — доступна для всех
• CLOSED — закрыта
• COMMENTS — комментарий
• ADDITIONAL_INFO — дополнительная информация
• LOCATION_ID — местоположение
• CATEGORY_ID — направление (воронка)
• STAGE_SEMANTIC_ID — семантика стадии
• IS_NEW — новая сделка
• IS_RECURRING — повторяющаяся
• IS_RETURN_CUSTOMER — возвращающийся клиент
• IS_REPEATED_APPROACH — повторное обращение
• SOURCE_ID — источник
• SOURCE_DESCRIPTION — описание источника

UTM-метки для сделок

• UTM_SOURCE — источник UTM
• UTM_MEDIUM — канал UTM
• UTM_CAMPAIGN — кампания UTM
• UTM_CONTENT — содержание UTM
• UTM_TERM — ключевое слово UTM

Коды полей для контактов

Контакты — это физические лица, с которыми ведется работа:

Основные поля контактов

• ID — уникальный номер контакта
• HONORIFIC — обращение
• NAME — имя
• LAST_NAME — фамилия
• SECOND_NAME — отчество
• PHOTO — фотография
• BIRTHDATE — дата рождения
• TYPE_ID — тип контакта
• SOURCE_ID — источник
• SOURCE_DESCRIPTION — описание источника
• POST — должность
• COMMENTS — комментарий
• OPENED — доступен для всех
• EXPORT — участвует в экспорте
• ASSIGNED_BY_ID — ответственный
• CREATED_BY_ID — кем создан
• MODIFY_BY_ID — кем изменен
• DATE_CREATE — дата создания
• DATE_MODIFY — дата изменения
• COMPANY_ID — основная компания
• COMPANY_IDS — связанные компании
• LEAD_ID — лид
• ORIGINATOR_ID — внешний источник
• ORIGIN_ID — идентификатор элемента в источнике

Контактные данные

• PHONE — телефон
• EMAIL — электронная почта
• WEB — сайт
• IM — мессенджеры

Адресные данные контактов

• ADDRESS — адрес
• ADDRESS_2 — адрес (строка 2)
• ADDRESS_CITY — город
• ADDRESS_POSTAL_CODE — почтовый индекс
• ADDRESS_REGION — регион
• ADDRESS_PROVINCE — область
• ADDRESS_COUNTRY — страна
• ADDRESS_COUNTRY_CODE — код страны

Коды полей для компаний

Компании — это юридические лица и организации:

Основные поля компаний

• ID — уникальный номер компании
• TITLE — название компании
• LOGO — логотип
• COMPANY_TYPE — тип компании
• INDUSTRY — отрасль
• EMPLOYEES — количество сотрудников
• CURRENCY_ID — валюта
• REVENUE — годовой оборот
• OPENED — доступна для всех
• COMMENTS — комментарий
• ASSIGNED_BY_ID — ответственный
• CREATED_BY_ID — кем создана
• MODIFY_BY_ID — кем изменена
• DATE_CREATE — дата создания
• DATE_MODIFY — дата изменения
• LEAD_ID — лид
• ORIGINATOR_ID — внешний источник
• ORIGIN_ID — идентификатор элемента в источнике

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

• BANKING_DETAILS — банковские реквизиты
• REG_ADDRESS — юридический адрес

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

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

• UF_CRM_[НОМЕР] — для всех типов сущностей
• UF_CRM_LEAD_[НОМЕР] — для лидов
• UF_CRM_DEAL_[НОМЕР] — для сделок
• UF_CRM_CONTACT_[НОМЕР] — для контактов
• UF_CRM_COMPANY_[НОМЕР] — для компаний

Как узнать коды полей в Битрикс24

Существует несколько способов получить коды полей:

1. Через REST API

Используйте методы для получения описания полей:

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

2. Через интерфейс Битрикс24

В настройках CRM можно посмотреть коды полей в разделе «Настройки» → «Настройки CRM» → «Поля».

3. Через инструменты разработчика

В браузере можно посмотреть коды полей в HTML-коде страницы через инструменты разработчика.

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

Создание лида через REST API

Пример запроса для создания лида:

{
"fields": {
"TITLE": "Новый лид",
"NAME": "Иван",
"LAST_NAME": "Петров",
"PHONE": [{"VALUE": "+7 (495) 123-45-67", "VALUE_TYPE": "WORK"}],
"EMAIL": [{"VALUE": "ivan@example.com", "VALUE_TYPE": "WORK"}],
"SOURCE_ID": "WEB",
"OPPORTUNITY": 50000,
"CURRENCY_ID": "RUB",
"ASSIGNED_BY_ID": 1
}
}

Обновление сделки

Пример изменения стадии сделки:

{
"id": 123,
"fields": {
"STAGE_ID": "NEW",
"PROBABILITY": 80,
"CLOSEDATE": "2025-02-15",
"COMMENTS": "Переведена на следующий этап"
}
}

Массовое обновление контактов

Для массового обновления можно использовать коды полей в цикле:

{
"fields": {
"ASSIGNED_BY_ID": 5,
"SOURCE_ID": "CALL",
"UF_CRM_CONTACT_1234567890": "Новое значение"
}
}

Особенности работы с кодами полей

Множественные поля

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

"PHONE": [
{"VALUE": "+7 (495) 123-45-67", "VALUE_TYPE": "WORK"},
{"VALUE": "+7 (926) 123-45-67", "VALUE_TYPE": "MOBILE"}
]

Связанные поля

Для связи с другими сущностями используются ID:

• COMPANY_ID — ID компании
• CONTACT_ID — ID контакта
• ASSIGNED_BY_ID — ID пользователя

Поля с фиксированными значениями

Некоторые поля имеют предопределенные значения:

• CURRENCY_ID: RUB, USD, EUR
• HONORIFIC: HNR_RU_1 (Уважаемый), HNR_RU_2 (Уважаемая)
• SOURCE_ID: CALL, EMAIL, WEB, ADVERTISEMENT, PARTNER, RECOMMENDATION

Автоматизация с кодами полей

Коды полей активно используются в автоматизации:

Роботы

В роботах можно использовать коды полей для:

• Условий срабатывания
• Изменения значений полей
• Передачи данных в другие системы

Триггеры

Триггеры могут отслеживать изменения конкретных полей:

• Изменение статуса лида
• Изменение стадии сделки
• Изменение ответственного

Интеграции

При настройке интеграций коды полей используются для:

• Сопоставления полей между системами
• Передачи данных через веб-хуки
• Синхронизации информации

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

Пользовательские поля расширяют стандартную функциональность CRM:

Типы пользовательских полей

• string — строка
• integer — целое число
• double — число с плавающей точкой
• datetime — дата и время
• date — дата
• boolean — да/нет
• enumeration — список
• file — файл
• employee — привязка к сотруднику
• crm_status — справочник CRM

Создание пользовательских полей

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

• Интерфейс Битрикс24
• REST API методы userfield.*
• Приложения маркетплейса

Ошибки при работе с кодами полей

Часто встречающиеся ошибки:

Неверный формат поля

• Передача строки вместо числа
• Неправильный формат даты
• Неверная структура массива

Несуществующие коды

• Использование устаревших кодов
• Опечатки в названиях полей
• Неправильные коды пользовательских полей

Нарушение прав доступа

• Попытка изменить поле без прав
• Обращение к полю закрытой сущности

Лучшие практики работы с кодами полей

Планирование структуры

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

Тестирование

• Тестируйте все операции с полями на тестовом аккаунте
• Проверяйте корректность передачи данных
• Валидируйте форматы полей

Мониторинг

• Отслеживайте изменения в API Битрикс24
• Логируйте ошибки при работе с полями
• Регулярно проверяйте актуальность кодов

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

Postman

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

Webhook.site

Сервис для тестирования веб-хуков и отладки передачи данных.

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

Расширения для просмотра кодов полей прямо в интерфейсе Битрикс24.

Безопасность при работе с кодами полей

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

• Не передавайте конфиденциальные данные в открытом виде
• Используйте HTTPS для всех запросов
• Ограничивайте права доступа к полям
• Регулярно обновляйте токены доступа
• Логируйте все операции с данными

Обновления и изменения в кодах полей

Битрикс24 регулярно обновляется, что может повлиять на коды полей:

• Новые поля добавляются в обновлениях
• Старые поля могут быть помечены как устаревшие
• Изменяются правила валидации
• Обновляются форматы данных

Рекомендуется регулярно проверять документацию API и тестировать интеграции после обновлений.

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

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