> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Artigos da encomenda nos modelos

> Percorra os artigos de uma encomenda em Liquid e imprima os títulos, quantidades, preços, SKU, imagens, pesos e propriedades.

Os artigos de uma encomenda estão em `line_items`. Para os imprimir, percorra a lista com um ciclo: tudo o que estiver entre `{% for line_item in line_items %}` e `{% endfor %}` repete-se uma vez por artigo, e `line_item` é o artigo atual. Os campos dos artigos só funcionam dentro do ciclo.

## Uma tabela de artigos simples

```liquid theme={null}
<table>
  {% for line_item in line_items %}
    <tr>
      <td>{{ line_item.title }}</td>
      <td>{{ line_item.sku }}</td>
      <td>{{ line_item.quantity }}</td>
      <td>{{ line_item.price | money }}</td>
      <td>{{ line_item.line_price | money }}</td>
    </tr>
  {% endfor %}
</table>
```

## Campos dos artigos

| Variável | O que imprime |
| - | - |
| `line_item.title` | O título do artigo (produto e variante) |
| `line_item.name` | O nome do artigo |
| `line_item.product_title` | O título do produto |
| `line_item.variant_title` | O título da variante, como "Azul / Grande" |
| `line_item.quantity` | A quantidade encomendada, incluindo os artigos reembolsados |
| `line_item.fulfillable_quantity` | Quantos falta processar |
| `line_item.refunded_quantity` | Quantos foram reembolsados |
| `line_item.sku` | O SKU |
| `line_item.vendor` | O fornecedor |
| `line_item.price` | O preço unitário, após os descontos da linha (cêntimos) |
| `line_item.original_price` | O preço unitário antes dos descontos (cêntimos) |
| `line_item.line_price` | O total da linha: preço unitário × quantidade, após os descontos da linha (cêntimos) |
| `line_item.total_discount` | O desconto da linha (cêntimos) |
| `line_item.discount_per_item` | O desconto por artigo (cêntimos) |
| `line_item.total_tax` | O imposto da linha (cêntimos) |
| `line_item.cost` | O custo do artigo, para notas de encomenda (cêntimos) |
| `line_item.tax_lines` | Os impostos da linha: percorra-os para obter `title`, `rate`, `price` |
| `line_item.discount_allocations` | Os descontos aplicados à linha: percorra-os para obter `amount` |
| `line_item.properties` | Propriedades do artigo. Consulte [Atributos da encomenda e propriedades dos artigos](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-custom-fields.md). |
| `line_item.hs_tariff_code` | O código pautal SH |
| `line_item.country_of_origin` | O país de origem |
| `line_item.weight` | O peso de um artigo, na respetiva unidade |
| `line_item.grams` | O peso de um artigo, em gramas; `{{ line_item.grams \| weight_with_unit }}` acrescenta a unidade |
| `line_item.total_weight` | O peso da linha (artigo × quantidade) |
| `line_item.image` | A imagem do artigo; `{{ line_item.image \| img_url: 'thumb' \| img_tag }}` imprime-a |
| `line_item.requires_shipping` | Se o artigo precisa de envio |
| `line_item.gift_card` | Se o artigo é um cartão de oferta |
| `line_item.product` | O produto (`title`, `type`, `vendor`, `tags`, `handle`…) |
| `line_item.variant` | A variante (`title`, `sku`, `barcode`, `option1`, `inventory_quantity`…) |

## Padrões comuns

Imprima o título da variante por baixo do produto, apenas quando existir:

```liquid theme={null}
{{ line_item.product_title }}
{% if line_item.variant_title != blank %}<br>{{ line_item.variant_title }}{% endif %}
```

Omita os artigos totalmente reembolsados numa guia de remessa:

```liquid theme={null}
{% for line_item in line_items %}
  {% if line_item.quantity > line_item.refunded_quantity %}
    {{ line_item.title }} × {{ line_item.quantity | minus: line_item.refunded_quantity }}
  {% endif %}
{% endfor %}
```

Mostre um código de barras de cada SKU:

```liquid theme={null}
{{ line_item.sku | barcode }}
```

## Um documento por envio

Quando um modelo imprime um documento por envio (**Envios divididos** na página de definições do modelo), `document_fulfillment` é o envio que está a ser impresso. Para listar apenas o que contém:

```liquid theme={null}
{% if document_fulfillment %}
  {% assign line_items = document_fulfillment.line_items %}
{% endif %}
```

## Bom saber

* Os preços estão em cêntimos: imprima-os sempre com um filtro de dinheiro. Consulte [Dinheiro e moeda nos modelos](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-money-and-currency.md).
* As imagens dos artigos são impressas no tamanho que indicar com `img_url`, como `'thumb'`, `'small'`, `'medium'` ou `'120x120'`.
* Os metacampos dos produtos e das variantes estão em `line_item.product.metafields` e `line_item.variant.metafields`. Consulte [Metacampos nos modelos](https://foliant-help.iforiti.com/pt-PT/template-editor/metafields.md).
* Pode escolher o nome da variável do ciclo, mas `line_item` corresponde à referência e aos modelos iniciais.
* As encomendas do Bold Product Options e do Infinite Options acrescentam `line_item.options`, `line_item.option_addon`, `line_item.option_addons` e preços com extras, para poder imprimir os extras pagos abaixo do respetivo artigo. Consulte [Apps de opções de produto (Bold, Infinite Options)](https://foliant-help.iforiti.com/pt-PT/templates/product-options-apps.md).

## Artigos relacionados

* [O objeto da encomenda e as variáveis comuns](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-order-variables.md)
* [Dinheiro e moeda nos modelos](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-money-and-currency.md)
* [Atributos da encomenda e propriedades dos artigos](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-custom-fields.md)
* [Metacampos nos modelos](https://foliant-help.iforiti.com/pt-PT/template-editor/metafields.md)
* [Apps de opções de produto (Bold, Infinite Options)](https://foliant-help.iforiti.com/pt-PT/templates/product-options-apps.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.