> ## 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.
# Đối tượng đơn hàng và các biến thường dùng
> Các biến Liquid mà mẫu dùng cho đơn hàng, khách hàng, địa chỉ, cửa hàng, vận chuyển, thanh toán, hoàn tiền và thực hiện đơn hàng.
Mỗi chứng từ được tạo từ một đơn hàng (hoặc, với mẫu gộp, từ các đơn hàng bạn đã chọn). Trong Liquid, bạn dùng trực tiếp các trường của đơn hàng, ví dụ `{{ name }}`, hoặc qua `order`, ví dụ `{{ order.name }}`. Cả hai cách đều cho kết quả như nhau. Các biến giống với biến của Shopify Order Printer, nên phần lớn mẫu Order Printer dùng được ngay trong Foliant mà không cần sửa.
Thẻ **Biến Liquid** trong trình soạn mã liệt kê tất cả các biến, có ô tìm kiếm. Bài này giới thiệu những biến bạn sẽ dùng nhiều nhất. Giá trị tiền được tính bằng cent; xem [Tiền và tiền tệ trong mẫu](https://foliant-help.iforiti.com/vi/template-editor/liquid-money-and-currency.md).
## Đơn hàng
| Biến | Nội dung in ra |
| - | - |
| `{{ order_name }}` hoặc `{{ name }}` | Tên đơn hàng, có dấu # (`#1042`) |
| `{{ order_number }}` | Số đơn hàng (`1042`) |
| `{{ id }}` | ID đơn hàng |
| `{{ po_number }}` | Số đơn đặt hàng (PO) |
| `{{ date }}` hoặc `{{ created_at }}` | Thời điểm đặt hàng. Định dạng bằng bộ lọc `date`. |
| `{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}` | Các ngày khác của đơn hàng |
| `{{ completed_at }}` | Thời điểm đơn hàng nháp được hoàn tất |
| `{{ financial_status }}` | Trạng thái thanh toán, ví dụ `paid`, `pending` hoặc `partially_refunded` |
| `{{ fulfillment_status }}` | Trạng thái thực hiện, ví dụ `unfulfilled` hoặc `fulfilled` |
| `{{ note }}` | Ghi chú đơn hàng |
| `{{ tags }}` | Thẻ của đơn hàng (một danh sách: lặp qua bằng `{% for tag in tags %}`) |
| `{{ email }}` | Email của đơn hàng |
| `{{ customer_locale }}` | Ngôn ngữ khách hàng dùng khi mua hàng |
| `{{ order_status_url }}` | Liên kết đến trang trạng thái đơn hàng (đơn hàng trực tuyến) |
| `{{ total_items }}` hoặc `{{ item_count }}` | Số lượng mặt hàng |
| `{{ total_weight }}` | Tổng khối lượng; `{{ total_weight_in_grams \| weight_with_unit }}` thêm đơn vị |
| `{{ order_currency }}` hoặc `{{ currency }}` | Mã tiền tệ của đơn hàng |
| `{% if pickup_in_store? %}…{% endif %}` | Đơn hàng có được nhận tại cửa hàng hay không |
| `{{ location.name }}` | Địa điểm POS (đơn hàng POS), kèm `address1`, `city`, `zip`, `country`, `phone`… |
## Tổng tiền
In tổng tiền bằng bộ lọc tiền, ví dụ `{{ total_price | money }}`.
| Biến | Ý nghĩa |
| - | - |
| `subtotal_price` | Tổng phụ |
| `shipping_price` | Phí vận chuyển |
| `total_discounts` | Tất cả chiết khấu |
| `order_level_discounts` | Chiết khấu áp dụng cho cả đơn hàng (không nằm trong giá từng mặt hàng) |
| `total_tax` | Thuế |
| `total_line_items_tax`, `total_shipping_tax` | Thuế trên mặt hàng và thuế trên phí vận chuyển |
| `total_duties` | Thuế hải quan |
| `total_price` | Tổng đơn hàng |
| `total_paid` | Số tiền đã thanh toán |
| `total_refunds` | Số tiền đã hoàn |
| `total_gift_cards` | Số tiền thanh toán bằng thẻ quà tặng |
Bạn cũng có thể dùng `current_subtotal_price`, `current_total_discounts`, `current_total_tax` và `current_total_price`.
## Khách hàng và địa chỉ
| Biến | Nội dung in ra |
| - | - |
| `{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}` | Tên khách hàng |
| `{{ customer.email }}`, `{{ customer.phone }}` | Thông tin liên hệ |
| `{{ customer.note }}` | Ghi chú về khách hàng |
| `{{ customer.tags }}` | Thẻ của khách hàng |
| `{{ customer.total_spent \| money }}` | Số tiền khách hàng đã chi tiêu |
| `{% if customer.tax_exempt %}` | Khách hàng có được miễn thuế hay không |
| `{{ shipping_address \| format_address }}` | Địa chỉ giao hàng, có xuống dòng |
| `{{ billing_address \| format_address }}` | Địa chỉ thanh toán |
Mỗi địa chỉ (`shipping_address`, `billing_address` và `customer.default_address`) có `name`, `first_name`, `last_name`, `company`, `address1`, `address2`, `street`, `city`, `province`, `province_code`, `zip`, `country`, `country_code`, `phone` và `city_province_zip`. `{% if shipping_address.member_of_eu %}` kiểm tra quốc gia có thuộc EU hay không.
## Cửa hàng của bạn
| Biến | Nội dung in ra |
| - | - |
| `{{ shop.name }}` hoặc `{{ shop_name }}` | Tên cửa hàng của bạn |
| `{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}` | Thông tin liên hệ |
| `{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`… | Địa chỉ của bạn, như đã thiết lập trong Shopify |
| `{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}` | Logo và màu nhấn của bạn trong **Cài đặt › Thương hiệu** |
| `{{ shop.vat_number }}`, `{{ shop.eori }}` | Mã số thuế GTGT (VAT) và số EORI của bạn trong **Cài đặt › Thuế và pháp lý** |
| `{{ seller.legal_lines \| join: ' · ' }}` | Thông tin pháp lý của bạn, mỗi mục một dòng, theo ngôn ngữ của chứng từ |
## Vận chuyển, thanh toán và thực hiện đơn hàng
| Biến | Nội dung in ra |
| - | - |
| `{{ shipping_method.title }}` | Phương thức vận chuyển |
| `{% for shipping_line in shipping_lines %}` | Từng dòng vận chuyển: `title`, `code`, `price` |
| `{{ payment_method }}`, `{{ gateway }}` | Cách thanh toán đơn hàng |
| `{% for transaction in transactions %}` | Từng giao dịch: `amount`, `kind`, `status`, `gateway`, `created_at` |
| `{% for tax_line in tax_lines %}` | Từng khoản thuế: `title`, `rate`, `price` |
| `{% for discount in discounts %}` | Từng chiết khấu: `code`, `amount`, `savings` |
| `{% for fulfillment in fulfillments %}` | Từng lần thực hiện: `tracking_number`, `tracking_company`, `created_at` |
| `{{ latest_fulfillment }}` | Lần thực hiện gần nhất |
| `{% for refund in refunds %}` | Từng lần hoàn tiền: `created_at`, `note`, `subtotal`, `total_tax`, `total`, `refund_line_items` |
| `{{ latest_refund }}` | Lần hoàn tiền gần nhất (giấy báo có) |
| `{{ payment_terms.due_in_days }}` | Điều khoản thanh toán (B2B và đơn hàng nháp), kèm `payment_schedules` và `current_payment_schedule.due_at` |
## Ví dụ
```liquid theme={null}
{{ 'titles.invoice' | t }} {{ order_name }}
{{ created_at | date: '%d %B %Y' }}
{{ shipping_address | format_address }}
{{ 'total' | t }}: {{ total_price | money }}
{% if note != blank %}{{ note | escape }}
{% endif %}
```
## Lưu ý
* Giá trị trống sẽ không in ra gì. Dùng `{% if … != blank %}` để ẩn nhãn khi không có giá trị.
* Mẫu dành cho tất cả đơn hàng đã chọn dùng `orders` (lặp bằng `{% for order in orders %}`), `batch` và `pick_list` thay cho một đơn hàng. Xem mục **Mẫu gộp** trong thẻ **Biến Liquid**.
* Với hóa đơn VAT, xem mục **Thuế GTGT (VAT)** trong tài liệu tham khảo: `tax_breakdown`, `buyer.vat_number`, `{% include 'vat_breakdown' %}` và `{% include 'legal_notes' %}`. Xem [Thuế và pháp lý](https://foliant-help.iforiti.com/vi/tax-and-legal.md).
## Bài viết liên quan
* [Mặt hàng trong mẫu](https://foliant-help.iforiti.com/vi/template-editor/liquid-line-items.md)
* [Tiền và tiền tệ trong mẫu](https://foliant-help.iforiti.com/vi/template-editor/liquid-money-and-currency.md)
* [Bộ lọc Liquid](https://foliant-help.iforiti.com/vi/template-editor/liquid-filters.md)
* [Chỉnh sửa mã của mẫu](https://foliant-help.iforiti.com/vi/template-editor/code-editor.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.