The product data type is the information that describes the product and specifies feature values. Some of this data will be published to customers while other data is metadata for controlling product behavior once published.
To reduce the quantity of imported data, products whose content has not changed since the last successful import will be discarded automatically.
The URL to post product data to is:
https://mis.cdon.com/product
Product Definition
A vital concept with this data is that it represents a complete product definition. Each product must be delivered in its entirety, meaning there cannot be any partial product updates. The product data must thus, in each delivery, contain all data to fully describe it, lest the product will be redefined with a lesser definition.
In practice, this means that, for example, it is not possible to update only e.g. the title of a product. That would obliterate all category- and variation related data.
Data Contract
The relevant schema files are the following:
- product.xsd
- types.xsd
- variants.xsd
The last four files are supplements to the product.xsd, which define the overall product data structure.
Once, how a product varies, has been set it can not be altered. Neither can you remove a variant from a product once it is added. But more variations of a product can always be added.
Category
The category defines what attributes that describe the product.
A product must belong to exactly one category.
Variants
Some products may exist in different variants. Valid variables are:
- Size
- Color
- Flavor
- Size and Color combined
- Size and Flavor combined
Within the same product, all variants must be of the same variable(s), meaning a single product cannot have one variant that varies on e.g. flavor, and another variant that varies on e.g. size and color.
Once, how a product varies, has been set it can not be altered. Neither can you remove a variant from a product once it is added. But more variations of a product can always be added.
Product Size And Weight
The Dimensions property of a product describe the product’s size and weight.
Spatial Dimensions
Mass Dimensions
Energy Classification
The Energy property of a product describe the energy classification. The energy property consists of four parts specified as tags.
The energy classification property is optional, however to determine which products that should include energy classifications, or to read further regarding energy classification, please visit https://europa.eu/youreurope/business/environment/energy-labels/index_en.htm.
Energy Classes Enumeration
Accepted values for energyClass is:
- APlusPlusPlus
- APlusPlus
- APlus
- A
- B
- C
- D
- E
- F
- G