Products in the Trade Catalog: Overview of Methods

Using REST methods, you can create simple products or services, as well as products with variations.

A simple product or service is a single inventory item with a name and unit of measurement. A product variation is a trade offer where the product has additional characteristics: color and size. For each combination of characteristics, a separate inventory item with a unique SKU is created.

Quick navigation: all methods and events

User documentation:

Linking Products to Other Objects

Trade Catalog. A product must be linked to a specific trade catalog. You can obtain the identifiers of available trade catalogs using the catalog.catalog.list method.

Sections of the Trade Catalog. Products are typically distributed across sections. To create and manage sections, use the group of methods catalog.section.* .

Units of Measurement. You can add the necessary units of measurement using the catalog.measure.* methods.

Product and Variation Images. To help customers understand what the product is, add product images: a detailed picture, a preview image, as well as additional images. For this, use the catalog.productImage.* methods.

Product and Variation Properties. All products and variations in the online store have a set of properties that distinguish them from one another, such as color or size. These properties help customers search for and select products on the site. Create properties using the catalog.productProperty.* methods.

Price Types. Price types allow you to manage different pricing categories. A single product can have multiple prices: wholesale, retail, partner. To manage price types, use the catalog.priceType.* methods.

Price. Specify the product price using the catalog.price.* methods.

Inventory Management. If inventory management is enabled, you do not need to specify the available quantity when creating or editing a product — inventory management will automatically set the values.

Overview of Methods and Events

Scope: catalog

Who can perform methods: administrator

Products

Method

Description

catalog.product.add

Adds a product

catalog.product.update

Updates product fields

catalog.product.get

Returns product field values by identifier

catalog.product.list

Returns a list of products by filter

catalog.product.download

Downloads product files by provided parameters

catalog.product.delete

Deletes a product

catalog.product.getFieldsByFilter

Returns product fields by filter

Event

Triggered

CATALOG.PRODUCT.ON.ADD

When a product is added

CATALOG.PRODUCT.ON.UPDATE

When a product is updated

CATALOG.PRODUCT.ON.DELETE

When a product is deleted

Services

Method

Description

catalog.product.service.add

Adds a service

catalog.product.service.update

Updates service fields

catalog.product.service.get

Returns service field values by identifier

catalog.product.service.list

Returns a list of services by filter

catalog.product.service.download

Downloads service files by provided parameters

catalog.product.service.delete

Deletes a service

catalog.product.service.getFieldsByFilter

Returns service fields by filter

Event

Triggered

CATALOG.PRODUCT.ON.ADD

When a service is added

CATALOG.PRODUCT.ON.UPDATE

When a service is updated

CATALOG.PRODUCT.ON.DELETE

When a service is deleted

Products with Variations: Parent Products

Method

Description

catalog.product.sku.add

Adds a parent product

catalog.product.sku.update

Updates parent product fields

catalog.product.sku.get

Returns parent product field values by identifier

catalog.product.sku.list

Returns a list of parent products by filter

catalog.product.sku.download

Downloads parent product files by provided parameters

catalog.product.sku.delete

Deletes a parent product

catalog.product.sku.getFieldsByFilter

Returns parent product fields by filter

Event

Triggered

CATALOG.PRODUCT.ON.ADD

When a parent product is added

CATALOG.PRODUCT.ON.UPDATE

When a parent product is updated

CATALOG.PRODUCT.ON.DELETE

When a parent product is deleted

Products with Variations: Variations

Method

Description

catalog.product.offer.add

Adds a product variation

catalog.product.offer.update

Updates product variation fields

catalog.product.offer.get

Returns product variation field values by identifier

catalog.product.offer.list

Returns a list of product variations by filter

catalog.product.offer.download

Downloads product variation files by provided parameters

catalog.product.offer.delete

Deletes a product variation

catalog.product.offer.getFieldsByFilter

Returns product variation fields by filter

Event

Triggered

CATALOG.PRODUCT.ON.ADD

When a variation is added

CATALOG.PRODUCT.ON.UPDATE

When a variation is updated

CATALOG.PRODUCT.ON.DELETE

When a variation is deleted