Data Types and Object Structure in the REST API Catalog
- Data Types
- Object Structure
- catalog_catalog
- catalog_document
- catalog_document_element
- catalog_documentcontractor
- catalog_product
- catalog_product_property
- catalog_product_sku
- catalog_product_offer
- catalog_product_service
- catalog_product_image
- catalog_store
- catalog_measure
- catalog_ratio
- catalog_price
- catalog_price_type
- catalog_price_type_lang
- catalog_language
- catalog_rounding_rule
- catalog_extra
- catalog_section
- catalog_storeproduct
- catalog_vat
- Objects Used in Responses
We are still updating this page
Some data may be missing — we will complete it soon.
Basic data types are listed in a separate article.
In this article, we will discuss the data types and object structure specific to the CRM Catalog.
Data Types
|
Type |
Descriptions and Values |
|
Integer identifier of the trade catalog (e.g., |
|
|
Integer identifier of the inventory accounting document, for example |
|
|
Integer identifier of the product in the inventory accounting document, for example |
|
|
Integer identifier of the supplier binding to the inventory accounting document, for example |
|
|
Integer identifier of the product (e.g., |
|
|
Integer identifier of the product property or variation (e.g., |
|
|
Integer identifier of the parent product (e.g., |
|
|
Integer identifier of the product variation (e.g., |
|
|
Integer identifier of the service (e.g., |
|
|
Integer identifier of the product image (e.g., |
|
|
Integer identifier of the warehouse (e.g., |
|
|
Integer identifier of the unit of measurement (e.g., |
|
|
Integer identifier of the unit of measurement ratio (e.g., |
|
|
Integer identifier of the price, for example |
|
|
Integer identifier of the price type (e.g., |
|
|
Integer identifier of the translation of price type names (e.g., |
|
|
String identifier of the language, consisting of two characters (e.g., |
|
|
Integer identifier of the price rounding rule (e.g., |
|
|
Integer identifier of the markup (e.g., |
|
|
Integer identifier of the catalog section (e.g., |
|
|
Integer identifier of the record of product stock in the warehouse, for example |
|
|
Integer identifier of the VAT rate (e.g., |
Object Structure
catalog_catalog
|
Value |
Description |
|
id |
Identifier of the trade catalog |
|
iblockId |
Identifier of the information block of the trade catalog |
|
iblockTypeId |
Type of the information block of the trade catalog. For trade catalogs in CRM, it has a constant value of |
|
lid |
Site identifier. Has a constant value of |
|
name |
Name of the trade catalog |
|
productIblockId |
Identifier of the parent information block of the trade catalog. Filled only for trade catalogs of variations. To obtain existing identifiers of information blocks, you need to use catalog.catalog.list |
|
skuPropertyId |
Identifier of the property where the identifier of the parent product is stored. Filled only for trade catalogs of variations. To obtain existing identifiers of properties, you need to use catalog.productProperty.list |
|
subscription |
Is content being sold? Possible values:
This parameter is used only in the on-premise version |
|
vatId |
Identifier of VAT. To obtain existing identifiers of VAT, you need to use catalog.vat.list |
catalog_document
|
Name |
Description |
|
id |
Identifier of the warehouse accounting document |
|
docType |
Type of document. Available types can be obtained using the method catalog.enum.getStoreDocumentTypes |
|
docNumber |
Internal document number. If not provided, it is generated automatically |
|
title |
Name of the document |
|
siteId |
Code of the site to which the document relates. By default — |
|
responsibleId |
Identifier of the responsible person |
|
createdBy |
Identifier of the user who created the document |
|
modifiedBy |
Identifier of the user who modified the document |
|
status |
Status of the document:
The value is automatically changed when the document is approved or canceled |
|
statusBy |
User who changed the status of the document |
|
dateStatus |
Date of status change |
|
dateCreate |
Date of document creation |
|
dateModify |
Date of last modification of the document |
|
dateDocument |
Date of document approval |
|
currency |
Currency of the document |
|
total |
Total amount for the products in the document. The value is calculated automatically after approval but can be set manually |
|
commentary |
Commentary on the document |
catalog_document_element
|
Value |
Description |
|
id |
Identifier of the product in the warehouse accounting document |
|
docId |
Identifier of the warehouse accounting document |
|
elementId |
Identifier of the product in the catalog |
|
storeFrom |
Identifier of the source warehouse. Used for documents where write-off is required |
|
storeTo |
Identifier of the receiving warehouse. Used for incoming and transfer documents |
|
amount |
Quantity of the product |
|
purchasingPrice |
Purchasing price |
catalog_documentcontractor
|
Value |
Description |
|
id |
Identifier of the supplier binding to the warehouse accounting document |
|
documentId |
Identifier of the warehouse accounting document to which the supplier is bound |
|
entityTypeId |
Identifier of the CRM object type: |
|
entityId |
Identifier of the supplier: contact or company |
catalog_product
|
Value |
Description |
|
id |
Identifier of the product |
|
iblockId |
Identifier of the information block of the trade catalog. To obtain existing identifiers of information blocks, you need to use catalog.catalog.list |
|
name |
Name of the product |
|
active |
Activity status. Possible values:
|
|
available |
Availability for purchase. Read-only. Possible values:
|
|
code |
Symbolic code |
|
xmlId |
External code |
|
barcodeMulti |
Unique barcodes for each instance. Possible values:
|
|
bundle |
Availability of a set. Possible values:
|
|
canBuyZero |
Is purchase of the product allowed when it is out of stock? Possible values:
|
|
createdBy |
Created by |
|
modifiedBy |
Modified by |
|
dateActiveFrom |
Date of activity start |
|
dateActiveTo |
Date of activity end |
|
dateCreate |
Date of creation |
|
timestampX |
Date of modification. Read-only |
|
iblockSectionId |
Identifier of the information block section |
|
measure |
Unit of measurement |
|
previewText |
Description for the announcement |
|
detailText |
Detailed description |
|
previewPicture |
Picture for the announcement. Object in the format To delete the picture, use the object in the format |
|
detailPicture |
Detailed picture. Object in the format To delete the picture, use the object in the format |
|
previewTextType |
Type of description for the announcement. Possible values:
|
|
detailTextType |
Type of detailed description. Possible values:
|
|
sort |
Sorting |
|
subscribe |
Permission to subscribe to the product. Possible values:
|
|
vatId |
Identifier of VAT |
|
vatIncluded |
Is VAT included in the price? Possible values:
|
|
height |
Height of the product |
|
length |
Length of the product |
|
weight |
Weight of the product |
|
width |
Width of the product |
|
quantityTrace |
Quantity accounting mode. Possible values:
|
|
type |
Type of product. Read-only. Possible values:
|
|
purchasingCurrency |
Currency of the purchasing price. The list of currencies can be obtained using the method crm.currency.list. Not editable when inventory accounting is enabled |
|
purchasingPrice |
Purchasing price. Not editable when inventory accounting is enabled |
|
quantity |
Quantity. Not editable when inventory accounting is enabled |
|
quantityReserved |
Reserved quantity. Not editable when inventory accounting is enabled |
|
recurSchemeLength |
Length of the payment period. Used only in the on-premise version for content sales |
|
recurSchemeType |
Unit of time for the payment period. Possible values:
Used only in the on-premise version for content sales |
|
trialPriceId |
Product for trial payment. Used only in the on-premise version for content sales |
|
withoutOrder |
Renewal without placing an order. Possible values:
Used only in the on-premise version for content sales |
|
propertyN |
Value of the product property, where The value is specified in the format If
|
catalog_product_property
|
Value |
Description |
|
id |
Identifier of the property |
|
timestampX |
Date and time of property modification |
|
iblockId |
Identifier of the trade catalog |
|
name |
Name of the property |
|
active |
Activity indicator. Possible values:
|
|
sort |
Sorting index |
|
code |
Symbolic code of the property |
|
defaultValue |
Default value of the property |
|
propertyType |
Basic type of the property. Allowed values:
|
|
userType |
User type of the property. The value corresponds to the specified Examples of values:
|
|
rowCount |
Number of input field rows |
|
colCount |
Number of input field columns |
|
listType |
Appearance of the list |
|
multiple |
Indicator of multiplicity. Possible values:
|
|
xmlId |
External identifier of the property |
|
fileType |
Allowed extensions for file type properties |
|
multipleCnt |
Number of input fields for multiple values |
|
linkIblockId |
Identifier of the related information block. Available identifiers can be obtained using the method catalog.catalog.list |
|
withDescription |
Indicator of storing the description of the value |
|
searchable |
Indicator of participation in search. Possible values:
|
|
filtrable |
Indicator of participation in filtering |
|
isRequired |
Indicator of mandatory status. Possible values:
|
|
hint |
Hint for the field |
|
userTypeSettings |
Object with settings for user type |
catalog_product_sku
|
Value |
Description |
|
id |
Identifier of the parent product |
|
iblockId |
Identifier of the information block of the trade catalog. To obtain existing identifiers of information blocks, you need to use catalog.catalog.list |
|
name |
Name of the parent product |
|
active |
Activity status. Possible values:
|
|
available |
Availability for purchase. Read-only. Possible values:
|
|
code |
Symbolic code |
|
xmlId |
External code |
|
bundle |
Availability of a set. Possible values:
|
|
canBuyZero |
Is purchase of the parent product allowed when it is out of stock? Possible values:
For parent products, the ability to edit this field is available only in the on-premise version when the option "Show the Trade Catalog tab for products with trade offers" is enabled |
|
createdBy |
Created by |
|
modifiedBy |
Modified by |
|
dateActiveFrom |
Date of activity start |
|
dateActiveTo |
Date of activity end |
|
dateCreate |
Date of creation |
|
timestampX |
Date of modification. Read-only |
|
iblockSectionId |
Identifier of the information block section |
|
measure |
Unit of measurement. For parent products, the ability to edit this field is available only in the on-premise version when the option "Show the Trade Catalog tab for products with trade offers" is enabled |
|
previewText |
Description for the announcement |
|
detailText |
Detailed description |
|
previewPicture |
Picture for the announcement. Object in the format To delete the picture, use the object in the format |
|
detailPicture |
Detailed picture. Object in the format To delete the picture, use the object in the format |
|
previewTextType |
Type of description for the announcement. Possible values:
|
|
detailTextType |
Type of detailed description. Possible values:
|
|
sort |
Sorting |
|
subscribe |
Permission to subscribe to the parent product. Possible values:
For parent products, the ability to edit this field is available only in the on-premise version when the option "Show the Trade Catalog tab for products with trade offers" is enabled |
|
vatId |
Identifier of VAT. For parent products, the ability to edit this field is available only in the on-premise version when the option "Show the Trade Catalog tab for products with trade offers" is enabled |
|
vatIncluded |
Is VAT included in the price? Possible values:
For parent products, the ability to edit this field is available only in the on-premise version when the option "Show the Trade Catalog tab for products with trade offers" is enabled |
|
height |
Height of the parent product. For parent products, the ability to edit this field is available only in the on-premise version when the option "Show the Trade Catalog tab for products with trade offers" is enabled |
|
length |
Length of the parent product. For parent products, the ability to edit this field is available only in the on-premise version when the option "Show the Trade Catalog tab for products with trade offers" is enabled |
|
weight |
Weight of the parent product. For parent products, the ability to edit this field is available only in the on-premise version when the option "Show the Trade Catalog tab for products with trade offers" is enabled |
|
width |
Width of the parent product. For parent products, the ability to edit this field is available only in the on-premise version when the option "Show the Trade Catalog tab for products with trade offers" is enabled |
|
type |
Type of product. Read-only. Possible values:
|
|
purchasingCurrency |
Currency of the purchasing price. The list of currencies can be obtained using the method crm.currency.list. Not editable when inventory accounting is enabled. For parent products, the ability to edit this field is available only in the on-premise version when the option "Show the Trade Catalog tab for products with trade offers" is enabled |
|
purchasingPrice |
Purchasing price. Not editable when inventory accounting is enabled. For parent products, the ability to edit this field is available only in the on-premise version when the option "Show the Trade Catalog tab for products with trade offers" is enabled |
|
quantity |
Quantity. Not editable when inventory accounting is enabled. For parent products, the ability to edit this field is available only in the on-premise version when the option "Show the Trade Catalog tab for products with trade offers" is enabled |
|
propertyN |
Value of the parent product property, where The value is specified in the format If
|
catalog_product_offer
|
Value |
Description |
|
id |
Identifier of the product variation |
|
iblockId |
Identifier of the information block of the trade catalog. To obtain existing identifiers of information blocks, you need to use catalog.catalog.list |
|
name |
Name of the product variation |
|
active |
Activity status. Possible values:
|
|
available |
Availability for purchase. Read-only. Possible values:
|
|
code |
Symbolic code |
|
xmlId |
External code |
|
barcodeMulti |
Unique barcodes for each instance. Possible values:
|
|
bundle |
Availability of a set. Possible values:
|
|
canBuyZero |
Is purchase of the product variation allowed when it is out of stock? Possible values:
|
|
createdBy |
Created by |
|
modifiedBy |
Modified by |
|
dateActiveFrom |
Date of activity start |
|
dateActiveTo |
Date of activity end |
|
dateCreate |
Date of creation |
|
timestampX |
Date of modification. Read-only |
|
iblockSectionId |
Identifier of the information block section |
|
measure |
Unit of measurement |
|
previewText |
Description for the announcement |
|
detailText |
Detailed description |
|
previewPicture |
Picture for the announcement. Object in the format To delete the picture, use the object in the format |
|
detailPicture |
Detailed picture. Object in the format To delete the picture, use the object in the format |
|
previewTextType |
Type of description for the announcement. Possible values:
|
|
detailTextType |
Type of detailed description. Possible values:
|
|
sort |
Sorting |
|
subscribe |
Permission to subscribe to the product variation. Possible values:
|
|
vatId |
Identifier of VAT |
|
vatIncluded |
Is VAT included in the price? Possible values:
|
|
height |
Height of the product |
|
length |
Length of the product |
|
weight |
Weight of the product |
|
width |
Width of the product |
|
quantityTrace |
Quantity accounting mode. Possible values:
|
|
type |
Type of product. Read-only. Possible values:
|
|
purchasingCurrency |
Currency of the purchasing price. The list of currencies can be obtained using the method crm.currency.list. Not editable when inventory accounting is enabled |
|
purchasingPrice |
Purchasing price. Not editable when inventory accounting is enabled |
|
quantity |
Quantity. Not editable when inventory accounting is enabled |
|
quantityReserved |
Reserved quantity. Not editable when inventory accounting is enabled |
|
recurSchemeLength |
Length of the payment period. Used only in the on-premise version for content sales |
|
recurSchemeType |
Unit of time for the payment period. Possible values:
Used only in the on-premise version for content sales |
|
trialPriceId |
Product for trial payment. Used only in the on-premise version for content sales |
|
withoutOrder |
Renewal without placing an order. Possible values:
Used only in the on-premise version for content sales |
|
propertyN |
Value of the product variation property, where The value is specified in the format If
|
catalog_product_service
|
Value |
Description |
|
id |
Identifier of the service |
|
iblockId |
Identifier of the information block of the trade catalog. To obtain existing identifiers of information blocks, you need to use catalog.catalog.list |
|
name |
Name of the service |
|
active |
Activity status. Possible values:
|
|
available |
Availability for purchase. Read-only. Possible values:
|
|
code |
Symbolic code |
|
xmlId |
External code |
|
bundle |
Availability of a set. Possible values:
|
|
createdBy |
Created by |
|
modifiedBy |
Modified by |
|
dateActiveFrom |
Date of activity start |
|
dateActiveTo |
Date of activity end |
|
dateCreate |
Date of creation |
|
timestampX |
Date of modification. Read-only |
|
iblockSectionId |
Identifier of the information block section |
|
measure |
Unit of measurement |
|
previewText |
Description for the announcement |
|
detailText |
Detailed description |
|
previewPicture |
Picture for the announcement. Object in the format To delete the picture, use the object in the format |
|
detailPicture |
Detailed picture. Object in the format To delete the picture, use the object in the format |
|
previewTextType |
Type of description for the announcement. Possible values:
|
|
detailTextType |
Type of detailed description. Possible values:
|
|
sort |
Sorting |
|
vatId |
Identifier of VAT |
|
vatIncluded |
Is VAT included in the price? Possible values:
|
|
type |
Type of product. Read-only. Possible values:
|
|
propertyN |
Value of the service property, where The value is specified in the format If
|
catalog_product_image
|
Value |
Description |
|
id |
Identifier of the image |
|
name |
Name of the image |
|
productId |
Identifier of the product |
|
type |
Type of image:
|
|
createTime |
Date of image creation |
|
downloadUrl |
Download link, signed with the current access token |
|
detailUrl |
Link to the image |
catalog_store
|
Name |
Description |
|
id |
Identifier of the warehouse |
|
address |
Address of the warehouse |
|
title |
Name of the warehouse |
|
active |
Activity status. Possible values:
|
|
description |
Description |
|
gpsN |
GPS latitude |
|
gpsS |
GPS longitude |
|
imageId |
Image. Object in the format
To delete the picture, use the object in the format |
|
dateModify |
Date of modification |
|
dateCreate |
Date of creation |
|
userId |
Created by |
|
modifiedBy |
Modified by |
|
phone |
Phone |
|
schedule |
Working hours |
|
xmlId |
External code. Can be used to synchronize the current warehouse with a similar position in an external system |
|
sort |
Sorting |
|
email |
|
|
issuingCenter |
Is it a pickup point? Possible values:
|
|
code |
Symbolic code |
catalog_measure
|
Value |
Description |
|
id |
Identifier of the unit of measurement |
|
code |
Code of the unit of measurement |
|
isDefault |
Is the current unit of measurement used as the default unit for new products? Possible values:
Only one unit of measurement from the entire directory can take the value |
|
measureTitle |
Name of the unit of measurement |
|
symbol |
Conditional designation |
|
symbolIntl |
International conditional designation |
|
symbolLetterIntl |
International code letter designation |
catalog_ratio
|
Value |
Description |
|
id |
Identifier of the unit of measurement ratio |
|
productId |
Identifier of the product |
|
ratio |
Unit of measurement ratio |
|
isDefault |
Is this unit of measurement ratio the default ratio? Possible values:
|
catalog_price
|
Value |
Description |
|
id |
Identifier of the price |
|
productId |
Identifier of the product |
|
catalogGroupId |
Identifier of the price type |
|
price |
Value of the price |
|
priceScale |
Value of the base price |
|
currency |
Currency of the price |
|
quantityFrom |
Minimum quantity for applying the price. Deprecated parameter |
|
quantityTo |
Maximum quantity for applying the price. Deprecated parameter |
|
extraId |
Identifier of the markup. Deprecated parameter |
|
timestampX |
Date of modification |
catalog_price_type
|
Value |
Description |
|
id |
Identifier of the price type |
|
name |
Code of the price type |
|
base |
Is the price type basic? Possible values:
|
|
sort |
Sorting |
|
xmlId |
External code. Can be used to synchronize the current price type with a similar position in an external system |
|
timestampX |
Date of modification |
|
createdBy |
Created by |
|
modifiedBy |
Modified by |
|
dateCreate |
Date of creation |
catalog_price_type_lang
|
Value |
Description |
|
id |
Identifier of the translation of the price type name |
|
catalogGroupId |
Identifier of the price type |
|
name |
Translation of the price type name |
|
lang |
Identifier of the language |
catalog_language
|
Value |
Description |
|
lid |
Identifier of the language |
|
name |
Name of the language |
|
active |
Activity status. Possible values:
|
catalog_rounding_rule
|
Value |
Description |
|
id |
Identifier of the price rounding rule |
|
catalogGroupId |
Price type |
|
price |
Minimum price for rounding |
|
roundType |
Type of rounding. Possible values:
|
|
roundPrecision |
Rounding precision |
|
createdBy |
Created by |
|
modifiedBy |
Modified by |
|
dateCreate |
Date of creation |
|
dateModify |
Date of modification |
catalog_extra
|
Value |
Description |
|
id |
Identifier of the markup |
|
name |
Name of the markup |
|
percentage |
Amount of the markup |
catalog_section
|
Value |
Description |
|
id |
Identifier of the catalog section |
|
iblockId |
Identifier of the information block. To obtain existing identifiers, you need to use catalog.catalog.list |
|
iblockSectionId |
Identifier of the parent section. To obtain existing identifiers, you need to use catalog.section.list. By default, the top level is selected |
|
name |
Name of the catalog section |
|
xmlId |
External identifier. Can be used to synchronize the current catalog section with a similar position in an external system |
|
code |
Code of the catalog section |
|
sort |
Sorting |
|
active |
Indicator of the activity of the catalog section:
|
|
description |
Description |
|
descriptionType |
Type of description. Available types: |
catalog_storeproduct
|
Value |
Description |
|
id |
Identifier of the stock record |
|
productId |
Identifier of the product |
|
storeId |
Identifier of the warehouse |
|
amount |
Available quantity of the product |
|
quantityReserved |
Quantity of the product in reserve |
catalog_vat
|
Value |
Description |
|
id |
Identifier of the VAT rate |
|
name |
Name of the VAT rate |
|
active |
Indicator of the activity of the VAT rate. Possible values:
|
|
rate |
Amount of the VAT rate |
|
sort |
Sorting |
|
timestampX |
Time of the last modification |
Objects Used in Responses
rest_field_description
|
Value |
Description |
|
isImmutable |
Indicator of the ability to change the field value after creation. If this indicator is set for the field, then when creating the object, you can specify the field value, but you cannot change it during the update |
|
isReadOnly |
Read-only indicator. If this indicator is set for the field, then in the operations of adding and updating the object, the field value does not need to be passed. The value is generated automatically and is intended for read-only access |
|
isRequired |
Indicator of the field's mandatory status for add or update operations |
|
type |
Data type of the field values. Possible values:
|