Produto Agrupado por Variantes

Para inserir um produto que possui diversas combinações de atributos utilizando o agrupamento por produto variante é necessário preencher corretamente o campo idPaiExterno. Esse será o campo chave para identificar se um produto deve ser cadastrado como um produto inteiramente novo ou como um produto que representa uma variação de um produto já existente na plataforma.

Digamos que seja necessário inserir um produto como o do exemplo abaixo com várias opções de cores e grau. Para cada uma das variações seria necessário realizar um POST no endpoint /produtos. Para que os produtos sejam agrupados corretamente seria necessário enviar em todos o mesmo valor no campo idPaiExterno.
Outra forma seria inserir o primeiro produto sem preencher o campo idPaiExterno, internamente a Api Fbits irá preencher o campo com o valor enviado no sku. E para os produtos seguintes bastaria enviar o sku do primeiro produto no campo idPaiExterno.

Abaixo um exemplo de como pode ser feita a apresentação de um produto com diversas variações:

O produto acima possui várias combinações possíveis quando observadas as opções de cores e de grau. Para cada uma das combinações existe um produto variante. Abaixo algumas das opções para cada um desses atributos:

Para cadastrar o produto dessa forma, permitindo que seja possível para o usuário comprar um item da cor azul em qualquer um dos graus apresentados é necessário realizar uma chamada para o endpoint /produtos para cada combinação. Isso significa inserir um produto que possui em sua lista de atributos a cor azul e o grau -8.00, outro produto a cor azul e grau o -7.50, e assim por diante até que fossem inseridos todos os graus disponíveis para a cor azul. Em seguida o mesmo teria que ser feito para a cor cinza, verde, etc. Sempre utilizando o mesmo valor no campo idPaiExterno, até que todas as combinações tenham sido inseridas.

Em resumo, sempre que é inserido um produto com um idPaiExterno único ou vazio está sendo cadastrado um novo produto e quando se realiza a mesma operação enviando este campo preenchido com um valor já vinculado a um produto existente, está sendo cadastrada uma variação de produto ou Produto Variante.

Apenas o produto é exibido na página de busca ou de categorias da loja. Então mesmo que um produto possua inúmeros variantes será exibido apenas um item, como no exemplo abaixo: