Translations of Price Type Names in the Trade Catalog: Overview of Methods

If you are developing integrations for Bitrix24 using AI tools (Codex, Claude Code, Cursor), connect to the MCP server so that the assistant can utilize the official REST documentation.

Translating the price type name allows you to set a localized name for each language in Bitrix24. This is necessary to ensure that the same price type is displayed correctly in the interface across different languages.

The translation uses:

  • id — translation identifier
  • catalogGroupId — price type identifier
  • lang — language code
  • name — localized name of the price type

Quick navigation: all methods

Considerations Before Calling Methods

  • The methods catalog.priceTypeLang.* are available only to administrators.

  • Only one translation can be created for a specific language for each price type. The pair catalogGroupId + lang must be unique. Before creating or updating, check for an existing translation using catalog.priceTypeLang.list with a filter on catalogGroupId and lang.

How to Work with Price Type Name Translations

  1. Retrieve the list of available languages using catalog.priceTypeLang.getLanguages.
  2. Check the field structure via catalog.priceTypeLang.getFields.
  3. Add a translation using the method catalog.priceTypeLang.add.
  4. To modify a translation, use catalog.priceTypeLang.update; to delete, use catalog.priceTypeLang.delete.
  5. To read a single translation by id, use catalog.priceTypeLang.get; to get a list of translations by filter, use catalog.priceTypeLang.list.

Linking Translations to Other Objects

Price Type. The translation is linked to the price type through the catalogGroupId field. The price type identifier can be obtained using the methods catalog.priceType.list and catalog.priceType.get.

Interface Language. The language code is used for the translation in the lang field. In lang, pass the value of the lid field from the response of the method catalog.priceTypeLang.getLanguages.

Overview of Methods

Scope: catalog

Who can execute the method: administrator

Method

Description

catalog.priceTypeLang.add

Adds a translation for the price type name

catalog.priceTypeLang.update

Updates the translation for the price type name

catalog.priceTypeLang.get

Returns the values of the fields for the price type name translation

catalog.priceTypeLang.list

Returns a list of price type name translations by filter

catalog.priceTypeLang.delete

Deletes the translation for the price type name

catalog.priceTypeLang.getLanguages

Returns the available languages for translation

catalog.priceTypeLang.getFields

Returns the fields for the price type name translation