метод REST scope: crm

crm.currency.update

Обновить валюту

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

Описание

Метод обновляет существующую валюту.

Параметры

ID string необязательный

Идентификатор валюты.

Соответствует стандарту ISO 4217.

Идентификатор можно получить методом crm.currency.list

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

Значения полей (подробное описание приведено ниже) для обновления валюты в виде структуры:

fields: {
    SORT: 'значение'
    AMOUNT_CNT: 'значение',
    AMOUNT: 'значение'
    BASE: 'значение',
    LANG: {
        lang_1: {
            DECIMALS: 'значение',
            DEC_POINT: 'значение',
            ...
        },
        ...
        lang_N: {
            ...
        }
    }
}

Параметр fields

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

Положение в списке валют.

Значение по умолчанию — 100

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

Номинал. В качестве номинала чаще всего используется 1 или число кратное 10

AMOUNT double обязательный

Курс обмена по отношению к базовой валюте

BASE string необязательный

Признак, является ли валюта базовой.

Возможные значения:
- Y — да
- N — нет

Значение по умолчанию — N.

Не рекомендуется менять базовую валюту через REST. Иначе необходимо будет изменить курсы всех валют

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

Параметры локализации валюты.

Объект в формате {"lang_1": "value_1", ... "lang_N": "value_N"}, где lang_N — идентификатор языка, а value — объект типа crm_currency_localization.

Если указать не все языки, для оставшихся будут использоваться параметры локализации по умолчанию

Параметр LANG

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

Число десятичных знаков дробной части

DEC_POINT string необязательный

Десятичная точка при выводе

FORMAT_STRING string необязательный

Шаблон формата

FULL_NAME string необязательный

Название валюты на языке, для которого добавляется локализация

HIDE_ZERO string необязательный

Признак, скрывать незначащие нули или нет

THOUSANDS_SEP string необязательный

Разделитель триад

THOUSANDS_VARIANT string необязательный

Код разделителя триад.

Допустимые значения смотрите в справочнике crm_currency_localization

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"ID":"CNY","fields":{"AMOUNT":15.3449}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.currency.update

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1717764521.938284,
        "finish": 1717764522.516576,
        "duration": 0.5782921314239502,
        "processing": 0.07656002044677734,
        "date_start": "2024-06-07T14:48:41+02:00",
        "date_finish": "2024-06-07T14:48:42+02:00",
        "operating": 0
    }
}

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

result boolean

Результат обновления валюты

time time

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

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

HTTP-статус: 400

{
	"error": "",
	"error_description": "Access denied."
}
Код Описание Значение
Пустая строка Access denied. Недостаточно прав доступа
Пустая строка Модуль "Валюты" не найден! Пожалуйста, установите модуль "Валюты".
ERROR_CODE Другие ошибки в данных для изменения валюты

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

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