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

crm.vat.list

Получить список ставок НДС по фильтру

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

Кто может выполнять: любой пользователь

Описание

Метод crm.vat.list возвращает список ставок НДС по фильтру.
Является реализацией списочного метода для ставок НДС.

Параметры

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

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

{
    field_1: value_1,
    field_2: value_2,
    ...,
    field_n: value_n,
}
  • field_n — название поля, по которому будет произведена сортировка выборки ставок
  • value_n — значение типа string, равное:
    - ASC — сортировка по возрастанию
    - DESC — сортировка по убыванию

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

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

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

{
    field_1: value_1,
    field_2: value_2,
    ...,
    field_n: value_n,
}
  • field_n — название поля, по которому будет отфильтрована выборка элементов
  • value_n — значение фильтра

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

select array необязательный

Массив возвращаемых полей. Если не указан, возвращаются все поля

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

curl -X POST \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{"order":{"ID":"ASC"},"filter":{"ACTIVE":"Y"},"select":["ID","NAME","RATE"]}' \
     https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.vat.list

Ответ

HTTP-статус: 200

{
    "result": [
        {
            "ID": "1",
            "NAME": "Без НДС",
            "RATE": null
        },
        {
            "ID": "3",
            "NAME": "НДС 20%",
            "RATE": "20.00"
        },
        {
            "ID": "7",
            "NAME": "12",
            "RATE": "12.00"
        }
    ],
    "total": 3,
    "time": {
        "start": 1752044697.589623,
        "finish": 1752044697.66439,
        "duration": 0.0747671127319336,
        "processing": 0.00588679313659668,
        "date_start": "2025-07-09T10:04:57+03:00",
        "date_finish": "2025-07-09T10:04:57+03:00",
        "operating_reset_at": 1752045297,
        "operating": 0
    }
}

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

result object

Корневой элемент ответа. Содержит массив из объектов, содержащих информацию о полях ставок НДС.

Структура полей может быть изменена из-за параметра select

total integer

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

time time

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

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

HTTP-статус: 400

{
    "error": "Inadmissible fields for selection",
    "error_description": "Переданы недопустимые поля для выборки."
}
Код Описание Значение
400 The Commercial Catalog module is not installed. Модуль catalog не установлен
400 Access denied. Нет прав на выполнение операции
400 "Inadmissible fields for selection. Переданы недопустимые поля для выборки

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

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