При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Обновить реквизит crm.requisite.update», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.
Обновить реквизит crm.requisite.update
> Scope: crm
>
> Кто может выполнять метод: любой пользователь
Метод обновляет существующий реквизит.
Параметры метода
Названиетип | Описание |
|---|---|
idinteger | Идентификатор реквизита, можно получить методом crm.requisite.list |
fieldsobject | Набор полей реквизита — объект вида "поле": "значение"[, ...]}, значения которых нужно изменить |
Параметр fields
Названиетип | Описание |
|---|---|
NAME*string | Название реквизита |
CODEstring | Символьный код реквизита |
XML_IDstring | Внешний ключ, используется для операций обмена. Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком |
ORIGINATOR_IDstring | Идентификатор внешней информационной базы. Назначение поля может меняться конечным разработчиком |
ACTIVEchar | Признак активности. Используются значения Сейчас поле фактически ни на что не влияет |
ADDRESS_ONLYchar | Признак состояния, когда реквизит используется только для хранения адреса. Используются значения |
SORTinteger | Сортировка. Порядок в списке реквизитов сущности, когда их несколько |
RQ_NAMEstring | ФИО |
RQ_FIRST_NAMEstring | Имя |
RQ_LAST_NAMEstring | Фамилия |
RQ_SECOND_NAMEstring | Отчество |
RQ_COMPANY_IDstring | Идентификатор организации |
RQ_COMPANY_NAMEstring | Сокращенное наименование организации |
RQ_COMPANY_FULL_NAMEstring | Полное наименование организации |
RQ_COMPANY_REG_DATEstring | Дата государственной регистрации |
RQ_DIRECTORstring | Генеральный директор |
RQ_ACCOUNTANTstring | Главный бухгалтер |
RQ_CEO_NAMEstring | ФИО первого руководителя |
RQ_CEO_WORK_POSstring | Должность первого руководителя |
RQ_CONTACTstring | Контактное лицо |
RQ_EMAILstring | |
RQ_PHONEstring | Телефон |
RQ_FAXstring | Факс |
RQ_IDENT_TYPEcrm_status | Способ идентификации |
RQ_IDENT_DOCstring | Вид документа |
RQ_IDENT_DOC_SERstring | Серия |
RQ_IDENT_DOC_NUMstring | Номер |
RQ_IDENT_DOC_PERS_NUMstring | Личный номер |
RQ_IDENT_DOC_DATEstring | Дата выдачи |
RQ_IDENT_DOC_ISSUED_BYstring | Кем выдан |
RQ_IDENT_DOC_DEP_CODEstring | Код подразделения |
RQ_INNstring | ИНН |
RQ_KPPstring | КПП |
RQ_USRLEstring | Handelsregisternummer (для страны DE) |
RQ_IFNSstring | ИФНС |
RQ_OGRNstring | ОГРН |
RQ_OGRNIPstring | ОГРНИП |
RQ_OKPOstring | ОКПО |
RQ_OKTMOstring | ОКТМО |
RQ_OKVEDstring | ОКВЭД |
RQ_EDRPOUstring | ЄДРПОУ |
RQ_DRFOstring | ДРФО |
RQ_KBEstring | КБЕ |
RQ_IINstring | ИИН |
RQ_BINstring | БИН |
RQ_ST_CERT_SERstring | Серия свидетельства о государственной регистрации |
RQ_ST_CERT_NUMstring | Номер свидетельства о государственной регистрации |
RQ_ST_CERT_DATEstring | Дата свидетельство о государственной регистрации |
RQ_VAT_PAYERchar | Платник ПДВ (для страны UA). Используются значения |
RQ_VAT_IDstring | VAT ID (идентификационный номер (плательщика) НДС) |
RQ_VAT_CERT_SERstring | Серия свидетельства по НДС |
RQ_VAT_CERT_NUMstring | Номер свидетельства по НДС |
RQ_VAT_CERT_DATEstring | Дата свидетельства по НДС |
RQ_RESIDENCE_COUNTRYstring | Страна резидента |
RQ_BASE_DOCstring | Основание действия |
RQ_REGONstring | REGON (для страны PL) |
RQ_KRSstring | KRS (для страны PL) |
RQ_PESELstring | PESEL (для страны PL) |
RQ_LEGAL_FORMstring | Forme juridique (для страны FR) |
RQ_SIRETstring | Numéro Siret (для страны FR) |
RQ_SIRENstring | Numéro Siren (для страны FR) |
RQ_CAPITALstring | Capital social (для страны FR) |
RQ_RCSstring | RCS (для страны FR) |
RQ_CNPJstring | CNPJ (для страны BR) |
RQ_STATE_REGstring | Inscrição Estadual (IE) (для страны BR) |
RQ_MNPL_REGstring | Inscrição Municipal (IM) (для страны BR) |
RQ_CPFstring | CPF (для страны BR) |
| UF_CRM_… | Пользовательские поля. Например, UF_CRM_1694526604.У реквизитов может быть набор пользовательских полей с типами: Добавить пользовательское поле реквизитов можно методом crm.requisite.userfield.add |
Примеры кода
- cURL (Webhook)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":27,"fields":{"RQ_OKPO":"80715150","RQ_OKTMO":"45381000000","UF_CRM_1707997209":"78","UF_CRM_1708012333":"Категория 3"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/crm.requisite.update- cURL (OAuth)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":27,"fields":{"RQ_OKPO":"80715150","RQ_OKTMO":"45381000000","UF_CRM_1707997209":"78","UF_CRM_1708012333":"Категория 3"},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.requisite.update- JS
try
{
const response = await $b24.callMethod(
"crm.requisite.update",
{
id: 27,
fields:
{
"RQ_OKPO": "80715150",
"RQ_OKTMO": "45381000000",
"UF_CRM_1707997209": "78",
"UF_CRM_1708012333": "Категория 3"
}
}
);
const result = response.getData().result;
console.info(result);
}
catch( error )
{
console.error(error);
}- PHP
try {
$response = $b24Service
->core
->call(
'crm.requisite.update',
[
'id' => 27,
'fields' => [
'RQ_OKPO' => '80715150',
'RQ_OKTMO' => '45381000000',
'UF_CRM_1707997209' => '78',
'UF_CRM_1708012333' => 'Категория 3',
],
]
);
$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 updating requisite: ' . $e->getMessage();
}- BX24.js
BX24.callMethod(
"crm.requisite.update",
{
id: 27,
fields:
{
"RQ_OKPO": "80715150",
"RQ_OKTMO": "45381000000",
"UF_CRM_1707997209": "78",
"UF_CRM_1708012333": "Категория 3"
}
},
function(result)
{
if(result.error())
console.error(result.error());
else
{
console.info(result.data());
}
}
);- PHP CRest
require_once('crest.php');
$result = CRest::call(
'crm.requisite.update',
[
'id' => 27,
'fields' => [
'RQ_OKPO' => '80715150',
'RQ_OKTMO' => '45381000000',
'UF_CRM_1707997209' => '78',
'UF_CRM_1708012333' => 'Категория 3'
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';Ответ в случае успеха
HTTP-статус: 200
{
"result": true,
"time": {
"start": 1717163055.335685,
"finish": 1717163055.892722,
"duration": 0.5570368766784668,
"processing": 0.17116189002990723,
"date_start": "2024-05-31T15:44:15+02:00",
"date_finish": "2024-05-31T15:44:15+02:00",
"operating": 0.17112517356872559
}
}Возвращаемые данные
Названиетип | Описание |
|---|---|
resultboolean | Вовзращает значение: — |
timetime | Информация о времени выполнения запроса |
Ответ в случае ошибки
HTTP-статус: 400
{
"error": "",
"error_description": "The Requisite with ID '57' is not found"
}Возможные ошибки
| Код | Текст ошибки | Описание |
|---|---|---|
| Пустая строка | The Requisite with ID ’57’ is not found | Реквизит с указанным идентификатором не найден |
| Пустая строка | ID is not defined or invalid. | Идентификатор реквизита не указан или имеет неопустимое значение |
| Пустая строка | ENTITY_TYPE_ID is not defined or invalid. | Идентификатор типа родительской сущности не указан или имеет недопустимое значение |
| Пустая строка | ENTITY_ID is not defined or invalid. | Идентификатор родительской сущности не указан или имеет недопустимое значение |
| Пустая строка | PRESET_ID is not defined or invalid. | Идентификатор шаблона реквизитов не указан или имеет недопустимое значение |
| Пустая строка | Access denied. | Недостаточно прав доступа для изменения реквизита |
- [](./index)
- [](./crm-requisite-add)
- [](./crm-requisite-get)
- [](./crm-requisite-list)
- [](./crm-requisite-delete)
- [](./crm-requisite-fields)
💡 Экспертное мнение и рекомендации
Советы эксперта по интеграции:
- Всегда используйте кэширование при частых запросах к crm.requisite.update, чтобы разгрузить базу данных.
- Соблюдайте стандарты PSR при написании обработчиков для «Обновить реквизит crm.requisite.update».
- Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru