#Обновить реквизит

PATCH /v1/requisites/:id

Обновляет поля существующего реквизита. Передавайте только те поля, которые нужно изменить. Полный список — `GET /v1/requisites/fields`.

#Часто обновляемые поля

Параметр Тип Описание
name string Название реквизита в интерфейсе Битрикс24
active boolean Активен ли реквизит
sort number Порядок сортировки
rqName string Полное наименование
rqInn string ИНН
rqKpp string КПП
rqOgrn string ОГРН
rqCompanyName string Сокращённое название юрлица
rqDirector string ФИО директора
rqAccountant string ФИО главного бухгалтера
rqVatPayer boolean Плательщик НДС

Все поля в camelCase. Международные поля (RQ_EDRPOU, RQ_KBE, RQ_REGON, RQ_SIRET, RQ_CNPJ) передаются в UPPER_SNAKE_CASE — они не включены в Вайбкод-схему.

#Параметры

Параметр Тип Обяз. Описание
id (path) number да ID реквизита

#Примеры

#curl — личный ключ

Terminal 
curl -X PATCH "https://vibecode.bitrix24.tech/v1/requisites/42" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rqInn": "7701234567",
    "rqKpp": "770101001",
    "rqDirector": "Иванов Иван Иванович"
  }'

#curl — OAuth-приложение

Terminal 
curl -X PATCH "https://vibecode.bitrix24.tech/v1/requisites/42" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "rqInn": "7701234567",
    "rqKpp": "770101001"
  }'

#JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/requisites/42', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    rqInn: '7701234567',
    rqKpp: '770101001',
    rqDirector: 'Иванов Иван Иванович',
  }),
})

const { success, data } = await res.json()

#JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/requisites/42', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    rqInn: '7701234567',
    rqKpp: '770101001',
  }),
})

const { success, data } = await res.json()

#Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data object Обновлённый реквизит с актуальными значениями полей
data.id number Идентификатор реквизита
data.updatedAt datetime Новая дата изменения
data.modifyBy number ID пользователя, выполнившего обновление

Объект содержит все поля пресета в camelCase — включая неизменённые. Незаполненные поля — null. Полный список — Поля реквизита.

#Пример ответа

JSON 
{
  "success": true,
  "data": {
    "id": 42,
    "entityTypeId": 4,
    "entityId": 15,
    "presetId": 1,
    "name": "Основной реквизит",
    "active": true,
    "sort": 500,
    "rqName": "ООО «Ромашка»",
    "rqInn": "7701234567",
    "rqKpp": "770101001",
    "rqOgrn": "1027700123456",
    "rqDirector": "Иванов Иван Иванович",
    "updatedAt": "2026-04-19T15:00:00+03:00",
    "modifyBy": 1
  }
}

#Пример ответа при ошибке

404 — реквизит не найден:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "The Requisite with ID '999999999' is not found"
  }
}

#Ошибки

HTTP Код Описание
404 ENTITY_NOT_FOUND Реквизит с таким ID не найден
403 ACCESS_DENIED Нет доступа к родительской сущности
400 INVALID_REQUEST Невалидные поля
403 SCOPE_DENIED API-ключ не имеет скоупа crm
401 TOKEN_MISSING API-ключ не имеет настроенных токенов

Полный список общих ошибок API — Ошибки.

#Известные особенности

Сменить пресет нельзя. Поле presetId задаётся при создании и его нельзя изменить обновлением. Если нужен другой пресет — создайте новый реквизит и удалите старый.

Перенос между сущностями невозможен. entityTypeId и entityId также неизменяемы: реквизит привязан к конкретному контакту или компании на всю жизнь.

Поля вне пресета игнорируются. Битрикс24 молча отбрасывает значения полей, которых нет в пресете реквизита. Ошибка не возникает, но и данные не сохраняются. Проверить результат — GET /v1/requisites/:id.

Пустое значение очищает поле. Чтобы очистить поле, передайте пустую строку "". В ответах Вайбкод приводит очищенные строки к null для консистентности.

#Смотрите также