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 ela terá de aparecer no filtro de categorias.

Temos alguns exemplos de atributos que são obrigatórios no marketplace(MKTP) por categoria, tais como:

Voltagem – Para categoria de eletrodomésticos
Cor – Para categoria de Moda
Tamanho – Para categoria de Moda
Sabor – Para categoria de Esporte e Nutrição

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 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 tem disponível para venda.

Agora que você compreende a importância dessas informações, vamos a pratica! Como a integração faz o envio desses dados para a Skyhub? Os campos disponíveis no endpoint https://api.skyhub.com.br/attributes e os seus tipos são:


A integração precisará utilizar o método POST(Criar) através do seguinte endpoint:

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

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

Para atualizar um determinado produto que foi criado na Skyhub, você deve usar o método PUT(Atualizar) através do seguinte endpoint:

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

As informações a serem atualizadas precisam estar no corpo (BODY) da requisição da seguinte forma:


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, validando se o atributo já existe e caso ele não exista a Skyhub trata-se de criar o mesmo.

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:

Obs: Na tela abaixo, o Campo Label é o campo Label [exibido] na API. Já o Campo Código, é o campo Name 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 (Criar) e o endpoint https://api.skyhub.com.br/product com o seguinte BODY (Corpo) abaixo:



Obs: O campo a ser inserido no array de specifications, é o valor da coluna código (aquele que demonstramos na tela de atributos da Skyhub). Via Api, esse campo chama – se NAME.

No link https://skyhub.gelato.io/api-explorer/skyhub-api/versions/1.0// Você encontrará a requisição pronta, necessitando apenas alterar os dados nos quais deseja enviar para a Skyhub ; )