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

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

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.