При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Получить банковский реквизит по id crm.requisite.bankdetail.get», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.
Получить банковский реквизит по id crm.requisite.bankdetail.get
> Scope: crm
>
> Кто может выполнять метод: любой пользователь
Метод возвращает банковский реквизит по идентификатору.
Параметры метода
Названиетип | Описание |
|---|---|
idinteger | Идентификатор банковского реквизита. Идентификаторы банковских реквизитов можно получить с помощью метода |
Примеры кода
- cURL (Webhook)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":357}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.requisite.bankdetail.get- cURL (OAuth)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":357,"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.requisite.bankdetail.get- JS
try
{
const response = await $b24.callMethod(
'crm.requisite.bankdetail.get',
{ id: 357 }
);
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.requisite.bankdetail.get',
[
'id' => 357,
]
);
$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 getting bank detail: ' . $e->getMessage();
}- BX24.js
BX24.callMethod(
"crm.requisite.bankdetail.get",
{ id: 357 },
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.get',
['id' => 357]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';Обработка ответа
HTTP-статус: 200
{
"result": {
"ID": "357",
"ENTITY_ID": "27",
"COUNTRY_ID": "1",
"DATE_CREATE": "2024-06-03T17:52:22+02:00",
"DATE_MODIFY": "",
"CREATED_BY_ID": "1",
"MODIFY_BY_ID": null,
"NAME": "ПАО Супербанк",
"CODE": null,
"XML_ID": "1e4641fd-2dd9-31e6-b2f2-105056c00008",
"ORIGINATOR_ID": null,
"ACTIVE": "Y",
"SORT": "600",
"RQ_BANK_NAME": "ПАО Супербанк",
"RQ_BANK_CODE": null,
"RQ_BANK_ADDR": "117312, г. Москва, улица Вавилова, дом 19",
"RQ_BANK_ROUTE_NUM": null,
"RQ_BIK": "044525225",
"RQ_MFO": null,
"RQ_ACC_NAME": null,
"RQ_ACC_NUM": "40702810938000060473",
"RQ_ACC_TYPE": null,
"RQ_IIK": null,
"RQ_ACC_CURRENCY": "RUR",
"RQ_COR_ACC_NUM": "30101810400000000225",
"RQ_IBAN": null,
"RQ_SWIFT": null,
"RQ_BIC": null,
"RQ_CODEB": null,
"RQ_CODEG": null,
"RQ_RIB": null,
"RQ_AGENCY_NAME": null,
"COMMENTS": null
},
"time": {
"start": 1717495619.077607,
"finish": 1717495619.708617,
"duration": 0.6310100555419922,
"processing": 0.07691788673400879,
"date_start": "2024-06-04T12:06:59+02:00",
"date_finish": "2024-06-04T12:06:59+02:00",
"operating": 0
}
}Возвращаемые данные
Названиетип | Описание |
|---|---|
resultobject | Объект, содержащий значения полей банковского реквизита |
timetime | Информация о времени выполнения запроса |
Описание полей банковского реквизита
Названиетип | Описание |
|---|---|
IDinteger | Идентификатор банковского реквизита. Создается автоматически и уникален в рамках портала |
ENTITY_TYPE_IDinteger | Идентификатор типа родительского объекта. Может быть только Реквизит (значение 8).Идентификаторы типов объектов возвращает метод crm.enum.ownertype |
ENTITY_IDinteger | Идентификатор родительского объекта. Сейчас может быть только идентификатор реквизита. Идентификаторы реквизитов можно получить с помощью метода |
COUNTRY_IDinteger | Идентификатор страны, которой соответствует набор полей банковского реквизита (смотрите метод crm.requisite.preset.countries для получения доступных значений). Код страны банковского реквизита совпадает с кодом страны в привязанном шаблоне реквизитов, идентификатор которого указан в поле |
DATE_CREATEdatetime | Дата создания |
DATE_MODIFYdatetime | Дата изменения |
CREATED_BY_IDuser | Идентификатор пользователя, создавшего реквизит |
MODIFY_BY_IDuser | Идентификатор пользователя, изменившего реквизит |
NAME^^string | Название банковского реквизита |
CODEstring | Символьный код реквизита |
XML_IDstring | Внешний ключ. Используется для операций обмена. Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком. Каждое приложение обеспечивает уникальность значений в этом поле. Рекомендуется использовать уникальный префикс для избежания коллизий с другими приложениями |
ACTIVEchar | Признак активности. Используются значения Y или N.Сейчас поле фактически ни на что не влияет |
SORTinteger | Сортировка |
RQ_BANK_NAMEstring | Наименование банка |
RQ_BANK_ADDRstring | Адрес банка |
RQ_BANK_CODEstring | Código do banco (для страны BR) |
RQ_BANK_ROUTE_NUMstring | Bank Routing Number |
RQ_BIKstring | БИК |
RQ_CODEBstring | Code Banque (для страны FR) |
RQ_CODEGstring | Code Guichet (для страны FR) |
RQ_RIBstring | Clé RIB (для страны FR) |
RQ_MFOstring | МФО |
RQ_ACC_NAMEstring | Bank Account Holder Name |
RQ_ACC_NUMstring | Bank Account Number |
RQ_ACC_TYPEstring | Tipo da conta (для страны BR) |
RQ_AGENCY_NAMEstring | Agência (для страны BR) |
RQ_IIKstring | ИИК |
RQ_ACC_CURRENCYstring | Валюта счета |
RQ_COR_ACC_NUMstring | Корреспондентский счет |
RQ_IBANstring | IBAN |
RQ_SWIFTstring | SWIFT |
RQ_BICstring | BIC |
COMMENTSstring | Комментарий |
ORIGINATOR_IDstring | Идентификатор внешней информационной базы. Назначение поля может меняться конечным разработчиком |
Обработка ошибок
HTTP-статус: 40x, 50x
{
"error": "",
"error_description": "The RequisiteBankDetail with ID '357' is not found"
}Возможные ошибки
| Текст ошибки | Описание** |
|---|---|
ID is not defined or invalid | Идентификатор банковского реквизита не определен или имеет недопустимое значение |
The RequisiteBankDetail with ID '357' is not found | Банковский реквизит с указанным идентификатором не найден |
Access denied | Недостаточно прав доступа для получения банковского реквизита |
- [](./crm-requisite-bank-detail-add)
- [](./crm-requisite-bank-detail-update)
- [](./crm-requisite-bank-detail-list)
- [](./crm-requisite-bank-detail-delete)
- [](./crm-requisite-bank-detail-fields)
💡 Экспертное мнение и рекомендации
Советы эксперта по интеграции:
- Всегда используйте кэширование при частых запросах к crm.requisite.bankdetail.get, чтобы разгрузить базу данных.
- Соблюдайте стандарты PSR при написании обработчиков для «Получить банковский реквизит по id crm.requisite.bankdetail.get».
- Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru