Produto Variável
O produto variável é aquele onde há um agrupamento de dois ou mais SKU's tendo um atributo diferenciador para distingui-los. Exemplo: Lava Louças 110v ou 220v, Suplemento de morango ou chocolate e etc
Além da observância de todos os cuidados nos detalhes das informações como vimos anteriormente no produto simples, o produto variável deve ter a estrutura exatamente conforme apresentaremos a seguir, evitando inconsistências e até prejuízos.
Em um livro por exemplo, é necessário fornecendo o nome completo da obra, além de atributos de ficha técnica como tipo de capa, idioma, quantidade de páginas e outros para enriquecer o produto 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 na integração conforme o tópico a seguir.

Estrutura

A seguir veja a estrutura de um produto, considerando o Json, formato utilizado na Skyhub para a manipulação de informações.

Pré-Requisitos

Seguir um padrão no cadastro de produtos é uma prática muito importante, então listamos alguns desses requisitos para uma integração bem sucedida nos marketplaces.
  1. 1.
    Campos obrigatórios na API: O campo SKU, título (name), descrição (description), dimensões (height, width e length) e peso (weight) são obrigatórios na API, o não envio desses atributos implicará em retorno de erro na API, contudo, é imprescindível a observância dos demais requisitos para sucesso na integração com os marketplaces.
  2. 2.
    Utilize um padrão para a criação dos códigos SKUs: - Utilize uma sequência numérica ou alfanumérica; - Certifique-se que o SKU não possua espaços em branco, normalmente oriundos de cópia direta de editores como Excel e outros. - Não utilize caracteres especiais como barra (/), asterisco (*), vírgula (,) porcentagem (%) e outros ($, #, (, ), @, !, ¨); - Nunca repita um SKU em outro produto, mesmo que seja de produtos excluídos e mesmo entre produtos simples e variáveis; - Utilize sempre SKUs exclusivos em todos os produtos;
  3. 3.
    Informe sempre o peso do produto: - Utilize sempre a unidade de medida em quilograma (Kg), por exemplo, 3.0 para três quilos;
  4. 4.
    Informe sempre as dimensões do produto: - Utilize sempre a unidade de medida em centímetros (Cm), por exemplo, 20.0 para vinte centímetros.
  5. 5.
    Informe ao menos uma imagem por produto: - Um produto sem imagem não pode ser anunciado, portanto, é necessário que seja enviado ao menos uma imagem no produto simples.
  6. 6.
    Consulte nossa central de ajuda para mais informações: Você encontrará muito mais em nosso “Guia de Melhores práticas para Cadastro de produtos”, clique aqui

Cabeçalho das requisições

Para realizar qualquer tipo de requisição, você sempre deverá preencher o Header, com as informações geradas por nós da Skyhub, considerando o modelo abaixo:
1
X-User-Email: [email protected]
2
x-Api-Key: XXXXXXXXX
3
x-accountmanager-key: XXXXXXXXXX
4
Accept: application/json;charset=UTF-8
5
Content-Type: application/json
Copied!

POST - Cadastrando um produto variável

Para cadastrar um produto variável via API, você deverá utilizar o método POST direcionando sua requisição para o nosso endpoint
1
https://api.skyhub.com.br/products
Copied!
A diferença para o JSON do produto simples é que no cadastro da variação é informado o array variations com as informações os skus agrupados, seus atributos diferenciadores e outras especificações.
Veja abaixo o JSON de criação de um produto com variações, sendo o SKU P20 o ID do produto "pai" e o SKU F21 o ID da variação:
1
{
2
"product": {
3
"sku": "P20",
4
"name": "DESCRICAO PRODUTO",
5
"description": "CRIAR PRODUTO COM UMA VARIAÇÃO",
6
"status": "enabled",
7
"price": 30.00,
8
"promotional_price": 25.00,
9
"cost": 0.0,
10
"weight": 0.100,
11
"height": 20,
12
"width": 30,
13
"length": 20,
14
"brand": "Marca",
15
"nbm": "98769898",
16
"categories": [
17
{
18
"code": "01",
19
"name": "SKYHUB HOMOLOGAÇÃO"
20
}
21
],
22
"images": [
23
"http://d26lpennugtm8s.cloudfront.net/stores/154/284/products/camiseta-lisa-verde-bandeira-algodo-p-ao-gg-pronta-entrega-355901-mlb20431777049_092015-o-07fadec89e5ed54705c1b9ab5411dec8-1024-1024.jpg"
24
],
25
"specifications": [
26
{
27
"key": "Especicações do Produto PAI",
28
"value": "Especificações do Produto PAI"
29
},
30
{
31
"key": "crossdocking",
32
"value": "4"
33
}
34
],
35
"variations": [
36
{
37
"sku": "F21",
38
"qty": 10,
39
"ean": "9876543210987",
40
"images": [
41
"http://d26lpennugtm8s.cloudfront.net/stores/154/284/products/camiseta-lisa-verde-bandeira-algodo-p-ao-gg-pronta-entrega-355901-mlb20431777049_092015-o-07fadec89e5ed54705c1b9ab5411dec8-1024-1024.jpg"
42
],
43
"specifications": [
44
{
45
"key": "Cor",
46
"value": "Verde"
47
},
48
{
49
"key": "Tamanho",
50
"value": "M"
51
},
52
{
53
"key": "price",
54
"value": "50.00"
55
},
56
{
57
"key": "promotional_price",
58
"value": "40.00"
59
}
60
]
61
}
62
],
63
"variation_attributes": [
64
"Cor",
65
"Tamanho"
66
]
67
}
68
}
Copied!