Product Category

This guide will explain how to export your categories to SkyHub.

Why is it so important?

The product categories need to be sent to Skyhub the right way, so products are directed to the appropriate department within the Marketplace.

What are the benefits?

Your product will have the right positioning in the Marketplace catalog, and thereby increase the chance of buyers finding your products, therefore increasing sales.

Most e-commerces have folder like structure that defines a hierarchy over categories. For example, the "charger" category may be a subcategory of the "Cell Phone" category.

To simulate the hierarchy, the product category at Skyhub should be the sum of all category names in the hierarchy separated by a ">".

Samples	Árvores de categorias
Sample 1	Bedrooms > Double > Wardrobe > 2 Doors
Sample 2	Electronics > Notebook > Dual Core > 7th generation
Sample 3	Electronics > Cell Phones > Accessories > Headphone

What is not good practice?

We do not recommend sending Generic categories to the Marketplace that make it difficult for you to decide where to place your products within the Marketplace category structure.

Categories	Why we do not recommend
Eletrônicos > LG	The LG brand has other types of products, such as monitors, microwaves and televisions. In this way, the decision on where to position the product will not be assertive on marketplace.
Eletrônicos | Celulares | LG	When separating the categories by pipe (|) to SkyHub does not understand that they are distinct categories causing difficulty in positioning the products in the marketplace

How to send the category this way in Json?

You should submit the categories through the POST method with the following body:

Sample 1

{
  "category": {
    "code": "category001",
    "name": "Bedroom > Couple > Wardrobe"
  }
}

Sample 2

{
  "category": {
    "code": "category002",
    "name": "Eletronics > Notebook > Apple"
  }
}

Sample 3

{
  "category": {
    "code": "category003",
    "name": "Eletronics > Cell PHones > HeadPhone"
  }
}

Remember: When sending the products to SkyHub you will need to include its category name based on those categories that has already been created over category endpoint.

Sample:

{
    "product": {
        "sku": "201",
        "name": "TEST PRODUCT",
        "description": "TEST PRODUCT",
        "status": "enabled",
        "price": 30.00,
        "promotional_price": 29.90,
        "cost": 0.2,
        "weight": 0.100,
        "height": 20,
        "width": 30,
        "length": 20,
        "brand": "SKYHUB",
        "nbm": "98769898",
        "categories": [{
            "code": "001",
            "name": "ELETRONICS > CELL PHONES > SMARTPHONE > ANDROID"
        }],
      "images": [
            "image_url"
        ],
        "specifications": [{
            "key": "Product specifications PAI",
            "value": "Product specifications PAI"
        }],
        "variations": [{
            "sku": "202",
            "qty": 100,
            "ean": "9876543210987",
            "images": [
                "url_da_imagem"
            ],
            "specifications": [{
                "key": "atributo_que_define_a_variacao_do_sku_1",
                "value": "atributo_que_define_a_variacao_do_sku_1"
            }, {
                "key": "atributo_que_define_a_variacao_do_sku_2",
                "value": "atributo_que_define_a_variacao_do_sku_2"
            }]
        }],
        "variation_attributes": [
            "atributo_que_define_a_variacao_do_produto_2",
            "atributo_que_define_a_variacao_do_produto_2"
        ]
    }
}

For details on product integration, see the guide below:

Product Integration