# Изменения API: 6 ноября 2026

[← Журнал изменений](/docs/changelog) · [Ноябрь 2026](/docs/changelog/2026-11)

### BC-1106-1: CRM-формы сохраняют структуру и правила Битрикс24

> Поддержка старого формата до: не предусмотрена

**Было**

[Список форм](/docs/entities/crm-forms/list) по умолчанию показывал только активные формы и сокращённый набор полей. [Чтение формы](/docs/entities/crm-forms/get) пересобирало поля и соглашения, добавляло свойства `title`, `result`, `agreementsSettings` и варианты значений полей. [Поля контракта формы](/docs/entities/crm-forms/fields) не перечисляли описания `analytics`, `integrations` и `spamProtection`, а [чтение поля контракта](/docs/entities/crm-forms/field) по этим именам отвечало `400 INVALID_PARAMS`. Фильтр `isCallback` отбирал записи после получения страницы. Ошибка дополнительного чтения после записи выглядела как ошибка самой записи. [Виджеты сайта](/docs/entities/crm-forms/site-buttons) и [открытые линии](/docs/entities/crm-forms/openlines) отвечали `UNKNOWN_FILTER_FIELD` на неизвестный параметр строки запроса, отдавали сокращённый набор свойств элемента, применяли размер страницы 50 со смещением 0 и всегда возвращали `meta` с `limit` и `offset`. [Коды встраивания](/docs/entities/crm-forms/embedding) пересобирались в отдельную структуру.

**Стало**

Список включает активные и неактивные формы, по умолчанию возвращает 11 базовых свойств. `select` выбирает секции и подпути, доступны фильтр по `id` и сортировка. В `GET /v1/crm-forms` параметры строки запроса, кроме управляющих, передаются условиями фильтра Битрикс24: прежнего локального отказа на неизвестное имя нет, допустимость решает портал. `GET /v1/crm-forms/{id}` принимает необязательный `select`. У списка форм, виджетов сайта и открытых линий сняты собственные умолчания `limit=50`, `offset=0` и граница `limit` 1–1000: значения проверяет портал. Без `limit` и `offset` пагинация не передаётся. Поля пагинации `meta.limit`, `meta.offset`, `meta.total` больше не гарантируются: они возвращаются только из пагинации портала, а объект `meta` может отсутствовать. Форма возвращается в структуре Битрикс24 без пересборки полей и соглашений и без добавленных свойств. Поля контракта формы перечисляют все свойства, включая `analytics`, `integrations` и `spamProtection`, чтение поля контракта по этим именам возвращает описание, и оба пути принимают необязательный `select`. Дополнительного получения вариантов значений нет, фильтрация по `isCallback` после выборки тоже убрана. Обычное содержимое сохраняется, точные учётные данные текущего подключения заменяются с путями в `meta.redacted`.

