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

# Objek pesanan dan variabel umum

> Variabel Liquid yang dipakai template untuk pesanan, pelanggan, alamat, toko, pengiriman, pembayaran, pengembalian dana, dan pemenuhan.

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](https://foliant-help.iforiti.com/id/template-editor/liquid-money-and-currency.md).

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

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

## 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](https://foliant-help.iforiti.com/id/tax-and-legal.md).

## Artikel terkait

* [Item baris di template](https://foliant-help.iforiti.com/id/template-editor/liquid-line-items.md)
* [Uang dan mata uang di template](https://foliant-help.iforiti.com/id/template-editor/liquid-money-and-currency.md)
* [Filter Liquid](https://foliant-help.iforiti.com/id/template-editor/liquid-filters.md)
* [Mengedit kode template](https://foliant-help.iforiti.com/id/template-editor/code-editor.md)


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