> ## 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 do pedido e as variáveis comuns

> As variáveis Liquid que os modelos usam para o pedido, o cliente, os endereços, a loja, o frete, os pagamentos, os reembolsos e os processamentos de pedidos.

Cada documento é gerado a partir de um pedido (ou, nos modelos em lote, dos pedidos selecionados). No Liquid, os campos do pedido ficam disponíveis diretamente, como `{{ name }}`, e também dentro de `order`, como `{{ order.name }}`. As duas formas funcionam do mesmo jeito. As variáveis seguem as do Order Printer da Shopify, então a maioria dos modelos do Order Printer funciona no Foliant sem alterações.

A aba **Variáveis Liquid** no editor de código lista todas elas, com busca. Este artigo trata das que você vai usar com mais frequência. Os valores monetários estão em centavos; veja [Valores e moeda nos modelos](https://foliant-help.iforiti.com/pt-BR/template-editor/liquid-money-and-currency.md).

## O pedido

| Variável | O que exibe |
| - | - |
| `{{ order_name }}` ou `{{ name }}` | O nome do pedido, com # (`#1042`) |
| `{{ order_number }}` | O número do pedido (`1042`) |
| `{{ id }}` | O ID do pedido |
| `{{ po_number }}` | O número da ordem de compra |
| `{{ date }}` ou `{{ created_at }}` | Quando o pedido foi feito. Formate com o filtro `date`. |
| `{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}` | Outras datas do pedido |
| `{{ completed_at }}` | Quando um pedido preliminar foi concluído |
| `{{ financial_status }}` | O status do pagamento, como `paid`, `pending` ou `partially_refunded` |
| `{{ fulfillment_status }}` | O status de processamento, como `unfulfilled` ou `fulfilled` |
| `{{ note }}` | A observação do pedido |
| `{{ tags }}` | As tags do pedido (uma lista: percorra com `{% for tag in tags %}`) |
| `{{ email }}` | O e-mail do pedido |
| `{{ customer_locale }}` | O idioma em que o cliente comprou |
| `{{ order_status_url }}` | O link da página de status do pedido (pedidos online) |
| `{{ total_items }}` ou `{{ item_count }}` | Quantos itens |
| `{{ total_weight }}` | O peso total; `{{ total_weight_in_grams \| weight_with_unit }}` adiciona a unidade |
| `{{ order_currency }}` ou `{{ currency }}` | O código da moeda do pedido |
| `{% if pickup_in_store? %}…{% endif %}` | Se o pedido será retirado na loja |
| `{{ location.name }}` | O local do PDV (pedidos do POS), com `address1`, `city`, `zip`, `country`, `phone`… |

## Totais

Exiba os totais com um filtro de valor monetário, por exemplo `{{ total_price | money }}`.

| Variável | O que é |
| - | - |
| `subtotal_price` | O subtotal |
| `shipping_price` | O frete |
| `total_discounts` | Todos os descontos |
| `order_level_discounts` | Descontos no pedido inteiro (não incluídos nos preços das linhas) |
| `total_tax` | Tributos |
| `total_line_items_tax`, `total_shipping_tax` | Tributos sobre os itens e sobre o frete |
| `total_duties` | Taxas alfandegárias |
| `total_price` | O total do pedido |
| `total_paid` | O valor pago |
| `total_refunds` | O valor reembolsado |
| `total_gift_cards` | O valor pago com cartões-presente |

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

## Cliente e endereços

| Variável | O que exibe |
| - | - |
| `{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}` | O nome do cliente |
| `{{ customer.email }}`, `{{ customer.phone }}` | Dados de contato |
| `{{ customer.note }}` | A observação do cliente |
| `{{ customer.tags }}` | As tags do cliente |
| `{{ customer.total_spent \| money }}` | Quanto o cliente já gastou |
| `{% if customer.tax_exempt %}` | Se o cliente é isento de tributos |
| `{{ shipping_address \| format_address }}` | O endereço de entrega, organizado com quebras de linha |
| `{{ billing_address \| format_address }}` | O endereço de cobrança |

Cada endereço (`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 faz parte da UE.

## Sua loja

| Variável | O que exibe |
| - | - |
| `{{ shop.name }}` ou `{{ shop_name }}` | O nome da sua loja |
| `{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}` | Dados de contato |
| `{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`… | Seu endereço, conforme configurado na Shopify |
| `{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}` | Seu logotipo e sua cor de destaque de **Configurações › Identidade visual** |
| `{{ shop.vat_number }}`, `{{ shop.eori }}` | Seu número de IVA e seu EORI de **Configurações › Impostos e jurídico** |
| `{{ seller.legal_lines \| join: ' · ' }}` | Seus dados legais, um por linha, no idioma do documento |

## Frete, pagamentos e processamentos

| Variável | O que exibe |
| - | - |
| `{{ shipping_method.title }}` | A forma de envio |
| `{% for shipping_line in shipping_lines %}` | Cada linha de frete: `title`, `code`, `price` |
| `{{ payment_method }}`, `{{ gateway }}` | Como o pedido foi pago |
| `{% for transaction in transactions %}` | Cada transação: `amount`, `kind`, `status`, `gateway`, `created_at` |
| `{% for tax_line in tax_lines %}` | Cada tributo: `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 }}` | Condições de pagamento (B2B e pedidos preliminares), 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 exibe nada. Use `{% if … != blank %}` para omitir um rótulo quando não houver valor.
* Os modelos para todos os pedidos selecionados usam `orders` (percorra com `{% for order in orders %}`), `batch` e `pick_list` em vez de um único pedido. Veja a seção **Modelos em lote** da aba **Variáveis Liquid**.
* Para faturas com IVA, veja a seção **IVA** da referência: `tax_breakdown`, `buyer.vat_number`, `{% include 'vat_breakdown' %}` e `{% include 'legal_notes' %}`. Veja [Impostos e jurídico](https://foliant-help.iforiti.com/pt-BR/tax-and-legal.md).

## Artigos relacionados

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


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