[Создание](/docs/entities/crm-forms/create) и [изменение](/docs/entities/crm-forms/update) принимают плоское тело либо объект `fields`. В `PATCH /v1/crm-forms/{id}` собственные списки разрешённых и только читаемых свойств сняты: `active` и другие переданные свойства проверяет портал. Успешная запись со сбоем перечитывания сохраняет успешный статус и `data.id`, добавляя `meta.warnings`. `CRM_FORM_PARTIALLY_CREATED` остаётся ошибкой с `error.id`, `b24Code` и ошибками полей. Ошибки Битрикс24 содержат `b24Code`, недостаточный скоуп токена отличается кодом `BITRIX_INSUFFICIENT_SCOPE`. Только отсутствие метода даёт `409 CRM_FORM_REST_NOT_ENABLED`. Локальные отказы формы запроса в описанных методах `crm.form.*` отвечают кодом `INVALID_PARAMS`: коды `UNKNOWN_FILTER_FIELD`, `UNKNOWN_FIELD`, `READONLY_FIELD`, `INVALID_FILTER_OPERATOR` и `INVALID_FILTER_SHAPE` здесь больше не возвращаются, а отсутствие `updatedTime` при изменении формы или встройки даёт `INVALID_PARAMS` вместо `MISSING_REQUIRED_FIELDS`. Отказ `MISSING_REQUIRED_FIELDS` при отсутствии `entityName` и контракт `POST /v1/crm-forms/{id}/results` не меняются. Встройка поддерживает `link` и `code: null`, удаление — `confirmed` наряду с `confirm`. На путях [виджетов сайта](/docs/entities/crm-forms/site-buttons) и [открытых линий](/docs/entities/crm-forms/openlines) неизвестный параметр строки запроса даёт `INVALID_PARAMS` вместо `UNKNOWN_FILTER_FIELD`, элементы возвращаются в структуре Битрикс24, появились `order` и `sort`, а без `limit` и `offset` пагинация не передаётся и `meta` содержит только то, что вернул Битрикс24. [Коды встраивания](/docs/entities/crm-forms/embedding) тоже возвращаются в структуре Битрикс24. В `GET /v1/crm-forms/{id}/embedding` значения `variant` и `delay` больше не проверяются локально, а `delay` передаётся как значение строки запроса. В `PATCH /v1/crm-forms/{id}/embedding` снят собственный список настроек тела: разрешённость свойств решает портал. Прежний локальный отказ на этих входах больше не гарантируется; Битрикс24 может принять их или вернуть свой отказ. Проверки формы запроса сохраняются. В `PATCH /v1/crm-forms/{id}` и `PATCH /v1/crm-forms/{id}/embedding` наличие `updatedTime` по-прежнему обязательно, но тип значения больше не проверяется локально. В этих двух путях, а также в `POST /v1/crm-forms/{id}/activate`, `POST /v1/crm-forms/{id}/deactivate` и `DELETE /v1/crm-forms/{id}` с необязательным `updatedTime` вместо гарантированного `400 INVALID_PARAMS` на нестроковое значение запрос принимает или отклоняет Битрикс24. В `POST /v1/crm-forms` отсутствие тела больше не вызывает локальный отказ: портал получает пустой `fields` и проверяет его сам.

**Что делать интеграторам**

Для прежнего отбора активных форм передавайте `active=true`. Используйте исходные секции формы вместо добавленных `title`, `result`, `agreementsSettings` и искусственных свойств полей. Целевые сущности и ответственных запрашивайте через `select=crm.entityScheme,responsible.userIds`, варианты CRM-полей — через справочник полей сущностей. После предупреждения о перечитывании выполните `GET` до следующего изменения. Ветвление по кодам `UNKNOWN_FILTER_FIELD`, `UNKNOWN_FIELD`, `READONLY_FIELD`, `INVALID_FILTER_OPERATOR`, `INVALID_FILTER_SHAPE` на описанных путях `crm.form.*` замените веткой `INVALID_PARAMS`; так же обработайте отсутствие `updatedTime` при изменении формы или встройки. При изменении формы или встройки продолжайте передавать `updatedTime`, а при нестроковом значении учитывайте ответ Битрикс24 вместо ожидания прежнего локального `400 INVALID_PARAMS`. Для активации, деактивации, удаления и создания без тела тоже учитывайте ответ Битрикс24 вместо ожидания прежнего локального отказа. Уточнения читайте в `error.message`, `error.b24Code` и `error.validation`. У списка форм неизвестный параметр больше не вызывает локальный `UNKNOWN_FILTER_FIELD`: он становится условием фильтра, которое Битрикс24 принимает либо отклоняет. Не рассчитывайте на обязательный локальный отказ. Для списка форм также передавайте `limit` и `offset` явно, если нужна прежняя страница из 50 записей, и проверяйте наличие `meta` и её полей перед чтением. Для встройки учитывайте ответ портала и `error.b24Code` вместо ожидания прежнего локального отказа на значения `variant`, `delay` или состав настроек. При `CRM_FORM_PARTIALLY_CREATED` перечитайте форму по `error.id`, исправьте или удалите её, создание не повторяйте. Не сохраняйте замаскированную конфигурацию обратно без восстановления изменённых значений. На путях виджетов сайта и открытых линий тоже замените ветку `UNKNOWN_FILTER_FIELD` веткой `INVALID_PARAMS`, передавайте `limit` и `offset` явно, если нужен прежний размер страницы, и читайте свойства элементов и кодов встраивания из ответа Битрикс24.

