O objeto da encomenda e variáveis comuns

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.

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

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

Boas-vindas

Primeiros passos

Impressão

Modelos

Editor de modelos

Designs

Envio de PDF

Modelos de email

Contas de cliente

Exportações

Faturas e numeração

Impostos e jurídico

Integrações

Faturação e planos

Definições

Resolução de problemas

Jurídico