Measurement Units 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.

Every product has a measurement unit: weight, quantity, volume, and so on. Bitrix24 offers popular options, but you can add your own.

To set the primary measurement unit, specify the value Y in the isDefault parameter. Then, when creating a new product, it will be automatically selected in the detail form.

Quick navigation: all methods and events

User documentation:

Measurement Unit Ratio

If you sell products by fractions or in packs, specify the measurement unit ratio in the product detail form. Examples:

  • for fabric, set the ratio to 0.1 so that customers can order in increments of 0.1 meters, for example, 3.6 meters,
  • for beverages in packs of 6 bottles, use a ratio of 6: 1 unit equals 6 bottles, 3 units equals 18 bottles.

You can view measurement unit ratios using the methods catalog.ratio.*.

Connection of Measurement Units with Other Objects

Products. Create and edit products using the following groups of methods:

Overview of Methods and Events

Scope: catalog

Who can execute methods: administrator

Method

Description

catalog.measure.add

Adds a measurement unit

catalog.measure.update

Updates a measurement unit

catalog.measure.get

Returns information about a measurement unit by its identifier

catalog.measure.list

Returns a list of measurement units

catalog.measure.delete

Deletes a measurement unit

catalog.measure.getFields

Returns available fields of measurement units

Event

Triggered

CATALOG.MEASURE.ON.ADD

When a measurement unit is added

CATALOG.MEASURE.ON.UPDATE

When a measurement unit is updated

CATALOG.MEASURE.ON.DELETE

When a measurement unit is deleted