Блог Горошко Андрея Bitrix24,PHP Получить описание полей компании crm.company.fields

Получить описание полей компании crm.company.fields

При разработке и поддержке проектов на платформе 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());
        }
    );

Поля

ПолеОписаниеПримечание
ADDRESS
string
Адрес компании
ADDRESS_2
string
Вторая страница адресаВ некоторых странах принято разбивать адрес на 2 части
ADDRESS_CITY
string
Город
ADDRESS_COUNTRY
string
Страна
ADDRESS_COUNTRY_CODE
string
Код страны
ADDRESS_LEGAL
string
ADDRESS_POSTAL_CODE
string
Почтовый индекс
ADDRESS_PROVINCE
string
Область
ADDRESS_REGION
string
Район
ASSIGNED_BY_ID
user
Связано с пользователем по ID
BANKING_DETAILS
string
Банковские реквизиты
COMMENTS
string
Комментарии
COMPANY_TYPE
crm_status
Тип компании
CREATED_BY_ID
user
Кем созданаТолько для чтения
CURRENCY_ID
crm_currency
Валюта
DATE_CREATE
datetime
Дата созданияТолько для чтения
DATE_MODIFY
datetime
Дата измененияТолько для чтения
EMAIL
crm_multifield
Адрес электронной почтыМножественное
EMPLOYEES
crm_status
Количество сотрудников
HAS_EMAIL
char
Проверка заполненности поля электронной почтыТолько для чтения
HAS_PHONE
char
Проверка заполненности поля телефонаТолько для чтения
ID
integer
Идентификатор компанииТолько для чтения
IM
crm_multifield
МессенджерыМножественное
INDUSTRY
crm_status
Сфера деятельности
IS_MY_COMPANY
char
LEAD_ID
crm_lead
Идентификатор лида, связанного с компаниейТолько для чтения
LOGO
file
Логотип
MODIFY_BY_ID
user
Идентификатор автора последнего измененияТолько для чтения
OPENED
char
Доступен для всех
ORIGINATOR_ID
string
Идентификатор источника данныхИспользуется только для привязки к внешнему источнику.
ORIGIN_ID
string
Идентификатор элемента в источнике данныхИспользуется только для привязки к внешнему источнику.
ORIGIN_VERSION
string
Оригинальная версияИспользуется для защиты данных от случайного перетирания внешней системой. Если данные были импортированы и не изменялись во внешней системе, то такие данные могут быть редактированы в CRM без опасения, что следующая выгрузка приведет к перетиранию данных
PHONE
crm_multifield
Телефон компанииМножественное
REG_ADDRESS
string
Юридический адрес компанииУстарел, используется для совместимости.
REG_ADDRESS_2
string
Вторая страница юридического адресаВ некоторых странах принято разбивать адрес на 2 части. Устарел, используется для совместимости.
REG_ADDRESS_CITY
string
Город юридического адресаУстарел, используется для совместимости.
REG_ADDRESS_COUNTRY
string
Страна юридического адресаУстарел, используется для совместимости.
REG_ADDRESS_COUNTRY_CODE
string
Код страны юридического адресаУстарел, используется для совместимости.
REG_ADDRESS_LEGAL
string
Устарел, используется для совместимости.
REG_ADDRESS_POSTAL_CODE
string
Почтовый индекс юридического адресаУстарел, используется для совместимости.
REG_ADDRESS_PROVINCE
string
Область юридического адресаУстарел, используется для совместимости.
REG_ADDRESS_REGION
string
Район юридического адресаУстарел, используется для совместимости.
REVENUE
double
Годовой оборот
TITLE
string
НазваниеОбязательное
UTM_CAMPAIGN
string
Обозначение рекламной кампании
UTM_CONTENT
string
Содержание кампанииНапример, для контекстных объявлений.
UTM_MEDIUM
string
Тип трафикаCPC (объявления), CPM (баннеры)
UTM_SOURCE
string
Рекламная системаYandex-Direct, Google-Adwords и другие.
UTM_TERM
string
Условие поиска кампанииНапример, ключевые слова контекстной рекламы.
WEB
crm_multifield
URL ресурсов компанииМножественное

💡 Экспертное мнение и рекомендации

Практические рекомендации:

  • При написании кастомных компонентов для «Получить описание полей компании crm.company.fields» всегда разделяйте бизнес-логику и представление (шаблон).
  • Используйте отладку SQL-запросов через конструкцию $wpdb->last_query или стандартный трекер Битрикса, чтобы контролировать нагрузку.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Как использовать метод SDK entity.section.add в Битрикс24Как использовать метод SDK entity.section.add в Битрикс24

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Как использовать метод SDK entity.section.add в Битрикс24». Мы подготовили подробный разбор принципов работы и развернутые

Получить список включаемых областей для страницы landing.template.getLandingRefПолучить список включаемых областей для страницы landing.template.getLandingRef

Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Получить список включаемых областей для страницы landing.template.getLandingRef». Вы узнаете экспертные методики работы с

Входящая очередь событийВходящая очередь событий

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Входящая очередь событий», проанализируем лучшие практики и покажем,