### NEW-1106-2: Настройки тредов и признаки чата

[PATCH /v1/chats/{chatId}?format=v2](/docs/chats/management/rename) принимает `threadsEnabled` как boolean и `manageThreadCreate`, `manageThreadPost` со значениями `MEMBER`, `MANAGER` или `OWNER`. `GET /v1/chats/configuration` возвращает доступные признаки настроек чата; отсутствующий признак означает неизвестное значение.

### FIX-1106-3: создание приложения: отказ Битрикс24 при непрочитанной подписке возвращает понятный код

**Было**

`POST /v1/apps` отвечал `502 CONNECTOR_REST_UNAVAILABLE`, когда Битрикс24 отказал в выписке ключа, а подписку аккаунта прочитать не удалось.

**Стало**

Тот же случай возвращает `403 PORTAL_SUBSCRIPTION_UNREADABLE`, и в `error.details.remedy` указано, как повторить проверку. Это не отказ `B24_MARKET_SUBSCRIPTION_REQUIRED`: покупку ответ не предлагает. Если подписка прочитана и действует, ответ остаётся `502 CONNECTOR_REST_UNAVAILABLE`.

### FIX-1106-4: создание приложения: отказ Битрикс24 при непрочитанном тарифе возвращает понятный код

**Было**

`POST /v1/apps` отвечал `502 CONNECTOR_REST_UNAVAILABLE`, когда Битрикс24 отказал в выписке ключа, а тариф аккаунта прочитать не удалось.

**Стало**

Тот же случай возвращает `403 PORTAL_TARIFF_UNREADABLE`, и в `error.details.remedy` указано, как повторить проверку. Если тариф и доступ подтверждены, ответ остаётся `502 CONNECTOR_REST_UNAVAILABLE`.

### NEW-1106-5: отказ длительной команды из-за расхождения часов сервера получил отдельный код

[POST /v1/infra/servers/{id}/exec](/docs/infra/deploy/exec) в длительном режиме (`async=true`) теперь отвечает HTTP 502 с кодом `EXEC_JOB_START_WINDOW`, когда сервер отклонил запуск из-за собственных часов: они опережают часы платформы больше чем на минуту или отстают больше чем на тридцать секунд. Отказ приходит до запуска команды, поэтому после сверки времени на сервере ту же команду можно отправить заново. Раньше такой случай приходил с общим кодом `EXEC_JOB_INVALID`, который не отделял расхождение часов от прочих отказов. Новый код виден и в исходе операции в [GET /v1/infra/operations/{operationId}](/docs/infra/deploy/operation-status). Остальные отказы сохраняют прежние коды.

### FIX-1106-6: выкладка больше не срывается из-за расхождения часов сервера

**Было**

В течение часа после создания сервера или его пробуждения шаг `runtime` у [`POST /v1/infra/servers/{id}/deploy`](/docs/infra/deploy/deploy) уходил на сервер отложенной задачей с ограниченным окном запуска. Если часы сервера опережали часы платформы больше чем на минуту или отставали больше чем на тридцать секунд, задача отклонялась, и выкладка завершалась ошибкой на этом шаге, хотя запрос и код приложения были корректны.

**Стало**

Такой отказ распознаётся отдельно от остальных отказов сервера, и шаг `runtime` выполняется напрямую, без отложенной задачи. Выкладка проходит и при опережающих, и при отстающих часах сервера. Поля запроса и формат ответа не менялись.

**Влияние на интеграторов**

Действий не требуется. Отказ шага `runtime` по другим причинам приходит с прежними кодами.

### FIX-1106-7: `categoryId` стал обязательным в контракте обязательных полей CRM для всех типов, кроме лидов и предложений

**Было**

Схема `PUT` в `GET /v1/openapi.json` объявляла `categoryId` необязательным для всех типов, а пример ответа подставлял `0` даже для лидов и предложений. Интегратор, собиравший запрос по схеме, мог не передать `categoryId` для сделки и получить отказ Битрикс24.

