Products Classification

Products Classification

The classification process consists of establishing the relation between the products’ category of the merchant to the Marketplace categories tree.

You just need to identify that, for example, the category Telephones > Cellphones of the merchant is equivalent to the category “Telephones & Cellphones > Smartphones”.

Identifying the equivalent category for each of the load products may take a while, since, in many cases, this relation is not so simple.

For that, we recommend the merchant to inform the categories already accepted by Marketplace, instead of the ones already set in their own system.

Performing a query of those categories is simple: the merchant’s API provides a resource to check the information:

Learn more technical details about the categories resource.

Usage of the Categories service

This service allows you to browse the entire categories tree of Marketplace, and to view, in every category, which attributes must be mandatorily informed.

Let’s use as an example, a part of the Beach Fashion category, existing on Marketplace:

{
   "id": 2226,
   "name": "Beach Fashion",
   "parentId": 1057,
   "items": null,
   "attributes": [
   {
       "name": "Watch the Video",
       "values": null,
       "isVariant": false
   },
   {
       "name": "Brand",
       "values": null,
       "isVariant": false
   },
   {
       "name": "Size",
       "values": [
           "PR", "0 - 1 Year", "19 - 23", "23 - 25", "26 - 29", "14 - 18 months", "19 - 23 months", 
           "24 - 27 months", "30 - 36 months", "0 - 15 ", "16 - 20", "21 - 25", "26 - 30", "24 - 30", 
           "6 - 9 months", "6 - 12 months", "18 - 24 months", "3 - 4 years", "15 - 18", "31", "XS", "NB", "S", 
           "M", "L", "3 - 6 months", "3 months", "10 months", "17 - 18", "27 - 29", "19 - 20", "21 - 23", 
           "2 - 3 years", "15 - 16", "24 - 26", "S - M", "L - X", "6 months", "9 months", "12 months", "18 months", 
           "8 months", "0 - 6 months", "XL", "9 - 12 months", "31 months", "24 months", "M - L", "1", "2", 
           "3", "4", "1T", "2T", "3T", "4T", "X", "0 - 3 months", "6 - 9 months", "16", "17", "18", 
           "19", "20", "21", "3T/4T", "5T", "one-size-fits-all", "12 - 18 months", "1T/2T", "5 - 18", "14 - 21", 
           "17 - 20", "0 - 4 months", "16 - 20", "21 - 25", "24 - 30", "9 - 12 months", "17 - 20", "13 - 16", "21 - 24", 
           "20 - 21", "22 - 23", "2 - 4 years", "16 - 18", "23 - 27", "PR1", "4 months", "0 - 3 months", 
           "12 - 18 months", "0 - 6 months", "X", "6", "PR", "9 - 18 months", "XL", "19 - 22", "BB", "15", 
           "0 - 4 M", "5 - 8 M", "12 - 24 months", "3 - 12 months"
       ],
       
       "isVariant": true
    }
}

Note that the structure provides basic information such as name and ID, and also all the attributes supported by this category, in the attributes field.

There is a field called isVariant in each declared attribute. This field indicates if the value for products of this category must be informed in the product’s parameter list.

Note that, in this example, the Brand information is optional, but the Size is mandatory. Besides that, for this field, you can check the possible values in the values property.

What to do with this information?

You can create on your platform administrator a FROM-TO mechanism, so that the merchant can map your categories to the Marketplace ones.

In this way, you will be able to “translate” the categories of every merchant to the Marketplace categories, and also speed up a lot the process of adding products.