variant

Atributos do objeto variant

O objeto {{ variant }} é usado no atributo variants do product para exibir informações das variantes de um produto. Confira na tabela a seguir os atributos desse objeto:

Atributos
availableRetorna true se a variante está disponível. Retorna false se a variante não está disponível.
available_quantityRetorna o número de unidades da variante disponíveis para compra.
barcodeRetorna o código de barras da variante.
full_nameRetorna o nome do produto.
handling_daysRetorna o número de dias de manuseio da variante. Útil para produtos feitos sob encomenda.
heightRetorna a altura da unidade, em centímetros.
idRetorna o ID da variante.
image_urlRetorna a URL da primeira imagem de produto relacionada à variante.
installmentsRetona um array com as opções de parcelamento da variante. O array contém:
- Quantidade de parcelas (number);
- Preço de cada parcela (price);
- Se há juros no parcelamento (interest) e a porcentagem de juros (interest_rate);
- Valor total do produto se pago com esse número de parcelas (total).
intl_priceRetorna o preço internacional.
inventoriesRetorna os locais cadastrados como centro de distribuição para essa variante.
lengthRetorna o comprimento da unidade, em centímetros.
mainRetorna true se for a variante principal do produto. Retorna false se não for a variante principal.
min_quantityRetorna a quantidade mínima da variante que deve ser adicionada ao carrinho.
nameRetorna o nome da variante. Geralmente usada para exibir a descrição legível da variação do produto.
priceRetorna o preço da variante.
product_idRetorna o código identificador (ID) do produto.
propertiesRetorna um array com as propriedades da variante. Uma variante possui até três propriedades, e cada propriedade pode ter um nome (fixo) e um valor (variável).
Veja no exemplo seguinte e uso desse atributo.
quantityRetorna a quantidade da variante em estoque.
quantity_soldRetorna a quantidade vendida da variante.
sale_priceRetorna o preço promocional da variante.
skuRetorna o código SKU da variante, que deve ser enviado no formulário de produto.
sku_lowercaseRetorna o código SKU da variante em letras minúsculas.
stockRetorna o estoque do produto.
weightRetorna a massa da unidade em gramas.
widthRetorna a largura da unidade, em centímetros.

Exemplo de properties

Exemplo de variantes com variação de Cor, Tamanho e Material:

<h1>{{ product.name }}</h1>

{% for variant in product.variants %}
  <p>{{ variant.name }}:</p>
  
  <ul>
    <li>{{ variant.properties.property1.name }}: {{ variant.properties.property1.value }}</li>
    <li>{{ variant.properties.property2.name }}: {{ variant.properties.property2.value }}</li>
    <li>{{ variant.properties.property3.name }}: {{ variant.properties.property3.value }}</li>
  </ul>
{% endfor %}
<h1>Camiseta Verão</h1>

<p>Tamanho P / Cor Amarela</p>

<ul>
  <li>Tamanho: P</li>
  <li>Cor: Amarelo</li>
  <li>Material: Algodão</li>
</ul>

<p>Tamanho M / Cor Amarela</p>

<ul>
  <li>Tamanho: M</li>
  <li>Cor: Amarelo</li>
  <li>Material: Algodão</li>
</ul>
  
<p>Tamanho G / Cor Laranja</p>

<ul>
  <li>Tamanho: G</li>
  <li>Cor: Laranja</li>
  <li>Material: Algodão</li>
</ul>

📘

Saiba mais sobre as variantes de um produto no artigo Referências e SKU.