Skip to content

Latest commit

 

History

History
137 lines (100 loc) · 7.78 KB

File metadata and controls

137 lines (100 loc) · 7.78 KB

Trade Catalog: Overview of Sections

{% note tip "" %}

Choose a tool for developing with an AI agent:

  • use Alaio Vibecode to build an app for Bitrix24 from a task description without knowing any programming language. The agent writes the code and deploys the app to a server, with no manual hosting setup
  • use the MCP server to develop a REST API integration in your own project. The agent refers to the official REST documentation

{% endnote %}

The Commercial Catalog in Bitrix24 serves as a unified catalog of products and services for CRM and online stores. It helps maintain up-to-date information on items, expedites document generation in CRM, and automates data exchange with external systems.

The sections of the Commercial Catalog cover essential data and settings:

  • products, services, and variations
  • prices, price types, markups, and rounding rules
  • product properties and their values
  • catalog structure and product images
  • units of measurement, coefficients, and VAT rates
  • warehouses, stock levels, and inventory documents

Quick navigation: All Catalog Sections

User documentation: Product catalog

How to Choose a Section

#| || If you need to | Open the section || || Work with products, services, and variations | Products || || Create and modify prices, price types, and rounding rules | Price, Price Types, Rounding Rules || || Configure product properties, list values, and display parameters | Product and Variation Properties, List Property Values, Product and Variation Property Parameters, Section Settings for Properties || || Work with product and variation images | Product and Variation Images || || Work with warehouses, stock levels, and inventory documents | Warehouses, Stock Levels by Warehouse, Inventory Accounting || || Get catalog reference values | Enumerations, Units of Measurement, VAT Rates, Markups || |#

{% note tip "User documentation" %}

{% endnote %}

Getting Started

  1. Check the structure of the required object, field names, and their types on the page Data Types and Object Structure in the Catalog REST API.
  2. Identify the main object of the scenario: product, price, property, warehouse, or accounting document.
  3. Open the relevant section and retrieve the list of objects using the list method to gather working identifiers.
  4. Modify the object using the add or update methods of the appropriate section.
  5. Verify the result using the get method and, if necessary, clarify available fields using the getFields method.

See the complete scenario for creating a product with properties and a price in the tutorial How to Add a Product with Custom Property Values.

Access Permissions

By default, only the Bitrix24 administrator can edit the catalog and configure access permissions. The administrator can also grant this permission to other employees.

{% note tip "User documentation" %}

{% endnote %}

Connection with Other Objects

CRM. Catalog data is used in the product lines of deals, invoices, and estimates: the product ID, price, discount, and VAT are transmitted. For scenarios involving vendors, use the methods Working with CRM Vendors.

Online Store. The catalog generates data for the storefront and product detail pages of the online store.

Files. In the catalog methods, files and images are transmitted in the fileData or fileContent format: file name and content in Base64. The upload format and examples are provided on the page How to Upload Files.

Overview of Catalog Sections {#all-methods}

Scope: catalog

Who can execute the method: depends on the method

Main Catalog Objects

#| || Section | Description || || Trade Catalog | Basic methods for working with the trade catalog || || Products | Methods for working with products || || Variable Products: Parent Products | Methods for working with parent products || || Variable Products: Variations | Methods for working with product variations || || Services | Methods for working with services || || Catalog Sections | Methods for working with catalog sections || || Product and Variation Images | Methods for working with product and variation images || |#

Prices and Pricing

#| || Section | Description || || Price | Methods for working with prices || || Price Types | Methods for working with price types || || Assigning Price Types to Customer Groups | Methods for binding price types to customer groups || || Price Type Name Translations | Methods for translating price type names || || Price Rounding Rules | Methods for working with rounding rules || || Markups | Methods for working with markups || |#

Product Properties and Parameters

#| || Section | Description || || Product and Variation Properties | Methods for working with product and variation properties || || List Property Values | Methods for working with list property values || || Product and Variation Property Parameters | Methods for working with product and variation property parameters || || Sectional Property Settings | Methods for working with section settings for properties || |#

Reference and Utility Sections

#| || Section | Description || || Enumerations | Reference values used in catalog methods || || Units of Measure | Methods for working with units of measurement || || Unit of Measure Coefficient | Methods for working with unit of measurement coefficients || || VAT Rates | Methods for working with VAT rates || |#

Warehouses and Accounting Documents

#| || Section | Description || || Warehouses | Methods for working with warehouses || || Stock by Warehouse | Methods for working with stock levels by warehouse || || Inventory Management | Methods for working with inventory accounting documents || || Inventory Document Products | Methods for working with product lines in accounting documents || || Inventory Document Custom Fields | Methods for working with custom fields in accounting documents || || Working with CRM Suppliers | Methods for working with vendors in inventory accounting documents || |#