crm.vat.update
Обновить существующую ставку НДС
Описание
Метод crm.vat.update обновляет параметры существующей ставки НДС.
Параметры
id
integer
обязательный
Идентификатор ставки НДС, которую нужно обновить. Получить список ставок можно методом crm.vat.list
fields
object
обязательный
Массив полей для обновления. Список доступных полей описан ниже
Параметр fields
ACTIVE
string
необязательный
Активность ставки:
- Y — активна,
- N — неактивна.
C_SORT
integer
необязательный
Сортировка
NAME
string
обязательный
Название ставки
RATE
double
обязательный
Значение ставки НДС, %
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":7,"fields":{"ACTIVE":"N","NAME":"НДС 20% (неактивна)"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.vat.update
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":7,"fields":{"ACTIVE":"N","NAME":"НДС 20% (неактивна)"},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.vat.update
try
{
const response = await $b24.callMethod(
"crm.vat.update",
{
id: 7,
fields: {
ACTIVE: "N",
NAME: "НДС 20% (неактивна)"
}
}
);
const result = response.getData().result;
if (result.error()) {
console.error(result.error());
} else {
console.dir(result);
}
}
catch( error )
{
console.error('Error:', error);
}
try {
$response = $b24Service
->core
->call(
'crm.vat.update',
[
'id' => 7,
'fields' => [
'ACTIVE' => 'N',
'NAME' => 'НДС 20% (неактивна)'
],
]
);
$result = $response
->getResponseData()
->getResult();
if ($result->error()) {
error_log($result->error());
} else {
echo 'Success: ' . print_r($result->data(), true);
}
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error updating VAT: ' . $e->getMessage();
}
BX24.callMethod(
"crm.vat.update",
{
id: 7,
fields: {
ACTIVE: "N",
NAME: "НДС 20% (неактивна)"
}
},
function(result) {
if(result.error())
console.error(result.error());
else
console.dir(result.data());
}
);
require_once('crest.php');
$result = CRest::call(
'crm.vat.update',
[
'id' => 7,
'fields' => [
'ACTIVE' => 'N',
'NAME' => 'НДС 20% (неактивна)'
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "crm.vat.update", b24.Params{
"id": 7,
"fields": b24.Params{
"ACTIVE": "N",
"NAME": "НДС 20% (неактивна)",
},
})
if err != nil {
return fmt.Errorf("crm.vat.update: %w", err)
}
var value b24.ID
if err := json.Unmarshal(res.Result, &value); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("результат:", value)
Ответ
HTTP-статус: 200
{
"result": 13,
"time": {
"start": 1752045209.496356,
"finish": 1752045209.539975,
"duration": 0.04361891746520996,
"processing": 0.009280920028686523,
"date_start": "2025-07-09T10:13:29+03:00",
"date_finish": "2025-07-09T10:13:29+03:00",
"operating_reset_at": 1752045809,
"operating": 0
}
}
Возвращаемые данные
result
boolean
Корневой элемент ответа, содержит идентификатор обновленной ставки
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "Invalid identifier.",
"error_description": "Передан некорректный идентификатор."
}
| Код | Описание | Значение |
|---|---|---|
400 |
The Commercial Catalog module is not installed. |
Модуль catalog не установлен |
400 |
Invalid parameters. |
Переданы некорректные параметры |
400 |
Access denied. |
Нет прав на выполнение операции |
400 |
Invalid identifier. |
Передан некорректный идентификатор |
400 |
Error on updating VAT rate. |
Ошибка при обновлении ставки НДС |

