Блог Горошко Андрея Bitrix24,PHP Получить описание полей банковских реквизитов crm.requisite.bankdetail.fields

Получить описание полей банковских реквизитов crm.requisite.bankdetail.fields

goroshckogoroshcko| Нет комментария|
Рубрики:

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

Получить описание полей банковских реквизитов crm.requisite.bankdetail.fields

> Scope: crm
>
> Кто может выполнять метод: любой пользователь

Метод возвращает формальное описание полей банковских реквизитов.

Без параметров.

Примеры кода

  • cURL (Webhook)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{}' \
    https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.requisite.bankdetail.fields
  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"auth":"**put_access_token_here**"}' \
    https://**put_your_bitrix24_address**/rest/crm.requisite.bankdetail.fields
  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'crm.requisite.bankdetail.fields',
    		{}
    	);
    	
    	const result = response.getData().result;
    	console.dir(result);
    }
    catch( error )
    {
    	console.error('Error:', error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'crm.requisite.bankdetail.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 bank detail fields: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        "crm.requisite.bankdetail.fields",
        {},
        function(result)
        {
            if(result.error())
                console.error(result.error());
            else
                console.dir(result.data());
        }
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'crm.requisite.bankdetail.fields',
        []
    );

    echo '<PRE>';
    print_r($result);
    echo '</PRE>';

Обработка ответа

HTTP-статус: 200

{
    "result": {
        "ID": {
            "type": "integer",
            "isRequired": false,
            "isReadOnly": true,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "ID"
        },
        "ENTITY_ID": {
            "type": "integer",
            "isRequired": true,
            "isReadOnly": false,
            "isImmutable": true,
            "isMultiple": false,
            "isDynamic": false,
            "title": "ID объекта"
        },
        "COUNTRY_ID": {
            "type": "integer",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "ID страны"
        },
        "DATE_CREATE": {
            "type": "datetime",
            "isRequired": false,
            "isReadOnly": true,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Дата создания"
        },
        "DATE_MODIFY": {
            "type": "datetime",
            "isRequired": false,
            "isReadOnly": true,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Дата изменения"
        },
        "CREATED_BY_ID": {
            "type": "user",
            "isRequired": false,
            "isReadOnly": true,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Создал"
        },
        "MODIFY_BY_ID": {
            "type": "user",
            "isRequired": false,
            "isReadOnly": true,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Изменил"
        },
        "NAME": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Название"
        },
        "CODE": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Код"
        },
        "XML_ID": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Внешний код"
        },
        "ACTIVE": {
            "type": "char",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Активен"
        },
        "SORT": {
            "type": "integer",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Сортироква"
        },
        "RQ_BANK_NAME": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Наименование банка"
        },
        "RQ_BANK_ADDR": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Адрес банка"
        },
        "RQ_BANK_CODE": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "RQ_BANK_CODE"
        },
        "RQ_AGENCY_NAME": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "RQ_AGENCY_NAME"
        },
        "RQ_BANK_ROUTE_NUM": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "RQ_BANK_ROUTE_NUM"
        },
        "RQ_BIK": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "БИК"
        },
        "RQ_MFO": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "RQ_MFO"
        },
        "RQ_ACC_NAME": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "RQ_ACC_NAME"
        },
        "RQ_ACC_NUM": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Расчетный счёт"
        },
        "RQ_ACC_TYPE": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "RQ_ACC_TYPE"
        },
        "RQ_IIK": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "RQ_IIK"
        },
        "RQ_ACC_CURRENCY": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Валюта счёта"
        },
        "RQ_COR_ACC_NUM": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Кор. счёт"
        },
        "RQ_IBAN": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "RQ_IBAN"
        },
        "RQ_SWIFT": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "SWIFT"
        },
        "RQ_BIC": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "RQ_BIC"
        },
        "RQ_CODEB": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "RQ_CODEB"
        },
        "RQ_CODEG": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "RQ_CODEG"
        },
        "RQ_RIB": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "RQ_RIB"
        },
        "COMMENTS": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Комментарий"
        },
        "ORIGINATOR_ID": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": false,
            "title": "Внешний источник"
        }
    },
    "time": {
        "start": 1717409814.796487,
        "finish": 1717409815.225673,
        "duration": 0.4291858673095703,
        "processing": 0.013273000717163086,
        "date_start": "2024-06-03T12:16:54+02:00",
        "date_finish": "2024-06-03T12:16:55+02:00",
        "operating": 0
    }
}

Возвращаемые данные

Название
тип		Описание
result
object		Объект в формате {"field_1": "value_1", ... "field_N": "value_N"}, где field — идентификатор поля, а value — объект с атрибутами поля
time
time		Информация о времени выполнения запроса

Описание полей банковских реквизитов

Название
тип		Описание
ID
integer		Идентификатор банковского реквизита. Создается автоматически и уникален в рамках портала
ENTITY_ID
integer		Идентификатор родительского объекта. Сейчас может быть только идентификатор реквизита.

