item

Como utilizar o objeto item

O objeto {{ item }} é usado no atributo items do cart para renderizar itens adicionados ao carrinho de compras.

<div>
  {% cartitems %}
    <div>
      <a href="{{ item.product_url }}">
        <img src="{{ item.image_url | resize: '250x' }}" alt="{{ product.name }}" />
      </a>
      
      <p>
        <a href="{{ item.product_url }}">
          {{ item.product_name }}
        </a><br />
        {{ item.variant_name }} / {{ item.variant_sku }}<br />
        {{ item.price | money_format }}
      </p>
    
    </div>
  {% endcartitems %}
</div>

Confira os atributos do objeto item na tabela a seguir:

AtributosFunção
available_quantityRetorna a quantidade de itens disponíveis na loja. Útil para delimitar quantos itens poderão ser adicionados no carrinho.
delivery_daysRetorna o prazo de entrega do item.
extraRetorna uma lista com os atributos personalizados do produto, se houver.
has_customizationsRetorna true se o item possui personalização, e false se o item não possui personalização.
idRetorna o ID do item do carrinho (diferente do ID do produto).
image_urlRetorna a URL da imagem da variante adicionada ao carrinho. Se a variante adicionada ao carrinho não possuir uma imagem relacionada, retorna a imagem do produto.
place_idCódigo identificador do local de venda.
priceRetorna o preço unitário do produto.
product_idRetorna o ID do produto.
product_nameRetorna o nome do produto.
product_referenceRetorna a referência do produto.
product_typeRetorna o tipo do produto.
product_urlRetorna a URL da página do produto.
quantityRetorna a quantidade desse item adicionada ao carrinho.
sellerRetornar a loja responsável pela venda, em caso de vendas via marketplace.
seller_nameRetorna o nome da loja que fará o envio do produto, em casos de venda via marketplace.
subtotalRetorna o subtotal do item (valor da unidade multiplicado pela quantidade de itens).
totalRetorna o valor total do item (valor da unidade multiplicado pela quantidade de itens, incluindo descontos promocionais).
updated_atRetorna a data e horário da última atualização do item. O formato de retorno dos dados é o ISO 8601.

A exibição desse atributo pode ser controlada através do filtro date.
variant_attributesRetorna os atributos da variante.
variant_min_quantityRetorna a quantidade mínima da variante que deve ser adicionada ao carrinho.
variant_nameRetorna o nome da variante adicionada ao carrinho.
variant_intl_priceRetorna o preço internacional da variante.
variant_priceRetorna o preço unitário da variante adicionada ao carrinho.
variant_propertiesRetorna um objeto com as propriedades da variante:

- variant_properties.property1
- variant_properties.property2
- variant_properties.property3

Cada propriedade da variante possui três informações:

- name: o nome da propriedade (ex. “Tamanho”, “Cor”);
- value: o valor da propriedade (ex. “G”, “Amarelo”);
- defining: retorna true se a variante possui uma definição ou false se a variante não possui.
variant_skuRetorna o código identificador SKU da variante adicionada ao carrinho.

📘

Saiba mais sobre os conceitos de variante e produto no artigo Referências e SKU.