метод REST scope: crm Устаревший

crm.quote.list

Получить список коммерческих предложений по фильтру

Устаревший метод. Развитие метода остановлено. Используйте crm.item.list.

Кто может выполнять: пользователь с правом «чтения» коммерческих предложений

Описание

Метод crm.quote.list возвращает список коммерческих предложений по фильтру.

Метод является реализацией списочного метода для коммерческих предложений.

Параметры

select string[] необязательный

Список полей, которые нужно вернуть в ответе.

При выборке можно использовать маски:
- '*' — для выборки всех стандартных полей (без пользовательских и множественных),
- 'UF_*' — для выборки всех пользовательских полей.

Список доступных полей для выборки можно получить с помощью метода crm.quote.fields.

По умолчанию возвращаются все стандартные поля и пользовательские поля ('*' + 'UF_*')

filter object необязательный

Объект формата:

{
    "field_1": "value_1",
    "field_2": "value_2",
    "...": "..."
}

где:
- field_n — название поля, по которому фильтруется выборка,
- value_n — значение фильтра.

Формат ключа фильтра: <оператор><поле>.
Пример: >=DATE_CREATE, @ASSIGNED_BY_ID, =%TITLE.

Поддерживаемые операторы:
- = — равно (точное совпадение, используется по умолчанию)
- != — не равно
- ! — не равно
- > — больше
- >= — больше либо равно
- < — меньше
- <= — меньше либо равно
- @ — IN (в значении передается массив)
- !@ — NOT IN (в значении передается массив)
- % — LIKE, поиск по подстроке
- =% — LIKE, поиск по шаблону
- %= — LIKE (аналогично =%)

Для LIKE:
- =%TITLE: "%меб" — подстрока в любом месте
- =%TITLE: "меб%" — начинается с меб
- =%TITLE: "%меб" — заканчивается на меб

Список доступных полей для фильтрации можно получить с помощью метода crm.quote.fields

order object необязательный

Объект формата:

{
    "field_1": "ASC",
    "field_2": "DESC"
}

где:
- field_n — поле сортировки,
- значение:
- ASC — по возрастанию,
- DESC — по убыванию.

Список доступных полей для сортировки можно получить с помощью метода crm.quote.fields.

При сортировке по STATUS_ID используется внутреннее поле STATUS_SORT

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

Параметр постраничной навигации.

Размер страницы — 50 записей.

Формула:

start = (N - 1) * 50, где N — номер страницы

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"order":{"STATUS_ID":"ASC","ID":"ASC"},"filter":{"=COMPANY_ID":1,"=STATUS_ID":"SENT"},"select":["ID","TITLE","STATUS_ID","OPPORTUNITY","CURRENCY_ID","ASSIGNED_BY_ID"]}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.quote.list

Ответ

HTTP-статус: 200

{
    "result": [
        {
            "ID": "9",
            "TITLE": "Последняя версия нашего продукта",
            "STATUS_ID": "SENT",
            "OPPORTUNITY": "45000.00",
            "CURRENCY_ID": "RUB",
            "ASSIGNED_BY_ID": "7"
        },
        {
            "ID": "43",
            "TITLE": "КП на поставку мебели",
            "STATUS_ID": "SENT",
            "OPPORTUNITY": "150000.00",
            "CURRENCY_ID": "RUB",
            "ASSIGNED_BY_ID": "1"
        }
    ],
    "total": 2,
    "time": {
        "start": 1773413037,
        "finish": 1773413037.105712,
        "duration": 0.1057119369506836,
        "processing": 0,
        "date_start": "2026-03-13T17:43:57+03:00",
        "date_finish": "2026-03-13T17:43:57+03:00",
        "operating_reset_at": 1773413637,
        "operating": 0
    }
}

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

result object[]

Массив коммерческих предложений. Состав полей зависит от параметра select

total integer

Общее количество найденных записей

next integer

Значение для параметра start в следующем запросе.

Параметр next возвращается, если количество элементов в выборке больше 50

time time

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

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

HTTP-статус: 400

{
    "error": "",
    "error_description": "Access denied."
}
Код Описание Значение
Parameter 'order' must be array. В order передан не объект
Parameter 'filter' must be array. В filter передан не объект
Access denied. У пользователя нет прав на чтение коммерческих предложений
Failed to get list. General error. Общая ошибка выполнения запроса

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

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