При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Получить описание полей компании crm.company.fields», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.
Получить описание полей компании crm.company.fields
Тут может не хватать некоторых данных — дополним в ближайшее время
- нужны правки под стандарт написания
- отсутствует ответ в случае успеха
- отсутствует ответ в случае ошибки
- не прописаны ссылки на несозданные ещё страницы
- не хватает описания у некоторых полей
> Scope: crm
>
> Кто может выполнять метод: любой пользователь
Метод crm.company.fields возвращает описание полей компании, в том числе пользовательских.
Входящие параметры и конфигурация метода
Без параметров.
Практические примеры использования в коде
- JS
try
{
const response = await $b24.callMethod(
'crm.company.fields',
{}
);
const result = response.getData().result;
if(result.error())
{
console.error(result.error());
}
else
{
console.dir(result);
}
}
catch(error)
{
console.error('Error:', error);
}- PHP
try {
$response = $b24Service
->core
->call(
'crm.company.fields',
[]
);
$result = $response
->getResponseData()
->getResult();
if ($result->error()) {
error_log($result->error());
} else {
echo 'Success: ' . print_r($result->data(), true);
}
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error fetching company fields: ' . $e->getMessage();
}- BX24.js
BX24.callMethod(
"crm.company.fields",
{},
function(result)
{
if(result.error())
console.error(result.error());
else
console.dir(result.data());
}
);Поля
| Поле | Описание | Примечание |
|---|---|---|
ADDRESSstring | Адрес компании | |
ADDRESS_2string | Вторая страница адреса | В некоторых странах принято разбивать адрес на 2 части |
ADDRESS_CITYstring | Город | |
ADDRESS_COUNTRYstring | Страна | |
ADDRESS_COUNTRY_CODEstring | Код страны | |
ADDRESS_LEGALstring | ||
ADDRESS_POSTAL_CODEstring | Почтовый индекс | |
ADDRESS_PROVINCEstring | Область | |
ADDRESS_REGIONstring | Район | |
ASSIGNED_BY_IDuser | Связано с пользователем по ID | |
BANKING_DETAILSstring | Банковские реквизиты | |
COMMENTSstring | Комментарии | |
COMPANY_TYPEcrm_status | Тип компании | |
CREATED_BY_IDuser | Кем создана | Только для чтения |
CURRENCY_IDcrm_currency | Валюта | |
DATE_CREATEdatetime | Дата создания | Только для чтения |
DATE_MODIFYdatetime | Дата изменения | Только для чтения |
EMAILcrm_multifield | Адрес электронной почты | Множественное |
EMPLOYEEScrm_status | Количество сотрудников | |
HAS_EMAILchar | Проверка заполненности поля электронной почты | Только для чтения |
HAS_PHONEchar | Проверка заполненности поля телефона | Только для чтения |
IDinteger | Идентификатор компании | Только для чтения |
IMcrm_multifield | Мессенджеры | Множественное |
INDUSTRYcrm_status | Сфера деятельности | |
IS_MY_COMPANYchar | ||
LEAD_IDcrm_lead | Идентификатор лида, связанного с компанией | Только для чтения |
LOGOfile | Логотип | |
MODIFY_BY_IDuser | Идентификатор автора последнего изменения | Только для чтения |
OPENEDchar | Доступен для всех | |
ORIGINATOR_IDstring | Идентификатор источника данных | Используется только для привязки к внешнему источнику. |
ORIGIN_IDstring | Идентификатор элемента в источнике данных | Используется только для привязки к внешнему источнику. |
ORIGIN_VERSIONstring | Оригинальная версия | Используется для защиты данных от случайного перетирания внешней системой. Если данные были импортированы и не изменялись во внешней системе, то такие данные могут быть редактированы в CRM без опасения, что следующая выгрузка приведет к перетиранию данных |
PHONEcrm_multifield | Телефон компании | Множественное |
REG_ADDRESSstring | Юридический адрес компании | Устарел, используется для совместимости. |
REG_ADDRESS_2string | Вторая страница юридического адреса | В некоторых странах принято разбивать адрес на 2 части. Устарел, используется для совместимости. |
REG_ADDRESS_CITYstring | Город юридического адреса | Устарел, используется для совместимости. |
REG_ADDRESS_COUNTRYstring | Страна юридического адреса | Устарел, используется для совместимости. |
REG_ADDRESS_COUNTRY_CODEstring | Код страны юридического адреса | Устарел, используется для совместимости. |
REG_ADDRESS_LEGALstring | Устарел, используется для совместимости. | |
REG_ADDRESS_POSTAL_CODEstring | Почтовый индекс юридического адреса | Устарел, используется для совместимости. |
REG_ADDRESS_PROVINCEstring | Область юридического адреса | Устарел, используется для совместимости. |
REG_ADDRESS_REGIONstring | Район юридического адреса | Устарел, используется для совместимости. |
REVENUEdouble | Годовой оборот | |
TITLEstring | Название | Обязательное |
UTM_CAMPAIGNstring | Обозначение рекламной кампании | |
UTM_CONTENTstring | Содержание кампании | Например, для контекстных объявлений. |
UTM_MEDIUMstring | Тип трафика | CPC (объявления), CPM (баннеры) |
UTM_SOURCEstring | Рекламная система | Yandex-Direct, Google-Adwords и другие. |
UTM_TERMstring | Условие поиска кампании | Например, ключевые слова контекстной рекламы. |
WEBcrm_multifield | URL ресурсов компании | Множественное |
💡 Экспертное мнение и рекомендации
Практические рекомендации:
- При написании кастомных компонентов для «Получить описание полей компании crm.company.fields» всегда разделяйте бизнес-логику и представление (шаблон).
- Используйте отладку SQL-запросов через конструкцию
$wpdb->last_queryили стандартный трекер Битрикса, чтобы контролировать нагрузку.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru