> ## 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.

# O objeto da encomenda e variáveis comuns

> As variáveis Liquid que os modelos usam para a encomenda, o cliente, as moradas, a loja, o envio, os pagamentos, os reembolsos e os processamentos.

Cada documento é gerado a partir de uma encomenda (ou, nos modelos em lote, das encomendas selecionadas). Em Liquid, os campos da encomenda estão disponíveis diretamente, como `{{ name }}`, e também em `order`, como `{{ order.name }}`. Ambas as formas funcionam da mesma maneira. As variáveis seguem as do Order Printer da Shopify, por isso a maioria dos modelos do Order Printer funciona no Foliant tal como está.

O separador **Variáveis Liquid** do editor de código lista todas, com pesquisa. Este artigo aborda as que vai usar mais. Os valores monetários estão em cêntimos; consulte [Dinheiro e moeda nos modelos](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-money-and-currency.md).

## A encomenda

| Variável | O que imprime |
| - | - |
| `{{ order_name }}` ou `{{ name }}` | O nome da encomenda, com # (`#1042`) |
| `{{ order_number }}` | O número da encomenda (`1042`) |
| `{{ id }}` | O ID da encomenda |
| `{{ po_number }}` | O número da nota de encomenda |
| `{{ date }}` ou `{{ created_at }}` | Quando a encomenda foi feita. Formate-a com o filtro `date`. |
| `{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}` | Outras datas da encomenda |
| `{{ completed_at }}` | Quando um rascunho de encomenda foi concluído |
| `{{ financial_status }}` | O estado do pagamento, como `paid`, `pending` ou `partially_refunded` |
| `{{ fulfillment_status }}` | O estado do processamento, como `unfulfilled` ou `fulfilled` |
| `{{ note }}` | A nota da encomenda |
| `{{ tags }}` | As etiquetas da encomenda (uma lista: percorra-a com `{% for tag in tags %}`) |
| `{{ email }}` | O e-mail da encomenda |
| `{{ customer_locale }}` | O idioma em que o cliente fez a compra |
| `{{ order_status_url }}` | A ligação para a página de estado da encomenda (encomendas online) |
| `{{ total_items }}` ou `{{ item_count }}` | O número de artigos |
| `{{ total_weight }}` | O peso total; `{{ total_weight_in_grams \| weight_with_unit }}` acrescenta a unidade |
| `{{ order_currency }}` ou `{{ currency }}` | O código da moeda da encomenda |
| `{% if pickup_in_store? %}…{% endif %}` | Se a encomenda é levantada na loja |
| `{{ location.name }}` | A localização do POS (encomendas POS), com `address1`, `city`, `zip`, `country`, `phone`… |

## Totais

Imprima os totais com um filtro de dinheiro, por exemplo `{{ total_price | money }}`.

| Variável | O que é |
| - | - |
| `subtotal_price` | O subtotal |
| `shipping_price` | O envio |
| `total_discounts` | Todos os descontos |
| `order_level_discounts` | Descontos sobre toda a encomenda (não incluídos nos preços das linhas) |
| `total_tax` | O imposto |
| `total_line_items_tax`, `total_shipping_tax` | O imposto sobre os artigos e sobre o envio |
| `total_duties` | Os direitos aduaneiros |
| `total_price` | O total da encomenda |
| `total_paid` | O valor pago |
| `total_refunds` | O valor reembolsado |
| `total_gift_cards` | O valor pago com cartões de oferta |

Também estão disponíveis `current_subtotal_price`, `current_total_discounts`, `current_total_tax` e `current_total_price`.

## Cliente e moradas

| Variável | O que imprime |
| - | - |
| `{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}` | O nome do cliente |
| `{{ customer.email }}`, `{{ customer.phone }}` | Os dados de contacto |
| `{{ customer.note }}` | A nota do cliente |
| `{{ customer.tags }}` | As etiquetas do cliente |
| `{{ customer.total_spent \| money }}` | O valor que o cliente já gastou |
| `{% if customer.tax_exempt %}` | Se o cliente está isento de impostos |
| `{{ shipping_address \| format_address }}` | A morada de envio, com quebras de linha |
| `{{ billing_address \| format_address }}` | A morada de faturação |

Cada morada (`shipping_address`, `billing_address` e `customer.default_address`) tem `name`, `first_name`, `last_name`, `company`, `address1`, `address2`, `street`, `city`, `province`, `province_code`, `zip`, `country`, `country_code`, `phone` e `city_province_zip`. `{% if shipping_address.member_of_eu %}` verifica se o país pertence à UE.

## A sua loja

| Variável | O que imprime |
| - | - |
| `{{ shop.name }}` ou `{{ shop_name }}` | O nome da sua loja |
| `{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}` | Os dados de contacto |
| `{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`… | A sua morada, tal como definida na Shopify |
| `{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}` | O seu logótipo e a cor de destaque definidos em **Definições › Identidade visual** |
| `{{ shop.vat_number }}`, `{{ shop.eori }}` | O seu número de IVA e o EORI definidos em **Definições › Impostos e jurídico** |
| `{{ seller.legal_lines \| join: ' · ' }}` | Os seus dados legais, um por linha, no idioma do documento |

## Envio, pagamentos e processamentos

| Variável | O que imprime |
| - | - |
| `{{ shipping_method.title }}` | O método de envio |
| `{% for shipping_line in shipping_lines %}` | Cada linha de envio: `title`, `code`, `price` |
| `{{ payment_method }}`, `{{ gateway }}` | A forma como a encomenda foi paga |
| `{% for transaction in transactions %}` | Cada transação: `amount`, `kind`, `status`, `gateway`, `created_at` |
| `{% for tax_line in tax_lines %}` | Cada imposto: `title`, `rate`, `price` |
| `{% for discount in discounts %}` | Cada desconto: `code`, `amount`, `savings` |
| `{% for fulfillment in fulfillments %}` | Cada processamento: `tracking_number`, `tracking_company`, `created_at` |
| `{{ latest_fulfillment }}` | O processamento mais recente |
| `{% for refund in refunds %}` | Cada reembolso: `created_at`, `note`, `subtotal`, `total_tax`, `total`, `refund_line_items` |
| `{{ latest_refund }}` | O reembolso mais recente (notas de crédito) |
| `{{ payment_terms.due_in_days }}` | As condições de pagamento (B2B e rascunhos de encomenda), com `payment_schedules` e `current_payment_schedule.due_at` |

## Exemplo

```liquid theme={null}
<h1>{{ 'titles.invoice' | t }} {{ order_name }}</h1>
<p>{{ created_at | date: '%d %B %Y' }}</p>
<p>{{ shipping_address | format_address }}</p>
<p>{{ 'total' | t }}: {{ total_price | money }}</p>
{% if note != blank %}<p>{{ note | escape }}</p>{% endif %}
```

## Bom saber

* Um valor vazio não imprime nada. Use `{% if … != blank %}` para omitir um rótulo quando não houver valor.
* Os modelos para todas as encomendas selecionadas usam `orders` (percorra com `{% for order in orders %}`), `batch` e `pick_list` em vez de uma única encomenda. Consulte a secção **Modelos em lote** do separador **Variáveis Liquid**.
* Para faturas com IVA, consulte a secção **IVA** da referência: `tax_breakdown`, `buyer.vat_number`, `{% include 'vat_breakdown' %}` e `{% include 'legal_notes' %}`. Consulte [Impostos e jurídico](https://foliant-help.iforiti.com/pt-PT/tax-and-legal.md).

## Artigos relacionados

* [Linhas de artigos nos modelos](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-line-items.md)
* [Dinheiro e moeda nos modelos](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-money-and-currency.md)
* [Filtros Liquid](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-filters.md)
* [Editar o código de um modelo](https://foliant-help.iforiti.com/pt-PT/template-editor/code-editor.md)


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