**Стало**

[PUT /v1/deals/fields/required](/docs/entities/crm-required-fields/set), а также `PUT /v1/{contacts,companies,invoices}/fields/required` и `PUT /v1/items/{entityTypeId}/fields/required` перечисляют `categoryId` среди обязательных полей. У лидов и предложений поля нет в схеме вовсе: эти типы его не принимают. Пример ответа показывает `categoryId: null`, когда настройка глобальная. Поведение метода не менялось: правила по-прежнему проверяет Битрикс24.

**Влияние на интеграторов**

Действий не требуется: запросы, которые работали, работают как прежде. Сверьтесь со схемой, если валидация на вашей стороне считала `categoryId` необязательным для сделок, контактов, компаний, счетов и смарт-процессов.

### NEW-1106-8: агрегация предупреждает о смешанных валютах

[POST /v1/deals/aggregate](/docs/entities/deals/aggregate) теперь добавляет в `data.meta.warnings` предупреждение с кодом `AGGREGATE_MIXED_CURRENCIES`, когда `sum`, `avg`, `min` или `max` считаются по полю, которое хранится в валюте самой записи (`deals.amount`, `deals.taxValue`, `leads.opportunity`, `leads.amount`, `quotes.amount`, `invoices.opportunity`, `companies.revenue`), прочитанные записи пришли в разных валютах, а `groupBy` не содержит поля валюты. Валюты не пересчитываются, поэтому такое число складывает разные валюты. Предупреждение приходит независимо от усечения ответа и может прийти вместе с `AGGREGATE_TRUNCATED`. Устаревший `GET /v1/{entity}/aggregate` предупреждает так же. Поля учётной валюты Битрикс24 (`deals.receivedAmount`, `deals.lostAmount`) предупреждение не вызывают.

### NEW-1106-9: MCP-пакет 3.4.1: администратор приложения в сценарии входа

В `@bitrix24/mcp-vibecode-api` 3.4.1 сценарий `add-user-login` знает шаг `create-admin` из ответа настройки входа: агент выполняет его синхронно, показывает автору выданную ссылку один раз и не сохраняет её. Флаг `--reset` агент добавляет только для переданного приложения и только с согласия автора. Если в настройке входа два шага, это режим восстановления: агент выполняет только `create-admin`, ничего не устанавливает и не деплоит.

Когда в `env` настройки нет политики обработки данных, политику и способы входа автор задаёт в мастере админки приложения, и агент не запрашивает ссылку на политику. Переменные, которые уже есть в деплое, остаются до прохождения мастера. Проверка входа объясняет два новых состояния: `setup_pending` — владельцу нужно войти по ссылке установки и пройти мастер, `not_configured` — в переменных деплоя нет способа входа или политики. Инструкции сервера направляют просьбы создать администратора, вернуть доступ к админке или принять переданное приложение к шагу `create-admin`. Обновите пакет и перезапустите MCP-сессию, чтобы загрузить новые подсказки.

### FIX-1106-10: статус входа пользователей больше не называет закрытый вход работающим

**Было**

`GET /v1/app-user-signin/servers/{serverId}/status` отвечал `working`, когда в приложении стоит SDK входа 0.4 и вход посетителей ещё закрыт: мастер в админке не пройден или в переменных деплоя нет способа входа либо политики обработки данных. Без способов входа тот же случай читался как `not_installed`.

**Стало**

Для такого приложения поле `state` и `lastKnown.outcome` принимают одно из двух новых значений. `setup_pending` — в приложении SDK входа 0.4.1 или новее, вход откроется, когда владелец войдёт по ссылке установки и пройдёт мастер в админке приложения. `not_configured` — в приложении SDK входа 0.4.0, вход откроется после деплоя со способом входа и политикой. Ответ для приложений на более ранних версиях SDK и для работающего входа прежний.

**Влияние на интеграторов**

Менять ничего не нужно: `working` по-прежнему означает, что посетители могут войти. Если код сравнивает `state` со списком известных значений, добавьте в него `setup_pending` и `not_configured` — оба значат, что вход установлен, но пока закрыт.
