O produto variável é aquele onde há um agrupamento de dois ou mais SKUs tendo um atributo diferenciador para distingui-los. Nesta seção temos a estrutura para a criação desse tipo de produto
Produto variável é aquele em que um ou mais SKUs são agrupados; estes SKUs serão diferenciados através de atributos específicos, como tamanho ou cor, por exemplo.
Mesmo para produtos variáveis é necessário haver atributos e informações que fortaleçam a identidade do item, como um título claro e características bem definidas em sua ficha técnica. Acompanhe o exemplo abaixo:
Quando tratamos uma camiseta é necessário fornecer uma breve descrição de suas características dentro do título, a fim de chamar a atenção de um potencial cliente (por exemplo, Título: Camiseta Branca Lisa). Além disso, também faz-se necessário incluir atributos de ficha técnica, como material, fabricante, marca, dentre outros para enriquecer o cadastro do item quando anunciado.
Esses atributos de ficha técnica favorecem a localização do produto na realização de filtros nos sites de e-commerce e o título destaca a escolha do cliente final ao realizar as buscas.
Mas não é só isso, existem vários outros requisitos necessários para a integração com o marketplace, como o correto preenchimento do peso, dimensões, status e indexação de imagens.
A seção Integração: Produto desta documentação é capaz de fornecer maiores detalhes sobre os pré-requisitos necessários para a integração de produtos com o marketplace
A seguir confira a estrutura esperada para a criação de um produto variável via API.
Estrutura do JSON
A estrutura básica para a criação de um produto variável contém campos que devem ser preenchidos com os formatos de dados determinados pela API.
A seguir são apresentados os campos que constituem a estrutura de um produto variável e o formato a ser utilizado para inclusão dos dados. A não utilização dos formatos corretos para preenchimento dos dados pode acarretar em reprova proveniente do marketplace, impossibilitando a publicação da oferta.
Para realizar o cadastro de um produto variável via API deverá ser utilizado o método POST para o seguinte endpoint:
https://api.skyhub.com.br/products
Request headers:
Key
Value
X-User-Email
email_de_usuario
X-Api-Key
token_de_integracao de sua conta SkyHub
X-Accountmanager-key
token_account único de cada Plataforma/ERP
Accept
application/json
Content-Type
application/json
A diferença para o JSON do produto simples é que no cadastro da variação é informado o array variations com as informações dos SKUs agrupados, seus atributos diferenciadores e outras especificações.
Todo produto variável deve contar com o array variation_attributes, onde deverão ser informados os atributos responsáveis pela diferenciação das variações.
Por exemplo, ao cadastrar uma camiseta e preencher para os SKUs filhos - aqueles vinculados a um SKU agrupador/pai - o atributo "Tamanho" para diferenciar uma variação da outra, é esperado que o mesmo atributo ("Tamanho") seja informado no array variation_attributes.
Request body:
{
"product": {
"sku": "CodigoSKU_agrupador",
"name": "Título",
"description": "Descrição detalhada do produto criado",
"status": "enabled", // Status (ativo/enabled ou inativo/disabled)
"price": 0.0, // Preço
"promotional_price": 0.0, // Preço promocional
"cost": 0, // Custo do produto para o seller
"weight": 0, // Peso
"height": 0, // Altura
"width": 0, // Largura
"length": 0, // Comprimento
"brand": "Marca",
"nbm": "NBM/NCM",
"images": [
""
],
"specifications": [ // Objeto responsável pela inclusão de atributos
{
"key": "Atributo",
"value": "Valor do atributo"
}
],
"variations": [
{
"sku": "CodigoSKU_variacao",
"qty": 0, // Estoque
"ean": "EAN (European Article Number ou Numeração Europeia de Artigos, o código de barras do item)",
"images": [
"https:// URL da imagem" // Imagem da variação
],
"specifications": [ // Objeto responsável pela inclusão de atributos
{
"key": "Atributo",
"value": "Valor do atributo"
},
{
"key": "Atributo",
"value": "Valor do atributo"
},
{
"key": "price",
"value": "0.0" // Preço da variação
},
{
"key": "promotional_price",
"value": "0.0" // Preço promocional da variação
}
]
}
],
"variation_attributes": [ // Objeto responsável pela inclusão do atributo diferenciador
"Atributo_diferenciador_1",
"Atributo_diferenciador_2"
]
}
}
Há um limite de 100 variações que podem ser inclusas na estrutura de um produto, sendo necessário respeitar tal limitação para não haverem reprovas ao encaminhar o SKU variável para a API.
Example request:
Veja abaixo o JSON de criação de um produto com variações, sendo o SKU P2022 o ID do produto "pai" e os SKUs F2023 e F2024 os IDs das variações:
