Objek pesanan dan variabel umum

Setiap dokumen dibuat dari satu pesanan (atau, untuk template gabungan, dari pesanan yang dipilih). Di Liquid, field pesanan tersedia langsung, misalnya {{ name }}, dan juga di bawah order, misalnya {{ order.name }}. Keduanya bekerja sama. Variabelnya mengikuti variabel Shopify Order Printer, jadi sebagian besar template Order Printer langsung berfungsi di Foliant tanpa diubah. Tab Variabel Liquid di editor kode mencantumkan semuanya, lengkap dengan pencarian. Artikel ini membahas variabel yang paling sering Anda pakai. Nilai uang dalam satuan sen; lihat Uang dan mata uang di template.

Pesanan

Variabel	Yang dicetak
`{{ order_name }}` atau `{{ name }}`	Nama pesanan, dengan # (`#1042`)
`{{ order_number }}`	Nomor pesanan (`1042`)
`{{ id }}`	ID pesanan
`{{ po_number }}`	Nomor purchase order
`{{ date }}` atau `{{ created_at }}`	Waktu pesanan dibuat. Format dengan filter `date`.
`{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}`	Tanggal pesanan lainnya
`{{ completed_at }}`	Waktu draf pesanan diselesaikan
`{{ financial_status }}`	Status pembayaran, misalnya `paid`, `pending`, atau `partially_refunded`
`{{ fulfillment_status }}`	Status pemenuhan, misalnya `unfulfilled` atau `fulfilled`
`{{ note }}`	Catatan pesanan
`{{ tags }}`	Tag pesanan (berupa daftar: ulangi dengan `{% for tag in tags %}`)
`{{ email }}`	Email pesanan
`{{ customer_locale }}`	Bahasa yang dipakai pelanggan saat berbelanja
`{{ order_status_url }}`	Tautan halaman status pesanan (pesanan online)
`{{ total_items }}` atau `{{ item_count }}`	Jumlah item
`{{ total_weight }}`	Berat total; `{{ total_weight_in_grams \| weight_with_unit }}` menambahkan satuannya
`{{ order_currency }}` atau `{{ currency }}`	Kode mata uang pesanan
`{% if pickup_in_store? %}…{% endif %}`	Apakah pesanan diambil di toko
`{{ location.name }}`	Lokasi POS (pesanan POS), dengan `address1`, `city`, `zip`, `country`, `phone`…

Total

Cetak total dengan filter uang, misalnya {{ total_price | money }}.

Variabel	Isinya
`subtotal_price`	Subtotal
`shipping_price`	Pengiriman
`total_discounts`	Semua diskon
`order_level_discounts`	Diskon untuk seluruh pesanan (tidak termasuk dalam harga baris)
`total_tax`	Pajak
`total_line_items_tax`, `total_shipping_tax`	Pajak atas item, dan atas pengiriman
`total_duties`	Bea masuk
`total_price`	Total pesanan
`total_paid`	Jumlah yang dibayar
`total_refunds`	Jumlah yang dikembalikan
`total_gift_cards`	Dibayar dengan kartu hadiah

current_subtotal_price, current_total_discounts, current_total_tax, dan current_total_price juga tersedia.

Pelanggan dan alamat

Variabel	Yang dicetak
`{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}`	Nama pelanggan
`{{ customer.email }}`, `{{ customer.phone }}`	Detail kontak
`{{ customer.note }}`	Catatan pelanggan
`{{ customer.tags }}`	Tag pelanggan
`{{ customer.total_spent \| money }}`	Jumlah yang telah dibelanjakan pelanggan
`{% if customer.tax_exempt %}`	Apakah pelanggan bebas pajak
`{{ shipping_address \| format_address }}`	Alamat pengiriman, disusun dengan baris baru
`{{ billing_address \| format_address }}`	Alamat penagihan

Setiap alamat (shipping_address, billing_address, dan customer.default_address) memiliki name, first_name, last_name, company, address1, address2, street, city, province, province_code, zip, country, country_code, phone, dan city_province_zip. {% if shipping_address.member_of_eu %} memeriksa apakah negaranya anggota UE.

Toko Anda

Variabel	Yang dicetak
`{{ shop.name }}` atau `{{ shop_name }}`	Nama toko Anda
`{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}`	Detail kontak
`{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`…	Alamat Anda, sesuai pengaturan di Shopify
`{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}`	Logo dan warna aksen Anda dari Pengaturan › Branding
`{{ shop.vat_number }}`, `{{ shop.eori }}`	Nomor PPN dan EORI Anda dari Pengaturan › Pajak & hukum
`{{ seller.legal_lines \| join: ' · ' }}`	Detail hukum Anda, satu per baris, dalam bahasa dokumen

Pengiriman, pembayaran, dan pemenuhan

Variabel	Yang dicetak
`{{ shipping_method.title }}`	Metode pengiriman
`{% for shipping_line in shipping_lines %}`	Setiap baris pengiriman: `title`, `code`, `price`
`{{ payment_method }}`, `{{ gateway }}`	Cara pesanan dibayar
`{% for transaction in transactions %}`	Setiap transaksi: `amount`, `kind`, `status`, `gateway`, `created_at`
`{% for tax_line in tax_lines %}`	Setiap pajak: `title`, `rate`, `price`
`{% for discount in discounts %}`	Setiap diskon: `code`, `amount`, `savings`
`{% for fulfillment in fulfillments %}`	Setiap pemenuhan: `tracking_number`, `tracking_company`, `created_at`
`{{ latest_fulfillment }}`	Pemenuhan terbaru
`{% for refund in refunds %}`	Setiap pengembalian dana: `created_at`, `note`, `subtotal`, `total_tax`, `total`, `refund_line_items`
`{{ latest_refund }}`	Pengembalian dana terbaru (nota kredit)
`{{ payment_terms.due_in_days }}`	Ketentuan pembayaran (B2B dan draf pesanan), dengan `payment_schedules` dan `current_payment_schedule.due_at`

Contoh

<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 %}

Perlu diketahui

Nilai kosong tidak mencetak apa pun. Gunakan {% if … != blank %} untuk menyembunyikan label jika tidak ada nilainya.
Template untuk semua pesanan yang dipilih memakai orders (ulangi dengan {% for order in orders %}), batch, dan pick_list, bukan satu pesanan. Lihat bagian Template gabungan di tab Variabel Liquid.
Untuk faktur PPN, lihat bagian PPN di referensi: tax_breakdown, buyer.vat_number, {% include 'vat_breakdown' %}, dan {% include 'legal_notes' %}. Lihat Pajak dan hukum.

Selamat datang

Memulai

Pencetakan

Template

Editor template

Desain

Pengiriman PDF

Template email

Akun pelanggan

Ekspor

Faktur dan penomoran

Pajak dan hukum

Integrasi

Penagihan dan paket

Pengaturan

Pemecahan masalah

Hukum