crm.requisite.add
Добавить реквизит
Описание
Метод добавляет новый реквизит.
Параметры
ENTITY_TYPE_ID
integer
обязательный
Идентификатор типа родительской сущности.
Сейчас это может быть только:
- 3 — контакт
- 4 — компания
Идентификаторы всех типов сущностей CRM отдает метод crm.enum.ownertype
ENTITY_ID
integer
обязательный
Идентификатор родительской сущности (контакта либо компании).
Идентификатор можно получить методом crm.company.list для компании и методом crm.contact.list для контакта
PRESET_ID
integer
обязательный
Идентификатор шаблона реквизитов.
Идентификаторы шаблонов можно получить методом crm.requisite.preset.list
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 '{"fields":{"ENTITY_TYPE_ID":4,"ENTITY_ID":1,"PRESET_ID":1,"NAME":"Организация","ACTIVE":"Y","ADDRESS_ONLY":"N","SORT":500,"RQ_COMPANY_NAME":"ООО \"1С-БИТРИКС\"","RQ_COMPANY_FULL_NAME":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"1С-БИТРИКС\"","RQ_COMPANY_REG_DATE":"06.04.2007","RQ_DIRECTOR":"РЫЖИКОВ СЕРГЕЙ ВЛАДИМИРОВИЧ","RQ_INN":"7717586110","RQ_KPP":"770501001","RQ_OGRN":"5077746476209","UF_CRM_1707997209":"56","UF_CRM_1708012333":"Категория 1","XML_ID":"5e4641fd-1dd9-11e6-b2f2-005056c00008"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.requisite.add
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"ENTITY_TYPE_ID":4,"ENTITY_ID":1,"PRESET_ID":1,"NAME":"Организация","ACTIVE":"Y","ADDRESS_ONLY":"N","SORT":500,"RQ_COMPANY_NAME":"ООО \"1С-БИТРИКС\"","RQ_COMPANY_FULL_NAME":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"1С-БИТРИКС\"","RQ_COMPANY_REG_DATE":"06.04.2007","RQ_DIRECTOR":"РЫЖИКОВ СЕРГЕЙ ВЛАДИМИРОВИЧ","RQ_INN":"7717586110","RQ_KPP":"770501001","RQ_OGRN":"5077746476209","UF_CRM_1707997209":"56","UF_CRM_1708012333":"Категория 1","XML_ID":"5e4641fd-1dd9-11e6-b2f2-005056c00008","auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.requisite.add
// 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<number>({
method: 'crm.requisite.add',
params: {
fields: {
ENTITY_TYPE_ID: 4,
ENTITY_ID: 1,
PRESET_ID: 1,
NAME: 'Organization',
ACTIVE: 'Y',
ADDRESS_ONLY: 'N',
SORT: 500,
RQ_COMPANY_NAME: 'LLC "1C-BITRIX"',
RQ_COMPANY_FULL_NAME: 'LIMITED LIABILITY COMPANY "1C-BITRIX"',
RQ_COMPANY_REG_DATE: '06.04.2007',
RQ_DIRECTOR: 'RYZHIKOV SERGEY VLADIMIROVICH',
RQ_INN: '7717586110',
RQ_KPP: '770501001',
RQ_OGRN: '5077746476209',
UF_CRM_1707997209: '56',
UF_CRM_1708012333: 'Category 1',
XML_ID: '5e4641fd-1dd9-11e6-b2f2-005056c00008',
},
},
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('Created requisite with ID:', 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 addRequisite() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'crm.requisite.add',
params: {
fields: {
ENTITY_TYPE_ID: 4,
ENTITY_ID: 1,
PRESET_ID: 1,
NAME: 'Organization',
ACTIVE: 'Y',
ADDRESS_ONLY: 'N',
SORT: 500,
RQ_COMPANY_NAME: 'LLC "1C-BITRIX"',
RQ_COMPANY_FULL_NAME: 'LIMITED LIABILITY COMPANY "1C-BITRIX"',
RQ_COMPANY_REG_DATE: '06.04.2007',
RQ_DIRECTOR: 'RYZHIKOV SERGEY VLADIMIROVICH',
RQ_INN: '7717586110',
RQ_KPP: '770501001',
RQ_OGRN: '5077746476209',
UF_CRM_1707997209: '56',
UF_CRM_1708012333: 'Category 1',
XML_ID: '5e4641fd-1dd9-11e6-b2f2-005056c00008',
},
},
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('Created requisite with ID:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', addRequisite)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.crm.requisite.add(
fields={
"ENTITY_TYPE_ID": 4,
"ENTITY_ID": 1,
"PRESET_ID": 1,
"NAME": "Организация",
"ACTIVE": "Y",
"ADDRESS_ONLY": "N",
"SORT": 500,
"RQ_COMPANY_NAME": 'ООО "1С-БИТРИКС"',
"RQ_COMPANY_FULL_NAME": 'ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "1С-БИТРИКС"',
"RQ_COMPANY_REG_DATE": "06.04.2007",
"RQ_DIRECTOR": "РЫЖИКОВ СЕРГЕЙ ВЛАДИМИРОВИЧ",
"RQ_INN": "7717586110",
"RQ_KPP": "770501001",
"RQ_OGRN": "5077746476209",
"UF_CRM_1707997209": "56",
"UF_CRM_1708012333": "Категория 1",
"XML_ID": "5e4641fd-1dd9-11e6-b2f2-005056c00008",
},
).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.add',
[
'fields' => [
'ENTITY_TYPE_ID' => 4,
'ENTITY_ID' => 1,
'PRESET_ID' => 1,
'NAME' => 'Организация',
'ACTIVE' => 'Y',
'ADDRESS_ONLY' => 'N',
'SORT' => 500,
'RQ_COMPANY_NAME' => 'ООО "1С-БИТРИКС"',
'RQ_COMPANY_FULL_NAME' => 'ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "1С-БИТРИКС"',
'RQ_COMPANY_REG_DATE' => '06.04.2007',
'RQ_DIRECTOR' => 'РЫЖИКОВ СЕРГЕЙ ВЛАДИМИРОВИЧ',
'RQ_INN' => '7717586110',
'RQ_KPP' => '770501001',
'RQ_OGRN' => '5077746476209',
'UF_CRM_1707997209' => '56',
'UF_CRM_1708012333' => 'Категория 1',
'XML_ID' => '5e4641fd-1dd9-11e6-b2f2-005056c00008',
],
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Создан реквизит с ID ' . $result;
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error creating requisite: ' . $e->getMessage();
}
BX24.callMethod(
"crm.requisite.add",
{
fields:
{
"ENTITY_TYPE_ID": 4,
"ENTITY_ID": 1,
"PRESET_ID": 1,
"NAME": "Организация",
"ACTIVE": "Y",
"ADDRESS_ONLY": "N",
"SORT": 500,
"RQ_COMPANY_NAME": 'ООО "1С-БИТРИКС"',
"RQ_COMPANY_FULL_NAME": 'ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "1С-БИТРИКС"',
"RQ_COMPANY_REG_DATE": "06.04.2007",
"RQ_DIRECTOR": "РЫЖИКОВ СЕРГЕЙ ВЛАДИМИРОВИЧ",
"RQ_INN": "7717586110",
"RQ_KPP": "770501001",
"RQ_OGRN": "5077746476209",
"UF_CRM_1707997209": "56",
"UF_CRM_1708012333": "Категория 1",
"XML_ID": "5e4641fd-1dd9-11e6-b2f2-005056c00008"
}
},
function(result)
{
if(result.error())
console.error(result.error());
else
console.info("Создан реквизит с ID " + result.data());
}
);
require_once('crest.php');
$result = CRest::call(
'crm.requisite.add',
[
'fields' => [
"ENTITY_TYPE_ID" => 4,
"ENTITY_ID" => 1,
"PRESET_ID" => 1,
"NAME" => "Организация",
"ACTIVE" => "Y",
"ADDRESS_ONLY" => "N",
"SORT" => 500,
"RQ_COMPANY_NAME" => "ООО \"1С-БИТРИКС\"",
"RQ_COMPANY_FULL_NAME" => "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"1С-БИТРИКС\"",
"RQ_COMPANY_REG_DATE" => "06.04.2007",
"RQ_DIRECTOR" => "РЫЖИКОВ СЕРГЕЙ ВЛАДИМИРОВИЧ",
"RQ_INN" => "7717586110",
"RQ_KPP" => "770501001",
"RQ_OGRN" => "5077746476209",
"UF_CRM_1707997209" => "56",
"UF_CRM_1708012333" => "Категория 1",
"XML_ID" => "5e4641fd-1dd9-11e6-b2f2-005056c00008"
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "crm.requisite.add", b24.Params{
"fields": b24.Params{
"ENTITY_TYPE_ID": 4,
"ENTITY_ID": 1,
"PRESET_ID": 1,
"NAME": "Организация",
"ACTIVE": "Y",
"ADDRESS_ONLY": "N",
"SORT": 500,
"RQ_COMPANY_NAME": "ООО \"1С-БИТРИКС\"",
"RQ_COMPANY_FULL_NAME": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"1С-БИТРИКС\"",
"RQ_COMPANY_REG_DATE": "06.04.2007",
"RQ_DIRECTOR": "РЫЖИКОВ СЕРГЕЙ ВЛАДИМИРОВИЧ",
"RQ_INN": "7717586110",
"RQ_KPP": "770501001",
"RQ_OGRN": "5077746476209",
"UF_CRM_1707997209": "56",
"UF_CRM_1708012333": "Категория 1",
"XML_ID": "5e4641fd-1dd9-11e6-b2f2-005056c00008",
},
})
if err != nil {
return fmt.Errorf("crm.requisite.add: %w", err)
}
var newID b24.ID
if err := json.Unmarshal(res.Result, &newID); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("идентификатор:", newID)
Ответ
HTTP-статус: 200
{
"result": 27,
"time": {
"start": 1716998748.040801,
"finish": 1716998749.444508,
"duration": 1.4037070274353027,
"processing": 0.32904696464538574,
"date_start": "2024-05-29T18:05:48+02:00",
"date_finish": "2024-05-29T18:05:49+02:00",
"operating": 0.32897305488586426
}
}
Возвращаемые данные
result
integer
Идентификатор созданного реквизита
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "",
"error_description": "ENTITY_TYPE_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. | Идентификатор шаблона реквизитов не определён или имеет недопустимое значение |
Пустая строка |
Entity not found. | Не найдена сущность, для которой создаётся реквизит |
Пустая строка |
Access denied. | Недостаточно прав доступа для добавления реквизита |

