Endpoint Atributos

Porque algo tão simples é tão importante para o produto?

Os atributos são informações importantes para os filtros de categorias e para diferenciar os SKUs de seu produto, quanto mais atributos/composição o seu produto tiver mais chances terá de aparecer no filtro de categorias.
Temos alguns exemplos de atributos que são obrigatórios no Marketplace (MKTP) por categoria, veja:
Atributos
Categoria
Voltagem
Eletrodomésticos
Cor
Moda
Tamanho
Moda
Sabor
Nutrição/Suplementos
Volumetria
Perfumes
Não quer dizer que o seus produtos devem se limitar apenas a estes atributos, por exemplo, no seguimento de moda temos outros atributos/composição do produto, tais como Marca, Fabricante e outros.
Para melhor compreensão de atributos obrigatórios, imagine uma loja do seguimento de moda vendendo no Marketplace, o MKTP precisa ter a informação de Cor e Tamanho de uma camiseta, pois esses são atributos de diferenciação para cada SKU do produto, e assim o Marketplace disponibilizará as opções que a sua loja possuí disponível para venda.
Agora que você compreende a importância dessas informações, vamos à pratica!
Como a integração faz o envio desses dados para a Skyhub? Os campos disponíveis no Endpoint abaixo e os seus tipos são:
1
https://api.skyhub.com.br/attributes
Copied!
Status
Type
Descrição
name
String
Internal attribute identifier
label
String
attribute label, this string displayed on the SkyHub
options
Array
Optional field: Lists attribute options, if it is of type "select" example, [red, blue, white] for a color attribute
A integração precisará utilizar o método POST através do Endpoint abaixo para criação do atributo:
1
https://api.skyhub.com.br/attributes
Copied!
As informações a serem enviadas, precisam estar no Body (Corpo) da requisição da seguinte forma:
1
{
2
"attribute": {
3
"name": "att_name",
4
"label": "Atributo Exemplo",
5
"options": [
6
"foo",
7
"foo",
8
"foo"
9
]
10
}
11
}
Copied!
Para atualizar um determinado atributo que foi criado na SkyHub, você deve usar o método PUT através do Endpoint:
1
https://api.skyhub.com.br/attributes/{nome_atributo}
Copied!
As informações a serem atualizadas precisam estar no Body da requisição da seguinte forma:
1
{
2
"attribute": {
3
"label": "Atributo Exemplo",
4
"options": [
5
"azul",
6
"azul",
7
"azul"
8
]
9
}
10
}
Copied!
Como melhores práticas, recomendamos fortemente que o atributo seja criado à parte, para posterior envio (vínculo) junto ao produto que você desejar criar na SkyHub.
Não seguir a prática acima eleva a taxa de processamento da SkyHub, podendo ocasionar retornos menos eficientes de nossa API. Isso ocorre, em virtude de uma validação que nossa ferramenta faz que consiste em verificar se o atributo já existe, e caso ele não exista a SkyHub efetua a criação.
Como teste, vamos criar um atributo em uma conta da Skyhub, através das ferramentas Rest (DHC/Postman) Na prática funciona da seguinte maneira:
Com o atributo criado, vamos consultar ele na SkyHub através do menu lateral esquerdo, Skyhub > Atributos:
Na tela abaixo, o campo Label é o campo Label exibido na API. Já o Campo Código, é o campo Name exibido na API.
Agora vamos criar um produto, fazendo uso do atributo criado anteriormente e “dizer” para a SkyHub, que este produto terá um atributo já existente na SkyHub.
Para criar um produto, nós utilizamos o método POST e o Endpoint abaixo com o seguinte BODY:
1
https://api.skyhub.com.br/product
Copied!
O campo a ser inserido no Array specifications é o valor da coluna Código (aquele que demonstramos na tela de atributos do painel SkyHub). Via API este campo chama-se NAME.

Atributo de produtos em pré-venda

É possível tratar através da API a criação de produtos em pré-venda, para isso teremos o atributo com a label "dataLancamento" no qual o value deve conter informação de data seguindo o seguinte padrão "DD/MM/AAAA", segue abaixo cURL de exemplo:
1
curl --location --request POST 'https://api.skyhub.com.br/products' \
2
--header 'X-User-Email: [email protected]' \
3
--header 'x-Api-Key: xxxxxxxxxxxxx' \
4
--header 'x-accountmanager-key: xxxxxxxxxxxxx' \
5
--header 'Accept: application/json' \
6
--header 'Content-Type: application/json' \
7
--data-raw '{
8
"product": {
9
"sku": "001",
10
"name": "PRODUTO PRE-VENDA",
11
"description": "PRODUTO PRE-VENDA",
12
"status": "enabled",
13
"qty": 0,
14
"price": 100,
15
"promotional_price": 89.99,
16
"cost": 49.00,
17
"weight": 3,
18
"height": 1,
19
"width": 1,
20
"length": 1,
21
"brand": "SKYHUB",
22
"ean": "",
23
"nbm": "",
24
"categories": [
25
{
26
"code": "01",
27
"name": "skyhub homologação"
28
}
29
],
30
"images": [""],
31
"specifications": [
32
{
33
"key": "dataLancamento",
34
"value": "19/06/2020"
35
}
36
]
37
}
38
}'
Copied!