метод REST scope: crm

crm.category.delete

Удалить воронку

Кто может выполнять: любой пользователь с административным доступом к разделу CRM

Описание

Метод удаляет воронку (направление) с идентификатором id.

Не получится удалить:

  • Воронки по умолчанию
  • Воронки у которых есть хотя бы один элемент

Параметры

entityTypeId integer обязательный

Идентификатор системного или пользовательского типа сущности CRM у которой будет удалена воронка

id integer обязательный

Идентификатор удаляемой воронки. Можно получить методом crm.category.list или при создании воронки методом crm.category.add

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"entityTypeId":2,"id":5}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.category.delete

Ответ

HTTP-статус: 200

{
    "result": null,
    "time": {
        "start": 1718288046.047386,
        "finish": 1718288046.892514,
        "duration": 0.845128059387207,
        "processing": 0.4207921028137207,
        "date_start": "2024-06-13T16:14:06+02:00",
        "date_finish": "2024-06-13T16:14:06+02:00",
        "operating": 0
    }
}

Возвращаемые данные

result null

Корневой элемент ответа, равный null

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 160

{
    "error": "NOT_FOUND",
    "error_description": "Элемент не найден"
}
Код Описание Значение
NOT_FOUND Смарт-процесс не найден Возникает при некорректных значениях entityTypeId
ENTITY_TYPE_NOT_SUPPORTED Entity type {entityTypeName} is not supported Возникает, если объект CRM не поддерживает воронки
NOT_FOUND Элемент не найден Возникает, если удаляемой воронки не существует
REMOVING_DISABLED Удаление системной категории запрещено Возникает, при попытке удалить системную воронку
ACCESS_DENIED Доступ запрещен Возникает, если у пользователя, удаляющего воронку, недостаточно прав
0 Найдены сделки, относящиеся к воронке {categoryName} Возникает, если у удаляемой воронки есть хотя бы один элемент. Актуально только для сделок
0 Default deal category can not be deleted Возникает при попытке удалить воронку по умолчанию. Актуально только для сделок
BX_ERROR Найдены элементы, относящиеся к воронке Возникает, если у удаляемой воронки есть хотя бы один элемент. Актуально для смарт-процессов
BX_ERROR Эта воронка является воронкой по умолчанию Возникает при попытке удалить воронку по умолчанию. Актуально для смарт-процессов

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

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