O objeto do pedido e as variáveis comuns

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.

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

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

Boas-vindas

Primeiros passos

Impressão

Modelos

Editor de modelos

Designs

Envio de PDFs

Modelos de e-mail

Contas de clientes

Exportações

Faturas e numeração

Impostos e jurídico

Integrações

Cobrança e planos

Configurações

Solução de problemas

Jurídico