Edit

[POST] .../v1/deal/edit

Редактирует CRM-сделку.

Входные параметры

Название	Тип данных	Обязательность	Описание
id	Int64	Обязательный	ID сделки
task_id	Int64	Необязательный	ID связанной задачи проекта (`0` — снять привязку)
deal_type_id	Int64	Необязательный	ID типа сделки
pipeline_id	Int64	Необязательный	Изменение воронки через `edit` запрещено; используйте отдельный сценарий смены стадии/воронки
stage_id	Int64	Необязательный	Изменение стадии через `edit` запрещено; используйте `deal/setstage`
title	String	Необязательный	Название сделки
description	String	Необязательный	Описание сделки
description_mentions	Array of CommonMentionInput	Необязательный	Новый список структурированных упоминаний в `description`
mention_options	CommonMentionOptions	Необязательный	Опции обработки упоминаний
amount	Decimal	Необязательный	Сумма сделки
currency_id	Int64	Необязательный	ID валюты (`ctlg_common_currency_ref.crnc_id`)
fields	Array of FieldValueEdit	Необязательный	Изменения дополнительных полей

Если передан stage_id, метод возвращает ошибку stage_id_use_setstage. Если передан новый pipeline_id, метод возвращает ошибку pipeline_id_change_not_allowed.
Если передан description_mentions, поле description обязательно. При mention_options.add_missing_users_to_context = true упомянутые пользователи добавляются в участники сделки; для этого требуется право управления участниками сделки.

Пример запроса

{
  "id": 220,
  "task_id": 845,
  "title": "Сделка по заявке #105 (B2B)",
  "amount": 3200.00,
  "currency_id": 1,
  "fields": []
}

Выходные параметры

Название	Тип данных	Описание
result.row_affected	Int64	Количество измененных строк
result.ids	Array of Int64	ID измененных записей

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

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": [220]
  }
}