Идентификаторы реквизитов можно получить с помощью метода crm.requisite.list

COUNTRY_ID
integer		Идентификатор страны, которой соответствует набор полей банковского реквизита (смотрите метод crm.requisite.preset.countries для получения доступных значений).

Код страны банковского реквизита совпадает с кодом страны в привязанном шаблоне реквизитов, идентификатор которого указан в поле ENTITY_ID

DATE_CREATE
datetime		Дата создания
DATE_MODIFY
datetime		Дата изменения
CREATED_BY_ID
user		Идентификатор пользователя, создавшего реквизит
MODIFY_BY_ID
user		Идентификатор пользователя, изменившего реквизит
NAME
string		Название банковского реквизита
CODE
string		Символьный код реквизита
XML_ID
string		Внешний ключ. Используется для операций обмена. Идентификатор объекта внешней информационной базы.

Назначение поля может меняться конечным разработчиком. Каждое приложение обеспечивает уникальность значений в этом поле.

Рекомендуется использовать уникальный префикс для избежания коллизий с другими приложениями

ACTIVE
char		Признак активности. Используются значения Y или N.

Сейчас поле фактически ни на что не влияет

SORT
integer		Сортировка
RQ_BANK_NAME
string		Наименование банка
RQ_BANK_ADDR
string		Адрес банка
RQ_BANK_CODE
string		Código do banco (для страны BR)
RQ_BANK_ROUTE_NUM
string		Bank Routing Number
RQ_BIK
string		БИК
RQ_CODEB
string		Code Banque (для страны FR)
RQ_CODEG
string		Code Guichet (для страны FR)
RQ_RIB
string		Clé RIB (для страны FR)
RQ_MFO
string		МФО
RQ_ACC_NAME
string		Bank Account Holder Name
RQ_ACC_NUM
string		Bank Account Number
RQ_ACC_TYPE
string		Tipo da conta (для страны BR)
RQ_AGENCY_NAME
string		Agência (для страны BR)
RQ_IIK
string		ИИК
RQ_ACC_CURRENCY
string		Валюта счета
RQ_COR_ACC_NUM
string		Корреспондентский счет
RQ_IBAN
string		IBAN
RQ_SWIFT
string		SWIFT
RQ_BIC
string		BIC
COMMENTS
string		Комментарий
ORIGINATOR_ID
string		Идентификатор внешней информационной базы. Назначение поля может меняться конечным разработчиком

Описание атрибутов {#attributes}

Название
тип		Описание
type
string		Тип поля
isRequired
boolean		Атрибут «обязательное». Возможные значения:
— true — да
— false — нет
isReadOnly
boolean		Атрибут «только для чтения». Возможные значения:
— true — да
— false — нет
isImmutable
boolean		Атрибут «неизменяемое». Возможные значения:
— true — да
— false — нет
isMultiple
boolean		Атрибут «мультиполе». Возможные значения:
— true — да
— false — нет
isDynamic
boolean		Атрибут «пользовательское». Возможные значения:
— true — да
— false — нет
title
string		Идентификатор поля

Обработка ошибок

  • [](./crm-requisite-bank-detail-add)
  • [](./crm-requisite-bank-detail-update)
  • [](./crm-requisite-bank-detail-get)
  • [](./crm-requisite-bank-detail-list)
  • [](./crm-requisite-bank-detail-delete)

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

Ключевые выводы по теме «Получить описание полей банковских реквизитов crm.requisite.bankdetail.fields»:

Использование современных стандартов D7 при работе с crm.requisite.bankdetail.fields позволяет писать чистый, масштабируемый и безопасный код. Не забывайте обрабатывать исключения (try/catch) и проверять права доступа текущего пользователя перед выполнением критических операций.

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

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

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

Related Post

Обучение сотрудников и руководителей работе в Битрикс24Обучение сотрудников и руководителей работе в Битрикс24

22.08.202622.08.2026| goroshckogoroshcko| Нет комментария|

Профессиональная настройка и внедрение Битрикс24 CRM позволяет систематизировать работу отдела продаж, исключить потерю лидов и автоматизировать ключевые бизнес-процессы компании. Услуга «Обучение сотрудников и руководителей работе в Битрикс24» обеспечивает проведение вебинаров,

Читать далееЧитать далее

Событие при создании бронирования onBookingAddСобытие при создании бронирования onBookingAdd

25.05.202625.05.2026| goroshckogoroshcko| Нет комментария|

Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Событие при создании бронирования onBookingAdd». Вы узнаете экспертные методики работы с событие создании

Читать далееЧитать далее

Обновить связь дела с элементом CRM crm.activity.binding.moveОбновить связь дела с элементом CRM crm.activity.binding.move

25.05.202625.05.2026| goroshckogoroshcko| Нет комментария|

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Обновить связь дела с элементом CRM crm.activity.binding.move». Мы подготовили подробный разбор принципов работы и развернутые

Читать далееЧитать далее