# product
Esse objeto trás todas as informações do produto atual.
{% hint style="warning" %}
**Disponível para uso nas páginas:** product | snippets/product
{% endhint %}
{% hint style="info" %}
**Para saber mais sobre como gerenciar produtos acesse:** [Cadastrar Produto](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6732451110171-Cadastrar-Produto)
{% endhint %}
### Atributos disponíveis
| Atributos | Característica | | | |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| `{{ product.id }}` | Identificador único do produto. | | | |
| `{{ product.slug }}` | Exibe uma string que corresponde ao trecho de URL que indica o acesso ao produto entre categorias. | | | |
| `{{ product.name }}` | Nome do produto. | | | |
| `{{ product.category_id }}` | Exibe o identificador único da categoria principal do produto. | | | |
| `{{ product.modified }}` | Retorna a data e hora da última modificação do produto. | | | |
| `{{ product.is_kit }}` | Retorna um valor booleano caso o produto seja um [Kit de Produtos.](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6732738080923-Kit-de-Produtos) Se o valor for **1** é um kit. | | | |
| `{{ product.brand_id }}` | Retorna o número de ID "identificador único" da marca do produto. | | | |
| `{{ product.price }}` | Preço de venda do produto. | | | |
| `{{ product.price_offer }}` | Preço do produto em promoção. | | | |
| `{{ product.ProgressiveDiscounts }}` | Retorna um Array com as informações sobre o desconto progressivo, os itens retornados são: `name` \| `description` \| `tag` | | | |
| `{{ product.percentage_discount }}` | Retorna o valor numérico da porcentagem de desconto no preço do produto. | | | |
| `{{ product.cost_price }}` | Retorna o preço de custo do produto. | | | |
| `{{ product.ipi }}` | Retorna o percentual cadastrado para o [imposto IPI](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6733009758619-Impostos-do-Produtos-IPI-e-NCM) do produto. | | | |
| `{{ product.show_price }}` | Retorna 1 caso as informações de preço devam ser exibidas. | | | |
| `{{ product.has_other_prices }}` | Retorna se o produto possui outros preços, ou seja, se possui variações com preços de venda diferentes. | | | |
| `{{ product.payment }}` | Retorna até 3 opões de parcelamento do produto definidos no campo "Exibir preço parcelado junto do preço do produto". | | | |
| `{{ product.payment_option_details }}` | Retorna um Array com todas as informações das formas de pagamento, os índices retornados são: `display_name` \| `plots` \| `value` \| `type` \| `tax` | | | |
| `{{ product.link }}` | Link para a página do produto, que pode ser usado no `href` da tag `a`. | | | |
| `{{ product.upon_request }}` | Retorna se o produto está com o campo "Marcar produto sob consulta" ativo. | | | |
| `{{ product.available }}` | Retorna um valor booleano. Caso o produto esteja desativado para venda exibe o valor **1**. Opção "Produto ativo - será exibido na loja para venda" desmarcado. | | | |
| `{{ product.availability_days }}` | Retorna o número de dias configurado no [Prazo de disponibilidade](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6735743602203-Prazo-de-Disponibilidade-para-Produtos) do produto. | | | |
| `{{ product.stock }}` | Retorna a quantidade de produtos em estoque. | | | |
| `{{ product.featured }}` | Retorna verdadeiro se o produto tiver o selo destaque. Opção "Exibir selo destaque no produto" marcada. | | | |
| `{{ product.new }}` | Retorna verdadeiro se o produto tiver o selo lançamento. Opção "Exibir selo lançamento no produto" marcada. | | | |
| `{{ product.free_shipping }}` | Retorna verdadeiro se o produto possuir [frete grátis. ](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6733332814235-Op%C3%A7%C3%B5es-Avan%C3%A7adas-do-Produto-Frete-Gr%C3%A1tis-ou-Bloqueio-de-Frete-Por-Produto-) | | | |
| `{{ product.additional_button }}` | Retorna verdadeiro se o produto tiver o selo adicional. Opção "Exibir selo adicional no produto" marcada. | | | |
| `{{ product.availability }}` | Informação de disponibilidade do produto. Configurada no campo "Prazo de disponibilidade". | | | |
| `{{ product.ranking }}` | Retorna um Array com informações da avaliação do produto, os índices retornados são: `count` \| `rating` | | | |
| `{{ product.ean }}` | Exibe o código de barras do produto, configurado no campo "Código EAN/GTIN/UPC". | | | |
| `{{ product.description }}` | Exibe a descrição completa do produto, configurada no campo "Descrição". | | | |
| `{{ product.description_small }}` | Exibe uma descrição [simplificada do produto.](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/7114185489691-SEO-Otimiza%C3%A7%C3%A3o-de-Busca-por-Produto) | | | |
| `{{ product.start_promotion }}` | Exibe a data de início da promoção do produto, configurado no campo "Período da promoção". | | | |
| `{{ product.end_promotion }}` | Exibe a data de término da promoção do produto, configurado no campo "Período da promoção". | | | |
| `{{ product.release_date }}` | Retorna a data de lançamento do produto | | | |
| `{{ product.brand }}` | Exibe a marca do produto, configurada no campo "Marca". | | | |
| `{{ product.model }}` | Exibe o modelo do produto, configurada no campo "Modelo". | | | |
| `{{ product.weight }}` | Exibe o peso do produto em gramas, configurado no campo "Peso". | | | |
| `{{ product.cubic_weight }}` | Retorna o peso cúbico do produto. | | | |
| `{{ product.length }}` | Exibe o comprimento do produto em centímetros, configurado no campo "Comprimento". | | | |
| `{{ product.width }}` | Exibe a largura do produto em centímetros, configurada no campo "Largura". | | | |
| `{{ product.height }}` | Exibe a altura do produto em centímetros, configurada no campo "Altura". | | | |
| `{{ product.reference }}` | Exibe o código de referência do produto, configurada no campo "Referência". | | | |
| `{{ product.has_acceptance_terms }}` | Retorna verdadeiro se o produto possuir
termos de aceite.
| | | |
| `{{ product.additional_message }}` | Exibe a mensagem adicional do produto, configurada no campo "Mensagem adicional". | | | |
| `{{ product.warranty }}` | Exibe o texto a respeito da garantia do produto, configurada no campo "Tempo de garantia". | | | |
| `{{ product.warranty_days }}` | Retorna o número de dias configurado para garantia do produto. | | | |
| `{{ product.quantity_sold }}` | Exibe a quantidade produtos vendidos. | | | |
| `{{ product.related_categories }}` | Retorna um Array com o ID das categorias relacionadas ao produto. | | | |
| `{{ product.virtual_product }}` | Retorna verdadeiro se o produto for virtual. Opção "Este produto não requer o envio físico (serviços ou bens digitais - produto virtual)" marcada. | | | |
| `{{ product.video }}` | Exibe a URL do vídeo inserido no produto, configurado no campo "Endereço do video (url)". | | | |
| `{{ product.related_products }}` | Array dos [produtos relacionados](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6734047244827-Produtos-Relacionados) que retorna outro array contendo as informações dos produtos. | | | |
| `{{ product.compared_product }}` | Retorna verdadeiro se o produto estiver na comparação de produtos, e caso a opção "[Habilitar Função para comparar produtos](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6734323229851-Configura%C3%A7%C3%B5es-de-Produto)" esteja marcada. | | | |
| `{{ product.included_items }}` | Itens inclusos na compra do produto, configurado no campo "Itens inclusos". | | | |
| `{{ product.has_variation }}` | Retorna um valor booleano "**1**" verdadeiro caso o produto contenha variações**.** | | | |
| `{{ product.variants }}` | Retorna um array contendo diversos arrays um dentro do outro que levam ao tipo de variações, suas características e todas suas informações com os seguintes índices retornados: `id` \| `ean` \| `product_id` \| `price` \| `stock` \| `minimum_stock` \| `reference` \| `weight` \| `length` \| `width` \| `height` \| `start_promotion` \| `end_promotion` \|`price_offer` \| `payment_option` \| `illustrative_image` \| `images` \| `payment_option_details` | | | |
| `{{ product.additional_information }}` | Exibe o campo de [informação adicional](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6733639256091-Informa%C3%A7%C3%B5es-Adicionais-de-Produtos) (máximo de 256 caracteres) cadastrado para o produto. | | | |
| `{{ productTabs }}` | Retorna um array com as abas da página do produto, que contem outro array com informações com os seguintes índices: id | container\_id | description | url
Para saber mais acesse/pages/KnCEoTGvfBtLwKZqG2NO
|
### Atributo `product.images`
Este atributo retorna um array com informações sobre as imagens cadastradas no produto, que pode ser usado somente na página do produto. É possível manipular o tamanho da imagem para uso em Thumbnails por exemplo, com os atributos da tabela abaixo:
| Atributos disponíveis do "product.images" | Características e Exemplo de uso |
|---|
small | Exibe a imagem do produto nas dimensões de 30x30px. Exemplo de código: {% set images = product.images %}
<img src="{{ images[0].small }}" alt="">
|
medium | Exibe a imagem do produto nas dimensões de 90x90px. Exemplo de código: {% set images = product.images %}
<img src="{{ images[0].medium }}" alt="">
|
large | Exibe a imagem do produto nas dimensões de 180x180px. Exemplo de código: {% set images = product.images %}
<img src="{{ images[0].large }}" alt="">
|
full | Exibe a imagem do produto no tamanho original dela. Exemplo de código: {% set images = product.images %}
<img src="{{ images[0].full }}" alt="">
|
### Como Usar
No código HTML o objeto `product` pode ser usado como no formato abaixo:
{% code title="Input" %}
```html
Codigo do produto: {{ product.id }}
{{ product.name }}
{{ product.brand }}
{% if product.featured %}
Produto em destaque!
{% endif %}
{% if product.price_offer > 0 and product.show_price %}
Esse produto está em promoção!
{% endif %}
{% if product.price > 0 and product.show_price %}
De: R${{ product.price|currency }}
por: R${{ product.price_offer|currency }}
{% endif %}
{{ product.payment }}
{% set ranking = product.ranking %}
{% if ranking %}
Quantidade de avaliações: {{ ranking.count }}
Nota do produto: {{ ranking.rating }}
{% endif %}
{{ product.description }}
```
{% endcode %}
{% code title="Output" %}
```html
Codigo do produto: 1
Camiseta Branca
Marca X
Produto em destaque!
Esse produto está em promoção!
De: R$ 50,00
por: R$ 24,90
ou 3x de R$ 10,00 com juros
Quantidade de avaliações: 150
Nota do produto: 5
Camiseta básica para o dia a dia!
```
{% endcode %}
## Helpers do `product`
Para simplificar o uso de lógica com o objeto `product` também é possível utilizar seus **helpers**, que geram um determinado conteúdo com as informações do produto em um bloco já definido e pré-moldado, pronto para ser utilizado somente fazendo a chamada do **Helper** no código HTML.
### Atributos disponíveis
| Atributos | Característica | | |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------------------ |
| `{{ productHelper.banner() }}` | Exibe a imagem da [Promoção em lote](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6743670265883-Promo%C3%A7%C3%B5es-em-Lote) atrelada ao produto ou somente o nome da promoção, caso não haja imagem cadastrada. | | |
| `{{ productHelper.gallery() }}` | Exibe uma galeria com todas as imagens e vídeo cadastrados no produto. Em que a imagem exibida no momento aparece maior e em tamanho menor as thumbnails para visualizar as outras imagens e vídeo do produto. | | |
| `{{ productHelper.social() }}` | Exibe o bloco de [redes sociais](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6742808616475-Redes-Sociais-Configura%C3%A7%C3%A3o) padrão da plataforma para que o produto seja compartilhado nas redes. | | |
| `{{ productHelper.labels() }}` | Exibe os selos que rotulam o produto (destaque, frete grátis, lançamento, entre outros). | | |
| `{{ productHelper.details() }}` | Exibe algumas informações de detalhe do produto (marca, modelo, referência e data de lançamento). | | |
| `{{ productHelper.icons('top') }}` | Exibe as características do produto em
formato de ícone, as posições disponíveis são: top | right | bottom
|
| `{{ productHelper.bonus() }}` | Exibe a quantidade de pontos do [Programa de Fidelidade](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6743361546011-Programa-de-Fidelidade) que o cliente ganha ao comprar o produto. | | |
| `{{ productHelper.variants() }}` | Exibe um bloco com as [variações do produto ](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6734317515291-Varia%C3%A7%C3%B5es-Inclus%C3%A3o-e-Configura%C3%A7%C3%A3o)que possibilita a escolha da variação desejada para compra. | | |
| `{{ productHelper.form() }}` | Exibe um input que permite inserir a Quantidade de produtos e o botão Comprar. | | |
| `{{ productHelper.shipping() }}` | Exibe o input com o botão para cálculo de Frete. | | |
| `{{ productHelper.pricing() }}` | Exibe informações de preço, detalhes e [formas de pagamento](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6733115439259-Formas-de-Pagamento-Espec%C3%ADficas-por-Produto) (o conteúdo muda de acordo com algumas configurações do Painel Administrativo). | | |
| `{{ productHelper.bundle() }}` | Exibe um bloco de [Compre Junto](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6736176265243-Configurando-o-Compre-Junto) com sugestão de outros produtos que podem ser comprados com o produto atual (este bloco só é exibido se **todos os produtos possuírem estoque**). | | |
| `{{ productHelper.gifts() }}` | Exibe a seleção dos [Brindes](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6733742549147-Brinde-por-Produtos) disponíveis para o produto, se o mesmo estiver configurado. | | |
| `{{ productHelper.wishlist() }}` | Exibe o botão ou a lista de seleção para adicionar o produto a [lista de presente e casamento.](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6742957789595-Listas-de-Casamento-Presente-Desejo-) | | |
### Como Usar os Helpers
###
O código HTML abaixo mostra a galeria de imagens do produto atual em exibição.
```twig
{{ productHelper.gallery() }}
```
## Exemplo de uso do Objeto e Helper `product`
O código HTML abaixo pode ser utilizado na pasta **elements/snippets** para exibição do produto na vitrine.
{% code title="Input" %}
```html
```
{% endcode %}
{% code title="Output" %}
```html
```
{% endcode %}
### Exemplo do uso do atributo product.video
<!--Renderização condicional caso exista vídeo -->
{% if product.video %}
<!-- CSS -->
<style>
/* Estilizando o widget */
#youtube-widget {
position: fixed;
bottom: 20px;
left: 20px;
width: 100px;
height: 100px;
z-index: 1000;
border-radius: 50px;
overflow: hidden;
transition: transform 0.3s ease;
box-shadow: 0 2px 10px rgba(0,0,0,0.3);
}
/* Deixa o vídeo caber dentro do widget */
#youtube-widget iframe {
width: 100%;
height: 100%;
border: none;
}
</style>
<!-- Estrutura do HTML -->
<div id="youtube-widget">
<iframe
src="{{ product.video }}?autoplay=1&mute=1"
allow="autoplay; encrypted-media"
allowfullscreen>
</iframe>
</div>
{% endif %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://partners.tray.com.br/themes/construindo-seu-template/referencias/objetos/product.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
{% else %}
 }} "{{ product.name }}")
{% endif %}
{% else %}
 }} "{{ product.name }}")
{% endif %}
{{ productHelper.banner() }}
{% if settings.discount %}
{% set porcentagemDesconto = 100 - ( product.price_offer / product.price ) * 100 %}
{% if porcentagemDesconto < 100 %}
{{ porcentagemDesconto|number_format }}% de desconto
{% endif %}
{% endif %}
