Блог Горошко Андрея Bitrix24,PHP Создать новый банковский реквизит crm.requisite.bankdetail.add

Создать новый банковский реквизит crm.requisite.bankdetail.add

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

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

Создать новый банковский реквизит crm.requisite.bankdetail.add

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

Метод создает новый банковский реквизит.

Параметры метода

Название
тип		Описание
fields
object		Набор полей — объект вида {"поле": "значение"[, ...]} для добавления банковского реквизита

Параметр fields

Название
тип		Описание
ENTITY_ID
integer		Идентификатор родительского объекта. Сейчас может быть только идентификатор реквизита. Идентификаторы реквизитов можно получить с помощью метода crm.requisite.list
COUNTRY_ID
integer		Идентификатор страны, которой соответствует набор полей банковского реквизита (смотрите метод crm.requisite.preset.countries для получения доступных значений).

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

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		Идентификатор внешней информационной базы. Назначение поля может меняться конечным разработчиком

Примеры кода

  • cURL (Webhook)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"fields":{"ENTITY_ID":27,"COUNTRY_ID":1,"NAME":"Супербанк","RQ_BANK_NAME":"ПАО Супербанк","RQ_BANK_ADDR":"117312, г. Москва, улица Вавилова, дом 19","RQ_BIK":"044525225","RQ_ACC_NUM":"40702810938000060473","RQ_ACC_CURRENCY":"RUR","RQ_COR_ACC_NUM":"30101810400000000225","XML_ID":"1e4641fd-2dd9-31e6-b2f2-105056c00008","ACTIVE":"Y","SORT":600}}' \
    https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.requisite.bankdetail.add
  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"fields":{"ENTITY_ID":27,"COUNTRY_ID":1,"NAME":"Супербанк","RQ_BANK_NAME":"ПАО Супербанк","RQ_BANK_ADDR":"117312, г. Москва, улица Вавилова, дом 19","RQ_BIK":"044525225","RQ_ACC_NUM":"40702810938000060473","RQ_ACC_CURRENCY":"RUR","RQ_COR_ACC_NUM":"30101810400000000225","XML_ID":"1e4641fd-2dd9-31e6-b2f2-105056c00008","ACTIVE":"Y","SORT":600},"auth":"**put_access_token_here**"}' \
    https://**put_your_bitrix24_address**/rest/crm.requisite.bankdetail.add
  • JS
    try
    {
    	const response = await $b24.callMethod(
    		"crm.requisite.bankdetail.add",
    		{
    			fields:
    			{
    				"ENTITY_ID": 27,                 // Идентификатор реквизита
    				"COUNTRY_ID": 1,                 // Код страны (Россия)
    				"NAME": "Супербанк",              // Название банковского реквизита
    				"RQ_BANK_NAME": "ПАО Супербанк",  // Наименование банка
    				"RQ_BANK_ADDR": "117312, г. Москва, улица Вавилова, дом 19",
    				"RQ_BIK": "044525225",
    				"RQ_ACC_NUM": "40702810938000060473",
    				"RQ_ACC_CURRENCY": "RUR",
    				"RQ_COR_ACC_NUM": "30101810400000000225",
    				"XML_ID":"1e4641fd-2dd9-31e6-b2f2-105056c00008",
    				"ACTIVE":"Y",
    				"SORT":600
    			}
    		}
    	);
    	
    	const result = response.getData().result;
    	console.info("Создан банковский реквизит с ID " + result);
    }
    catch(error)
    {
    	console.error(error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'crm.requisite.bankdetail.add',
                [
                    'fields' => [
                        'ENTITY_ID'       => 27,
                        'COUNTRY_ID'      => 1,
                        'NAME'            => 'Супербанк',
                        'RQ_BANK_NAME'    => 'ПАО Супербанк',
                        'RQ_BANK_ADDR'    => '117312, г. Москва, улица Вавилова, дом 19',
                        'RQ_BIK'          => '044525225',
                        'RQ_ACC_NUM'      => '40702810938000060473',
                        'RQ_ACC_CURRENCY' => 'RUR',
                        'RQ_COR_ACC_NUM'  => '30101810400000000225',
                        'XML_ID'          => '1e4641fd-2dd9-31e6-b2f2-105056c00008',
                        'ACTIVE'          => 'Y',
                        'SORT'            => 600,
                    ],
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        echo 'Создан банковский реквизит с ID ' . $result;
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error creating bank detail: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        "crm.requisite.bankdetail.add",
        {
            fields:
            {
                "ENTITY_ID": 27,                 // Идентификатор реквизита
                "COUNTRY_ID": 1,                 // Код страны (Россия)
                "NAME": "Супербанк",              // Название банковского реквизита
                "RQ_BANK_NAME": "ПАО Супербанк",  // Наименование банка
                "RQ_BANK_ADDR": "117312, г. Москва, улица Вавилова, дом 19",
                "RQ_BIK": "044525225",
                "RQ_ACC_NUM": "40702810938000060473",
                "RQ_ACC_CURRENCY": "RUR",
                "RQ_COR_ACC_NUM": "30101810400000000225",
                "XML_ID":"1e4641fd-2dd9-31e6-b2f2-105056c00008",
                "ACTIVE":"Y",
                "SORT":600
            }
        },
        function(result)
        {
            if(result.error())
                console.error(result.error());
            else
                console.info("Создан банковский реквизит с ID " + result.data());
        }
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'crm.requisite.bankdetail.add',
        [
            'fields' => [
                'ENTITY_ID' => 27,
                'COUNTRY_ID' => 1,
                'NAME' => 'Супербанк',
                'RQ_BANK_NAME' => 'ПАО Супербанк',
                'RQ_BANK_ADDR' => '117312, г. Москва, улица Вавилова, дом 19',
                'RQ_BIK' => '044525225',
                'RQ_ACC_NUM' => '40702810938000060473',
                'RQ_ACC_CURRENCY' => 'RUR',
                'RQ_COR_ACC_NUM' => '30101810400000000225',
                'XML_ID' => '1e4641fd-2dd9-31e6-b2f2-105056c00008',
                'ACTIVE' => 'Y',
                'SORT' => 600
            ]
        ]
    );

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

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

HTTP-статус: 200

{
    "result": 357,
    "time": {
        "start": 1717429942.060649,
        "finish": 1717429942.626925,
        "duration": 0.5662760734558105,
        "processing": 0.09111285209655762,
        "date_start": "2024-06-03T17:52:22+02:00",
        "date_finish": "2024-06-03T17:52:22+02:00",
        "operating": 0
    }
}

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

Название
тип		Описание
result
integer		Идентификатор созданного банковского реквизита
time
time		Информация о времени выполнения запроса

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

HTTP-статус: 40x, 50x

{
    "error": "",
    "error_description": "ENTITY_ID is not defined or invalid."
}

Возможные ошибки

Текст ошибкиОписание
ENTITY_ID is not defined or invalidИдентификатор реквизита не определен или имеет недопустимое значение
Access deniedНедостаточно прав доступа для добавления банковского реквизита
  • [](./crm-requisite-bank-detail-update)
  • [](./crm-requisite-bank-detail-get)
  • [](./crm-requisite-bank-detail-list)
  • [](./crm-requisite-bank-detail-delete)
  • [](./crm-requisite-bank-detail-fields)

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

Советы эксперта по интеграции:

  • Всегда используйте кэширование при частых запросах к crm.requisite.bankdetail.add, чтобы разгрузить базу данных.
  • Соблюдайте стандарты PSR при написании обработчиков для «Создать новый банковский реквизит crm.requisite.bankdetail.add».
  • Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.

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

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

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

Related Post

Удалить подразделение department.deleteУдалить подразделение department.delete

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

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

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

Как использовать метод SDK crm.timeline.bindings.list в Битрикс24Как использовать метод SDK crm.timeline.bindings.list в Битрикс24

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

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

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

Настройка дашбордов и аналитических отчетов для руководителя в Битрикс24Настройка дашбордов и аналитических отчетов для руководителя в Битрикс24

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

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

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