Atributo de Produtos

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:

https://api.skyhub.com.br/attributes

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:

https://api.skyhub.com.br/attributes

As informações a serem enviadas, precisam estar no Body (Corpo) da requisição da seguinte forma:

{
"attribute": {
"name": "att_name",
"label": "Atributo Exemplo",
"options": [
"foo",
"foo",
"foo"
]
}
}

Para atualizar um determinado produto que foi criado na SkyHub, você deve usar o método PUT através do Endpoint:

https://api.skyhub.com.br/attributes/{nome_atributo}

As informações a serem atualizadas precisam estar no Body da requisição da seguinte forma:

{
"attribute": {
"label": "Atributo Exemplo",
"options": [
"azul",
"azul",
"azul"
]
}
}

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:

https://api.skyhub.com.br/product

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 e horário seguindo o seguinte padrão "DD/MM/AAAA HH:MM:SS", segue abaixo cURL de exemplo:

curl --location --request POST 'https://api.skyhub.com.br/products' \
--header 'X-User-Email: seuemail@dominio.com' \
--header 'x-Api-Key: xxxxxxxxxxxxx' \
--header 'x-accountmanager-key: xxxxxxxxxxxxx' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"product": {
"sku": "001",
"name": "PRODUTO PRE-VENDA",
"description": "PRODUTO PRE-VENDA",
"status": "enabled",
"qty": 0,
"price": 100,
"promotional_price": 89.99,
"cost": 49.00,
"weight": 3,
"height": 1,
"width": 1,
"length": 1,
"brand": "SKYHUB",
"ean": "",
"nbm": "",
"categories": [
{
"code": "01",
"name": "skyhub homologação"
}
],
"images": [""],
"specifications": [
{
"key": "dataLancamento",
"value": "19/06/2020 01:00:00"
}
]
}
}'

No link https://api-docs.skyhub.com.br/#/attributes Você encontrará a requisição pronta, necessitando apenas alterar os dados que deseja enviar para a Skyhub ; )