catalog.priceTypeLang.add
Добавить перевод названия типа цены
Описание
Метод добавляет новый перевод названия типа цены.
Параметры
fields
object
обязательный
Значения полей для создания нового перевода названия типа цены
Параметр fields
catalogGroupId
catalog_price_type.id
обязательный
Идентификатор типа цены.
Получить идентификаторы типов цен можно с помощью метода catalog.priceType.list
name
string
обязательный
Перевод названия типа цены
lang
catalog_language.lid
обязательный
Идентификатор языка.
Получить идентификаторы языков можно с помощью метода catalog.priceTypeLang.getLanguages
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"catalogGroupId":1,"lang":"kz","name":"PRICE"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.priceTypeLang.add
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"catalogGroupId":1,"lang":"kz","name":"PRICE"},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/catalog.priceTypeLang.add
// 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
// Shape of the payload returned in result (match the "response handling" section of the page)
type PriceTypeLangAddResult = {
priceTypeLang: {
catalogGroupId: number
id: number
lang: string
name: string
}
}
try {
const response = await $b24.actions.v2.call.make<PriceTypeLangAddResult>({
method: 'catalog.priceTypeLang.add',
params: {
fields: {
catalogGroupId: 1,
lang: 'kz',
name: 'PRICE',
},
},
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(result.priceTypeLang)
}
} 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 addPriceTypeLang() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'catalog.priceTypeLang.add',
params: {
fields: {
catalogGroupId: 1,
lang: 'kz',
name: 'PRICE',
},
},
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(result.priceTypeLang)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', addPriceTypeLang)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.catalog.price_type_lang.add(
fields={
"catalogGroupId": 1,
"lang": "kz",
"name": "PRICE",
},
).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(
'catalog.priceTypeLang.add',
[
'fields' => [
'catalogGroupId' => 1,
'lang' => "kz",
'name' => "PRICE",
],
]
);
$result = $response
->getResponseData()
->getResult();
if ($result->error()) {
error_log($result->error()->ex);
} else {
echo 'Success: ' . print_r($result->data(), true);
}
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error adding price type language: ' . $e->getMessage();
}
BX24.callMethod(
'catalog.priceTypeLang.add',
{
fields: {
catalogGroupId: 1,
lang: "kz",
name: "PRICE"
}
},
function(result) {
if (result.error())
console.error(result.error().ex);
else
console.log(result.data());
}
);
require_once('crest.php');
$result = CRest::call(
'catalog.priceTypeLang.add',
[
'fields' => [
'catalogGroupId' => 1,
'lang' => 'kz',
'name' => 'PRICE'
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "catalog.priceTypeLang.add", b24.Params{
"fields": b24.Params{
"catalogGroupId": 1,
"lang": "kz",
"name": "PRICE",
},
})
if err != nil {
return fmt.Errorf("catalog.priceTypeLang.add: %w", err)
}
// Метод заворачивает ответ в объект с ключом "priceTypeLang".
raw, ok := b24.Unwrap(res.Result, "priceTypeLang")
if !ok {
return fmt.Errorf("в ответе нет ключа priceTypeLang")
}
var item struct {
CatalogGroupID b24.ID `json:"catalogGroupId"`
ID b24.ID `json:"id"`
Lang string `json:"lang"`
Name string `json:"name"`
}
if err := json.Unmarshal(raw, &item); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println(item.CatalogGroupID, item.ID)
Ответ
HTTP-статус: 200
{
"result": {
"priceTypeLang": {
"catalogGroupId": 1,
"id": 3,
"lang": "kz",
"name": "PRICE"
}
},
"time": {
"start": 1733839992.06918,
"finish": 1733839992.36208,
"duration": 0.29290509223938,
"processing": 0.0136539936065674,
"date_start": "2024-12-10T16:13:12+02:00",
"date_finish": "2024-12-10T16:13:12+02:00",
"operating": 0
}
}
Возвращаемые данные
result
object
Корневой элемент ответа
priceTypeLang
catalog_price_type_lang
Объект с информацией о созданном переводе названия типа цены
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": 200040300020,
"error_description": "Access Denied"
}
| Код | Описание | Значение |
|---|---|---|
200040300020 |
Недостаточно прав для редактирования | |
201200000010 |
Языка с заданным идентификатором не существует | |
201000000000 |
Типа цены с заданным идентификатором не существует | |
400 |
Перевод для заданной пары: тип цены и идентификатор языка уже существуют | |
100 |
Не передан обязательный параметр fields |
|
0 |
Не установлены обязательные поля | |
0 |
Другие ошибки (например, фатальные ошибки) |

