crm.requisite.update
Обновить реквизит
Описание
Метод обновляет существующий реквизит.
Параметры
NAME
string
обязательный
Название реквизита
CODE
string
необязательный
Символьный код реквизита
XML_ID
string
необязательный
Внешний ключ, используется для операций обмена.
Идентификатор объекта внешней информационной базы.
Назначение поля может меняться конечным разработчиком
ORIGINATOR_ID
string
необязательный
Идентификатор внешней информационной базы.
Назначение поля может меняться конечным разработчиком
ACTIVE
char
необязательный
Признак активности.
Используются значения Y или N.
Сейчас поле фактически ни на что не влияет
ADDRESS_ONLY
char
необязательный
Признак состояния, когда реквизит используется только для хранения адреса.
Используются значения Y или N. При значении Y реквизиты не показываются в карточке сущности, но отображается адрес
SORT
integer
необязательный
Сортировка.
Порядок в списке реквизитов сущности, когда их несколько
RQ_NAME
string
необязательный
ФИО
RQ_FIRST_NAME
string
необязательный
Имя
RQ_LAST_NAME
string
необязательный
Фамилия
RQ_SECOND_NAME
string
необязательный
Отчество
RQ_COMPANY_ID
string
необязательный
Идентификатор организации
RQ_COMPANY_NAME
string
необязательный
Сокращенное наименование организации
RQ_COMPANY_FULL_NAME
string
необязательный
Полное наименование организации
RQ_COMPANY_REG_DATE
string
необязательный
Дата государственной регистрации
RQ_DIRECTOR
string
необязательный
Генеральный директор
RQ_ACCOUNTANT
string
необязательный
Главный бухгалтер
RQ_CEO_NAME
string
необязательный
ФИО первого руководителя
RQ_CEO_WORK_POS
string
необязательный
Должность первого руководителя
RQ_CONTACT
string
необязательный
Контактное лицо
RQ_EMAIL
string
необязательный
RQ_PHONE
string
необязательный
Телефон
RQ_FAX
string
необязательный
Факс
RQ_IDENT_TYPE
crm_status
необязательный
Способ идентификации
RQ_IDENT_DOC
string
необязательный
Вид документа
RQ_IDENT_DOC_SER
string
необязательный
Серия
RQ_IDENT_DOC_NUM
string
необязательный
Номер
RQ_IDENT_DOC_PERS_NUM
string
необязательный
Личный номер
RQ_IDENT_DOC_DATE
string
необязательный
Дата выдачи
RQ_IDENT_DOC_ISSUED_BY
string
необязательный
Кем выдан
RQ_IDENT_DOC_DEP_CODE
string
необязательный
Код подразделения
RQ_INN
string
необязательный
ИНН
RQ_KPP
string
необязательный
КПП
RQ_USRLE
string
необязательный
Handelsregisternummer (для страны DE)
RQ_IFNS
string
необязательный
ИФНС
RQ_OGRN
string
необязательный
ОГРН
RQ_OGRNIP
string
необязательный
ОГРНИП
RQ_OKPO
string
необязательный
ОКПО
RQ_OKTMO
string
необязательный
ОКТМО
RQ_OKVED
string
необязательный
ОКВЭД
RQ_EDRPOU
string
необязательный
ЄДРПОУ
RQ_DRFO
string
необязательный
ДРФО
RQ_KBE
string
необязательный
КБЕ
RQ_IIN
string
необязательный
ИИН
RQ_BIN
string
необязательный
БИН
RQ_ST_CERT_SER
string
необязательный
Серия свидетельства о государственной регистрации
RQ_ST_CERT_NUM
string
необязательный
Номер свидетельства о государственной регистрации
RQ_ST_CERT_DATE
string
необязательный
Дата свидетельство о государственной регистрации
RQ_VAT_PAYER
char
необязательный
Платник ПДВ (для страны UA).
Используются значения Y или N
RQ_VAT_ID
string
необязательный
VAT ID (идентификационный номер (плательщика) НДС)
RQ_VAT_CERT_SER
string
необязательный
Серия свидетельства по НДС
RQ_VAT_CERT_NUM
string
необязательный
Номер свидетельства по НДС
RQ_VAT_CERT_DATE
string
необязательный
Дата свидетельства по НДС
RQ_RESIDENCE_COUNTRY
string
необязательный
Страна резидента
RQ_BASE_DOC
string
необязательный
Основание действия
RQ_REGON
string
необязательный
REGON (для страны PL)
RQ_KRS
string
необязательный
KRS (для страны PL)
RQ_PESEL
string
необязательный
PESEL (для страны PL)
RQ_LEGAL_FORM
string
необязательный
Forme juridique (для страны FR)
RQ_SIRET
string
необязательный
Numéro Siret (для страны FR)
RQ_SIREN
string
необязательный
Numéro Siren (для страны FR)
RQ_CAPITAL
string
необязательный
Capital social (для страны FR)
RQ_RCS
string
необязательный
RCS (для страны FR)
RQ_CNPJ
string
необязательный
CNPJ (для страны BR)
RQ_STATE_REG
string
необязательный
Inscrição Estadual (IE) (для страны BR)
RQ_MNPL_REG
string
необязательный
Inscrição Municipal (IM) (для страны BR)
RQ_CPF
string
необязательный
CPF (для страны BR)
UF_CRM_...
необязательный
Пользовательские поля. Например, UF_CRM_1694526604.
У реквизитов может быть набор пользовательских полей с типами: string, boolean, double, datetime.
Добавить пользовательское поле реквизитов можно методом crm.requisite.userfield.add
Примеры запроса
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_webhook_here**/crm.requisite.update
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
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
try {
const response = await $b24.actions.v2.call.make<boolean>({
method: 'crm.requisite.update',
params: {
id: 27,
fields: {
RQ_OKPO: '80715150',
RQ_OKTMO: '45381000000',
UF_CRM_1707997209: '78',
UF_CRM_1708012333: 'Category 3',
},
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info('Requisite updated:', result)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function updateRequisite() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'crm.requisite.update',
params: {
id: 27,
fields: {
RQ_OKPO: '80715150',
RQ_OKTMO: '45381000000',
UF_CRM_1707997209: '78',
UF_CRM_1708012333: 'Category 3',
},
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info('Requisite updated:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', updateRequisite)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.crm.requisite.update(
bitrix_id=27,
fields={
"RQ_OKPO": "80715150",
"RQ_OKTMO": "45381000000",
"UF_CRM_1707997209": "78",
"UF_CRM_1708012333": "Категория 3",
},
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
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.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());
}
}
);
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>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "crm.requisite.update", b24.Params{
"id": 27,
"fields": b24.Params{
"RQ_OKPO": "80715150",
"RQ_OKTMO": "45381000000",
"UF_CRM_1707997209": "78",
"UF_CRM_1708012333": "Категория 3",
},
})
if err != nil {
return fmt.Errorf("crm.requisite.update: %w", err)
}
var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)
Ответ
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
}
}
Возвращаемые данные
result
boolean
Вовзращает значение:
true— реквизит измененfalse— реквизит не изменен
time
time
Информация о времени выполнения запроса
Обработка ошибок
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. | Недостаточно прав доступа для изменения реквизита |

