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.

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 ; )