метод REST scope: crm

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 необязательный

E-Mail

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

Ответ

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. Недостаточно прав доступа для изменения реквизита

Что будем искать? Например,Продвижение