Numbering Rules: 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.
Numbering rules define the format for document numbers:
- Number template, for example,
DG-{NUMBER}orINV-{NUMBER} - Parameters for generating the number in the placeholder
{NUMBER}: starting value, step, and additional generator settings
Quick navigation: all methods
Getting Started
- Retrieve the list of available numbering rules using the documentgenerator.numerator.list method.
- If you need a custom numbering rule, create it using the documentgenerator.numerator.add method.
- Get the settings of a numbering rule by its identifier using the documentgenerator.numerator.get method.
- Pass the numbering rule identifier in the
numeratorIdfield when creating a template or updating a template. - Modify the parameters of the custom numbering rule using the documentgenerator.numerator.update method.
- Delete an unnecessary custom numbering rule using the documentgenerator.numerator.delete method.
The documentgenerator.numerator.list method returns all numbering rules available in the current Bitrix24, including CRM numbering rules.
Linking Numbering Rules with Other Objects
Document Templates. A numbering rule is linked to a template through the numeratorId field. To assign a numbering rule to a template, pass the numbering rule identifier to the documentgenerator.template.add or documentgenerator.template.update methods.
The numbering rule identifier can be obtained after creation or through the documentgenerator.numerator.list method.
Considerations When Modifying and Deleting a Numbering Rule
The documentgenerator.numerator.update and documentgenerator.numerator.delete methods only work for numbering rules created via the documentgenerator.numerator.add method.
Overview of Methods
Scope:
documentgeneratorWho can execute the methods: a user with permission to modify document generator templates
|
Method |
Description |
|
Adds a numbering rule |
|
|
Modifies a numbering rule |
|
|
Retrieves a numbering rule by identifier |
|
|
Gets a list of numbering rules |
|
|
Deletes a numbering rule |