A categorização de produtos é opcional é não irá gerar impacto na criação dos anúncios no marketplace.
O marketplace Americanas possui um categorizador automático chamado Minos que atua da seguinte maneira: Após a conexão do SKU, o sistema analisa o título e sua descrição, identifica a similaridade entre as categorias existentes e realiza a classificação automática que será refletida para os sites de venda.
Uma vez que a categorização ocorre diretamente pelo marketplace, as categorias adicionadas na estrutura do produto não possuem relação com a estrutura do item nos sites de venda e caíram em desuso na API.
Caso deseje categorizar os SKUs enviados para a API, é importante atentar-se ao melhor padrão: Para simular a hierarquia, o nome da categoria na API deve ser a junção de todos os nomes das categorias e subcategorias separados por um ">".
Exemplos
Árvores de categorias
Exemplo 1
Dormitórios > Casal > Guarda Roupas > 2 Portas
Exemplo 2
Eletrônicos > Computadores > Notebook > Dual Core
Exemplo 3
Eletrônicos > Celulares > Fone de ouvido > Headphone
O que não é uma boa prática?
Ao atuar com a categorização, não recomendamos que sejam adicionadas categorias genéricas para os itens criados.
Categorias
Porquê não recomendamos
Eletrônicos > LG
A marca LG dispõe de outros tipos de produtos, como monitores e televisores
Eletrônicos | Celulares | LG
Ao separar as categorias por pipe (|), a API não entende que são categorias distintas
ATENÇÃO: Limite de 10 categorias por produto.
Como enviar a categoria no JSON
Era disposto pela API o endpoint /categories para a inclusão prévia das categorias a serem utilizadas pela conta. Uma vez que o endpoint foi descontinuado, como citado no início desta seção, a inclusão de categorias deve ser realizada diretamente na estrutura do produto, como exemplos dispostos abaixo:
Exemplo 1
curl --location --request POST 'https://api.skyhub.com.br/products' \
--header 'X-User-Email: email_de_usuario' \
--header 'X-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'X-Accountmanager-Key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"product": {
"sku": "2022004",
"name": "Produto Variável Para Categorização",
"description": "Produto variável criado com o intuito de exemplificar a inclusão de categorias",
"status": "enabled",
"price": 600.00,
"promotional_price": 590.00,
"cost": 0.0,
"weight": 50,
"height": 175,
"width": 137,
"length": 39,
"brand": "SkyHub",
"nbm": "98769898",
"categories": [
{
"code": "Exemplo1",
"name": "Dormitórios > Casal > Guarda Roupas > 2 Portas"
}
],
"images": [
"url_da_imagem"
],
"specifications": [
{
"key": "Especicações do Produto Pai/Agrupador",
"value": "Especificações do Produto Pai/Agrupador"
}
],
"variations": [
{
"sku": "2022004A",
"qty": 10,
"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"
}
]
}
],
"variation_attributes": [
"atributo_que_define_a_variacao_do_sku_1"
]
}
}'
Exemplo 2
curl --location --request POST 'https://api.skyhub.com.br/products' \
--header 'X-User-Email: email_de_usuario' \
--header 'x-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'x-accountmanager-key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"product": {
"sku": "2022005",
"name": "Produto Simples Para Categorização",
"description": "Criação de produto simples com o intuito de exemplificar a inclusão de categorias",
"status": "enabled",
"qty": 0,
"price": 100,
"promotional_price": 89.99,
"cost": 49.00,
"weight": 3,
"height": 1,
"width": 1,
"length": 1,
"brand": "SkyHub",
"ean": "9876549876598",
"nbm": "45678765",
"categories": [
{
"code": "Exemplo2",
"name": "Eletrônicos > Computadores > Notebook > Dual Core"
}
],
"images": [
"url_da_imagem"
],
"specifications": [
{
"key": "Especicações do Produto",
"value": "Especicações do Produto"
}
]
}
}'
Exemplo 3
curl --location --request POST 'https://api.skyhub.com.br/products' \
--header 'X-User-Email: email_de_usuario' \
--header 'x-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'x-accountmanager-key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"product": {
"sku": "2022006",
"name": "Produto Simples Para Categorização",
"description": "Criação de produto simples com o intuito de exemplificar a inclusão de categorias",
"status": "enabled",
"qty": 0,
"price": 100,
"promotional_price": 89.99,
"cost": 49.00,
"weight": 3,
"height": 1,
"width": 1,
"length": 1,
"brand": "SkyHub",
"ean": "3456789123456",
"nbm": "78923456",
"categories": [
{
"code": "Exemplo3",
"name": "Eletrônicos > Celulares > Fone de ouvido > Headphone"
}
],
"images": [
"url_da_imagem"
],
"specifications": [
{
"key": "Especicações do Produto",
"value": "Especicações do Produto"
}
]
}
}'
As categorias adicionadas servirão para organização dos itens dentro da plataforma, pois não serão visualizadas na estrutura do produto na API ao realizar um GET no /products.
