crm.currency.localizations.set
Установить локализации для валюты
Описание
Метод обновляет локализации для валюты или добавляет, если локализация для указанного языка не существует.
Параметры
id
string
обязательный
Идентификатор валюты.
Соответствует стандарту ISO 4217.
Идентификатор можно получить методом crm.currency.list
localizations
object
обязательный
Параметры локализации валюты.
Объект в формате {"lang_1": "value_1", ... "lang_N": "value_N"}, где lang_N — идентификатор языка, для которого надо добавить/изменить локализацию, а value — объект типа crm_currency_localization.
Существующие локализации, которые не переданы в метод, не будут изменены.
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":"CLF","localizations":{"en":{"FULL_NAME":"Unidad de Fomento","FORMAT_STRING":"CLF#VALUE#","DEC_POINT":".","THOUSANDS_VARIANT":"C","DECIMALS":4},"ru":{"FULL_NAME":"Единица развития","FORMAT_STRING":"#VALUE# CLF","DEC_POINT":".","THOUSANDS_VARIANT":"B","DECIMALS":4}}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.currency.localizations.set
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":"CLF","localizations":{"en":{"FULL_NAME":"Unidad de Fomento","FORMAT_STRING":"CLF#VALUE#","DEC_POINT":".","THOUSANDS_VARIANT":"C","DECIMALS":4},"ru":{"FULL_NAME":"Единица развития","FORMAT_STRING":"#VALUE# CLF","DEC_POINT":".","THOUSANDS_VARIANT":"B","DECIMALS":4}},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.currency.localizations.set
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
try {
const response = await $b24.actions.v2.call.make<boolean>({
method: 'crm.currency.localizations.set',
params: {
id: 'CLF',
localizations: {
en: {
FULL_NAME: 'Unidad de Fomento',
FORMAT_STRING: 'CLF#VALUE#',
DEC_POINT: '.',
THOUSANDS_VARIANT: 'C',
DECIMALS: 4,
},
ru: {
FULL_NAME: 'Unit of Account',
FORMAT_STRING: '#VALUE# CLF',
DEC_POINT: '.',
THOUSANDS_VARIANT: 'B',
DECIMALS: 4,
},
},
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info('Localizations set:', result)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function setCurrencyLocalizations() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'crm.currency.localizations.set',
params: {
id: 'CLF',
localizations: {
en: {
FULL_NAME: 'Unidad de Fomento',
FORMAT_STRING: 'CLF#VALUE#',
DEC_POINT: '.',
THOUSANDS_VARIANT: 'C',
DECIMALS: 4,
},
ru: {
FULL_NAME: 'Unit of Account',
FORMAT_STRING: '#VALUE# CLF',
DEC_POINT: '.',
THOUSANDS_VARIANT: 'B',
DECIMALS: 4,
},
},
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info('Localizations set:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', setCurrencyLocalizations)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.crm.currency.localizations.set(
bitrix_id="CLF",
localizations={
"en": {
"FULL_NAME": "Unidad de Fomento",
"FORMAT_STRING": "CLF#VALUE#",
"DEC_POINT": ".",
"THOUSANDS_VARIANT": "C",
"DECIMALS": 4,
},
"ru": {
"FULL_NAME": "Единица развития",
"FORMAT_STRING": "#VALUE# CLF",
"DEC_POINT": ".",
"THOUSANDS_VARIANT": "B",
"DECIMALS": 4,
},
},
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$response = $b24Service
->core
->call(
'crm.currency.localizations.set',
[
'id' => 'CLF',
'localizations' => [
'en' => [
'FULL_NAME' => 'Unidad de Fomento',
'FORMAT_STRING' => 'CLF#VALUE#',
'DEC_POINT' => '.',
'THOUSANDS_VARIANT' => 'C',
'DECIMALS' => 4,
],
'ru' => [
'FULL_NAME' => 'Единица развития',
'FORMAT_STRING' => '#VALUE# CLF',
'DEC_POINT' => '.',
'THOUSANDS_VARIANT' => 'B',
'DECIMALS' => 4,
],
],
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error setting currency localizations: ' . $e->getMessage();
}
BX24.callMethod(
"crm.currency.localizations.set",
{
id: 'CLF',
localizations: {
en: {
FULL_NAME: 'Unidad de Fomento',
FORMAT_STRING: 'CLF#VALUE#',
DEC_POINT: '.',
THOUSANDS_VARIANT: 'C',
DECIMALS: 4,
},
ru: {
FULL_NAME: 'Единица развития',
FORMAT_STRING: '#VALUE# CLF',
DEC_POINT: '.',
THOUSANDS_VARIANT: 'B',
DECIMALS: 4,
}
}
},
)
.then(
function(result)
{
if (result.error())
{
console.error(result.error());
}
else
{
console.log(result);
}
},
function(error)
{
console.info(error);
}
);
require_once('crest.php');
$result = CRest::call(
'crm.currency.localizations.set',
[
'id' => 'CLF',
'localizations' => [
'en' => [
'FULL_NAME' => 'Unidad de Fomento',
'FORMAT_STRING' => 'CLF#VALUE#',
'DEC_POINT' => '.',
'THOUSANDS_VARIANT' => 'C',
'DECIMALS' => 4,
],
'ru' => [
'FULL_NAME' => 'Единица развития',
'FORMAT_STRING' => '#VALUE# CLF',
'DEC_POINT' => '.',
'THOUSANDS_VARIANT' => 'B',
'DECIMALS' => 4,
]
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "crm.currency.localizations.set", b24.Params{
"id": "CLF",
"localizations": b24.Params{
"en": b24.Params{
"FULL_NAME": "Unidad de Fomento",
"FORMAT_STRING": "CLF#VALUE#",
"DEC_POINT": ".",
"THOUSANDS_VARIANT": "C",
"DECIMALS": 4,
},
"ru": b24.Params{
"FULL_NAME": "Единица развития",
"FORMAT_STRING": "#VALUE# CLF",
"DEC_POINT": ".",
"THOUSANDS_VARIANT": "B",
"DECIMALS": 4,
},
},
})
if err != nil {
return fmt.Errorf("crm.currency.localizations.set: %w", err)
}
var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)
Ответ
HTTP-статус: 200
{
"result": true,
"time": {
"start": 1718122481.837301,
"finish": 1718122483.141736,
"duration": 1.3044350147247314,
"processing": 0.08866286277770996,
"date_start": "2024-06-11T18:14:41+02:00",
"date_finish": "2024-06-11T18:14:43+02:00",
"operating": 0
}
}
Возвращаемые данные
result
boolean
Возвращает:
- true — в случае успеха
- false – в случае, когда операцию выполнить не удалось, но ошибки нет, либо ситуация не считается ошибочной. Возможные варианты:
- отсутствует модуль валют
- передан пустой объект с локализациями
- не была добавлена/изменена ни одна локализация
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "",
"error_description": "The parameter id is invalid or not defined."
}
| Код | Описание | Значение |
|---|---|---|
Пустая строка |
Access denied. | Недостаточно прав доступа |
Пустая строка |
The parameter id is invalid or not defined. | Пустой идентификатор валюты |

