Đối tượng đơn hàng và các biến thường dù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.

Đơ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ụ

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

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

Chào mừng

Bắt đầu

In

Mẫu

Trình chỉnh sửa mẫu

Mẫu thiết kế

Gửi PDF

Mẫu email

Tài khoản khách hàng

Xuất dữ liệu

Hóa đơn và đánh số

Thuế và pháp lý

Tích hợp

Thanh toán và gói

Cài đặt

Khắc phục sự cố

Pháp lý