Convert

[POST] .../v1/lead/convert

Конвертирует CRM-обращение в сделку.

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

Название	Тип данных	Обязательность	Описание
id	Int64	Обязательный	ID обращения
target_entity_type	Enum (String)	Обязательный	Целевая сущность, допустимо только `Deal`
deal_type_id	Int64	Необязательный	ID типа сделки
deal_title	String	Обязательный	Название создаваемой сделки
pipeline_id	Int64	Необязательный	Воронка сделки
stage_id	Int64	Необязательный	Стадия сделки
responsible_user_id	Int64	Необязательный	Ответственный по сделке
participant_user_ids	Array of Int64	Необязательный	Участники сделки
amount	Decimal	Необязательный	Сумма сделки; если не передана, используется `lead.amount` (если задана у лида)
currency_id	Int64	Необязательный	ID валюты (`ctlg_common_currency_ref.crnc_id`)
fields	Array of FieldValueAdd	Необязательный	Дополнительные поля сделки

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

{
  "id": 105,
  "target_entity_type": "Deal",
  "deal_title": "Сделка по заявке #105",
  "responsible_user_id": 15,
  "participant_user_ids": [18],
  "amount": 2500.00,
  "currency_id": 1,
  "fields": []
}

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

Название	Тип данных	Описание
result.new_id	Int64	ID созданной сделки

После успешной конвертации обращение переводится в статус Converted и в стадию won.
Клиент (client_id) в новой сделке автоматически копируется из конвертируемого обращения.

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

{
  "ok": true,
  "result": {
    "new_id": 220
  }
}

Пример ошибки

{
  "ok": false,
  "result": {
    "error": 1008,
    "description": "already_converted"
  }
}