Tài liệu tham khảo về biến thông báo

Các thông báo được gửi từ cửa hàng được hiển thị bằng Liquid. Liquid là ngôn ngữ lập trình đơn giản, dễ sử dụng của Shopify. Đây cũng là ngôn ngữ lập trình nền tảng của các chủ đề trên Theme Store.

Để chỉnh sửa thông báo được gửi từ cửa hàng, bạn có thể thực hiện tùy chỉnh cơ bản cho mẫu thông báo. Để truy cập danh sách đầy đủ các thông báo có thể tùy chỉnh, hãy truy cập trang Thông báo trong bảng điều khiển quản trị Shopify.

Để được trợ giúp về thay đổi nâng cao hơn hoặc chỉnh sửa mẫu thông báo tùy chỉnh, bạn có thể liên hệ với cộng đồng trên diễn đàn hoặc thuê Đối tác Shopify thực hiện tùy chỉnh. Tìm hiểu thêm về việc thuê Đối tác Shopify.

Trên trang này

Thuộc tính đơn hàng

Bạn có thể sử dụng trực tiếp nhiều thuộc tính của đơn hàng bằng Liquid và trong các mẫu.

Mô tả về các thuộc tính Liquid có thể sử dụng với đối tượng đơn hàng trong mẫu thông báo
Thuộc tính	Mô tả
`id`	ID đơn hàng duy nhất trên toàn hệ thống để sử dụng nội bộ. Hãy sử dụng ví dụ sau để tạo liên kết đến đơn hàng trong phần quản trị của cửa hàng. Ví dụ: bạn có thể thêm mã sau vào mẫu Đơn hàng mới: `Xem đơn hàng`
`email`	Email liên kết với đơn hàng.
`name`	Thông thường, thuộc tính này là ký hiệu dấu thăng theo sau là `order_number`. Ví dụ: #1004
`order_name`	Giống như tên.
`order_number`	Số đơn hàng duy nhất của cửa hàng, không có tiền tố là dấu thăng #, hoặc bất kỳ tiền tố hay hậu tố nào do chủ cửa hàng thêm vào ID đơn hàng trong tùy chọn cài đặt cửa hàng. Ví dụ: 1004
`confirmation_number`	Mã nhận dạng gồm chữ và số được tạo ngẫu nhiên cho đơn hàng, có thể hiển thị cho khách hàng thay vì tên đơn hàng theo tuần tự. Giá trị này không đảm bảo là duy nhất. Ví dụ: XPAV284CT
`created_at`	Ngày và giờ khách hàng tạo đơn hàng. Bạn có thể định dạng thông tin này bằng bộ lọc ngày. Ví dụ: 2009-05-30T17:43:51+02:00
`payment_terms`	Điều khoản thanh toán quy định ngày đến hạn thanh toán cho một đơn hàng. Tìm hiểu cách thêm điều khoản thanh toán vào hóa đơn của đơn hàng. Để biết thêm chi tiết, hãy tham khảo tài liệu tham khảo Liquid cho payment_terms.
`destination`	Điểm đến để gửi mặt hàng.
`tags`	Trả về một mảng chứa tất cả thẻ của đơn hàng. Các thẻ được trả về theo thứ tự bảng chữ cái. Các thẻ do ứng dụng hoặc tính năng nền tảng tự động áp dụng, chẳng hạn như thẻ `Shopify Collective`, có thể không khả dụng khi hệ thống tạo email thông báo. Để phát hiện mặt hàng từ một tính năng cụ thể, hãy kiểm tra thẻ cấp độ sản phẩm trên từng mục hàng. Tham khảo tài liệu tham khảo Liquid để biết thêm chi tiết.
`transactions`	Trả về mảng các giao dịch của đơn hàng.
`tax_price`	Tổng số thuế của tất cả mặt hàng trong đơn hàng.
`tax_lines`	Tiền thuế được chia theo loại thuế: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	Tên loại thuế. Ví dụ: QST hoặc GTGT.
`tax_line.price`	Số tiền thuế.
`tax_line.rate`	Mức thuế dưới dạng số thập phân. Thuộc tính này sẽ trả về 0.175 nếu mức thuế là 17,5%.
`tax_line.rate_percentage`	Mức thuế ở định dạng dễ đọc. Thuộc tính này sẽ trả về 17.5 nếu mức thuế là 0,175.
`customer`	Đối tượng khách hàng chứa các thuộc tính trong đầu ra của khách hàng.
`billing_address`	Địa chỉ thanh toán.
`billing_address.first_name`	Tên của khách hàng.
`billing_address.last_name`	Họ của khách hàng.
`billing_address.company`	Tên công ty để thanh toán.
`billing_address.phone`	Số điện thoại từ địa chỉ thanh toán.
`shop.name`	Tên cửa hàng.
`shop.phone`	Số điện thoại cửa hàng.
`subtotal_price`	Tổng giá của các mục hàng trong đơn hàng sau khi đã trừ đi khoản giảm giá cho mục hàng hoặc giảm giá cho giỏ hàng. Tổng phụ không bao gồm thuế (trừ khi thuế đã tính vào giá), chi phí vận chuyển hoặc tiền boa.
`discounts`	Danh sách khoản giảm giá.
`discounts_amount`	Số tiền giảm giá được áp dụng từ tất cả các khoản giảm giá. Ví dụ: +$5.00
`discounts_savings`	Số tiền tiết kiệm được từ tất cả các khoản giảm giá. Ví dụ: -$5.00
`total_price`	Tổng giá trị đơn hàng (tổng phụ + chi phí vận chuyển - khoản giảm giá vận chuyển + thuế).
`financial_status`	Trạng thái thanh toán hiện tại. Bao gồm: nil, `pending`, `authorized`, `paid`, `voided`, `refunded`.
`requires_shipping`	(boolean) Trả về true nếu đơn hàng có ít nhất một mặt hàng yêu cầu vận chuyển.
`shipping_method.title`	Tên phí vận chuyển. Trong các thông báo dành cho khách hàng, tên phí vận chuyển được dịch sang ngôn ngữ mà khách hàng sử dụng khi thanh toán, nếu ngôn ngữ này khác với ngôn ngữ mặc định của cửa hàng. Ví dụ: Standard Shipping
`shipping_method.price`	Giá vận chuyển đã bao gồm mọi khoản giảm giá vận chuyển. Ví dụ: `{{ shipping_method.price \| money }}`
`shipping_price`	Giá vận chuyển. Ví dụ: `{{ shipping_price \| money }}`
`shipping_address`	Địa chỉ giao hàng.
`shipping_address.first_name`	Tên trong địa chỉ giao hàng.
`shipping_address.company`	Tên công ty trong địa chỉ giao hàng.
`shipping_address.phone`	Số điện thoại trong địa chỉ giao hàng.
`line_items`	Danh sách tất cả mục hàng trong đơn hàng.
`line_items_including_zero_quantity`	Danh sách tất cả mục hàng trong đơn hàng, bao gồm cả những mục có số lượng bằng không. Mục hàng có số lượng bằng không khi đã được hoàn tiền toàn bộ.
`line_item_groups`(Orders and POS only)	Danh sách tất cả nhóm mục hàng chứa các thành phần mục hàng trong đơn hàng.
`item_count`	Tổng số lượng của tất cả mặt hàng.
`fulfillment_status`	Trạng thái hoàn thiện đơn hàng hiện tại. Bao gồm: `unfulfilled`, `partial`, `fulfilled`.
`note`	Ghi chú được đính kèm vào đơn hàng. Bạn có thể nhận ghi chú từ khách hàng hoặc chỉnh sửa trên màn hình chi tiết đơn hàng trong bảng điều khiển quản trị.
`attributes`	Mọi thuộc tính được đính kèm vào đơn hàng. Ví dụ: `{{ attributes.gift-note }}`
`metafields`	Mọi trường siêu dữ liệu trên đơn hàng. Sử dụng cú pháp sau: metafields.NAMESPACE.KEY
`referring_site`	Chứa url của nguồn giới thiệu đã đưa khách hàng đến cửa hàng của bạn. Ví dụ: `https://www.google.com/?s=great+products`
`landing_site`	Chứa đường dẫn của trang đích mà khách hàng đã sử dụng. Đây là trang đầu tiên khách hàng thấy khi truy cập cửa hàng. Ví dụ: `/products/great-product?ref=my-tracking-token`
`landing_site_ref`	Xem lại trang đích và trích xuất một thông số tham chiếu từ đó. Các thông số tham chiếu có thể là: `ref`, `source`, `r`. Nếu `landing_site` là `/products/great-product?ref=my-tracking-token`, thì `landing_site_ref` sẽ là `my-tracking-token`. Bạn có thể thực hiện một hành động cụ thể nếu biến ref bằng một giá trị nhất định: `{% if landing_site_ref == 'my-tracking-token' %} Hành động của tôi... {% endif %}`
`cancelled`	(boolean) Trả về true nếu đơn hàng đã bị hủy.
`cancelled_at`	Thời điểm đơn hàng bị hủy.
`cancel_reason`	Lý do được chọn khi hủy đơn hàng. Bao gồm: `inventory`, `customer`, `declined`, `fraud`, hoặc `other`.
`has_high_risks?`(deprecated)	Trả về true nếu đơn hàng có rủi ro cao
`unique_gateways`	Trả về danh sách các nhà cung cấp dịch vụ thanh toán duy nhất trong một đơn hàng. Ví dụ: nếu một người thanh toán bằng thẻ Visa, Mastercard và tiền mặt, thì danh sách trả về sẽ là `shopify_payments, cash`.
`location`(POS only)	Hiển thị địa điểm thực tế của đơn hàng. Có một số thuộc tính địa điểm, được liệt kê tại đây. Bạn có thể định cấu hình địa điểm trong phần Địa điểm trên bảng điều khiển quản trị.
`order_status_url`	Trả về liên kết đến trang trạng thái đơn hàng cho đơn hàng này.
`fulfilled_line_items`(deprecated)	Danh sách mục hàng đã hoàn tất.
`unfulfilled_line_items`(deprecated)	Danh sách mục hàng chưa được hoàn tất toàn bộ.
`b2b?`	Trả về true nếu đơn hàng là đơn hàng B2B. Sử dụng thuộc tính có biến B2B để hiển thị thông tin liên quan trong email, chẳng hạn như tên công ty, địa điểm công ty và địa chỉ. Ví dụ: đối với đơn hàng B2B, bạn có thể thêm đầu trang vào mẫu có thông tin sau: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	Công ty bạn đang bán hàng trên đơn hàng B2B.
`company.name`	Tên công ty trên đơn hàng B2B.
`company.id`	ID của công ty trên đơn hàng B2B.
`company_location`	Địa điểm của công ty trên đơn hàng B2B. Một công ty mua hàng từ bạn có thể có nhiều địa điểm.
`company_location.name`	Tên địa điểm công ty trên đơn hàng B2B.
`company_location.id`	Mã ID của địa điểm công ty trên đơn hàng B2B.
`company_location.shipping_address`	Địa chỉ giao hàng của địa điểm công ty trên đơn hàng B2B.
`company_location.billing_address`	Địa chỉ thanh toán của địa điểm công ty trên đơn hàng B2B.
`customer_order_url`	Trang trạng thái đơn hàng mới của đơn hàng mà khách hàng đã yêu cầu trả hàng bằng tài khoản khách hàng.

Thuộc tính đơn hàng nháp

Nội dung mô tả thuộc tính Liquid mà bạn có thể dùng với đối tượng đơn hàng nháp trong các mẫu thông báo
Thuộc tính	Mô tả
`id`	ID duy nhất của đơn hàng nháp để sử dụng nội bộ.
`invoice_url`	Liên kết mà khách hàng có thể dùng để thanh toán hóa đơn thông qua tính năng thanh toán an toàn của Shopify.
`reserve_inventory_until`	Ngày và giờ các mục hàng trong bản nháp được giữ lại, ví dụ như `2015-05-30T17:43:51+02:00`. Bạn có thể định dạng ngày bằng bộ lọc ngày Liquid.
`user`	Nhân viên cuối cùng đã sửa đổi đơn hàng nháp.
`user.name`	Tên nhân viên cuối cùng đã sửa đổi đơn hàng nháp.
`user.email`	Địa chỉ email của nhân viên cuối cùng đã sửa đổi đơn hàng nháp.
`email`	Địa chỉ email liên kết với đơn hàng nháp.
`name`	Mã duy nhất `number` của đơn hàng nháp, có tiền tố là dấu thăng `#`.
`number`	Số duy nhất của đơn hàng nháp không có tiền tố hoặc hậu tố đơn hàng.
`created_at`	Ngày và giờ khách hàng tạo đơn hàng nháp, ví dụ: `2009-05-30T17:43:51+02:00`. Bạn có thể định dạng ngày bằng bộ lọc ngày Liquid.
`tags`	Trả về một mảng gồm tất cả các thẻ của đơn hàng. Các thẻ được trả về theo thứ tự bảng chữ cái. Tham khảo Tài liệu tham khảo về Liquid để biết thêm chi tiết.
`tax_price`	Tổng thuế của tất cả mặt hàng trong đơn hàng nháp.
`tax_lines`	Thuế được phân chia theo loại thuế: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	Tên thuế. Ví dụ: QST hoặc GTGT
`tax_line.price`	Số tiền thuế.
`tax_line.rate`	Mức thuế ở dạng số thập phân. Ví dụ: mức thuế 17,5% sẽ trả về `0.175`.
`tax_line.rate_percentage`	Mức thuế ở dạng phần trăm. Ví dụ: `rate` là 0,175 sẽ trả về `17.5`.
`customer`	Đối tượng khách hàng chứa các thuộc tính trong đầu ra của khách hàng.
`billing_address`	Địa chỉ thanh toán cho đơn hàng nháp.
`billing_address.first_name`	Tên của khách hàng.
`billing_address.last_name`	Họ của khách hàng.
`billing_address.company`	Tên công ty trong địa chỉ thanh toán.
`billing_address.phone`	Số điện thoại trong địa chỉ thanh toán.
`shop.name`	Tên cửa hàng của bạn.
`shop.phone`	Số điện thoại cửa hàng.
`subtotal_price`	Tổng giá mặt hàng của đơn hàng nháp sau khi đã trừ đi khoản giảm giá đối với mặt hàng hoặc giảm giá ở giỏ hàng. Tổng phụ không bao gồm thuế (trừ khi giá đã bao gồm thuế) hoặc chi phí vận chuyển.
`discounts`	Danh sách khoản giảm giá.
`discounts_amount`	Số tiền giảm giá được áp dụng bởi tất cả khoản giảm giá. Ví dụ: +$5.00
`discounts_savings`	Số tiền tiết kiệm được từ tất cả các khoản giảm giá. Ví dụ: -$5.00
`total_price`	Tổng giá đơn hàng (tổng phụ + chi phí vận chuyển - chiết khấu vận chuyển + thuế).
`amount_due_now`	Số tiền bắt buộc trên hóa đơn của đơn hàng nháp.
`requires_shipping`	Trả về `true` nếu có ít nhất một mặt hàng trong đơn hàng nháp cần vận chuyển. Trả về `false` nếu không có mặt hàng nào trong đơn hàng nháp cần vận chuyển.
`shipping_method.title`	Tên phí vận chuyển. Ví dụ: Giao hàng tiêu chuẩn
`shipping_method.price`	Giá của phương thức vận chuyển. Trả về thông tin giống như `shipping_price`.
`shipping_price`	Giá vận chuyển. Bạn có thể định dạng số tiền này bằng bộ lọc tiền của Liquid.
`shipping_address`	Địa chỉ giao hàng. Lưu ý: Khác với đơn hàng thông thường, địa chỉ giao hàng của đơn hàng nháp có thể chưa đầy đủ.
`shipping_address.first_name`	Tên trong địa chỉ giao hàng.
`shipping_address.company`	Tên công ty trong địa chỉ giao hàng.
`shipping_address.phone`	Số điện thoại trong địa chỉ giao hàng.
`line_items`	Danh sách tất cả mặt hàng trong đơn hàng nháp.
`item_count`	Tổng tất cả số lượng mặt hàng trong đơn hàng nháp.
`note`	Ghi chú đính kèm với đơn hàng nháp. Bạn có thể lấy ghi chú này từ khách hàng và cũng có thể chỉnh sửa ghi chú trong màn hình chi tiết đơn hàng nháp trong bảng điều khiển quản trị Shopify.
`metafields`	Mọi trường siêu dữ liệu trên đơn hàng nháp. Sử dụng cú pháp sau: metafields.NAMESPACE.KEY
`location`	Địa điểm thực tế của đơn hàng. Có một số thuộc tính địa điểm có sẵn. Bạn có thể cấu hình địa điểm trên trang Địa điểm trong bảng điều khiển quản trị Shopify.
`b2b?`	Trả về true nếu đơn hàng là đơn hàng B2B. Sử dụng thuộc tính có biến B2B để hiển thị thông tin liên quan trong email, chẳng hạn như tên công ty, địa điểm công ty và địa chỉ. Ví dụ: đối với đơn hàng B2B, bạn có thể thêm đầu trang vào mẫu có thông tin sau: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	Công ty bạn đang bán hàng trên đơn hàng B2B.
`company.name`	Tên công ty trên đơn hàng B2B.
`company.id`	ID của công ty trên đơn hàng B2B.
`company_location`	Địa điểm của công ty trên đơn hàng B2B. Một công ty mua hàng từ bạn có thể có nhiều địa điểm.
`company_location.name`	Tên địa điểm công ty trên đơn hàng B2B.
`company_location.id`	Mã ID của địa điểm công ty trên đơn hàng B2B.
`company_location.shipping_address`	Địa chỉ giao hàng của địa điểm công ty trên đơn hàng B2B.
`company_location.billing_address`	Địa chỉ thanh toán của địa điểm công ty trên đơn hàng B2B.
`payment_methods`	Danh sách các phương thức thanh toán đã lưu có thể dùng để xử lý tổng số tiền của đơn hàng nháp.
`payment_method.payment_instrument`	Phương tiện thanh toán, chứa thông tin chi tiết về phương thức thanh toán đã lưu.
`payment_method.payment_instrument.payment_type`	Loại phương thức thanh toán đã lưu. Ví dụ: "credit_card, apple_pay"
`payment_method.payment_instrument.credit_card_brand`	Thương hiệu thẻ, khi `payment_type` là "credit_card"
`payment_method.payment_instrument.credit_card_company`	Công ty phát hành thẻ, khi `payment_type` là "credit_card"
`payment_method.payment_instrument.credit_card_company`	4 chữ số cuối của thẻ, khi `payment_type` là "credit_card"

Thuộc tính lịch biểu thanh toán

Nội dung mô tả về các thuộc tính Liquid mà bạn có thể dùng với đối tượng lịch biểu thanh toán trong mẫu thông báo
Thuộc tính	Mô tả
`payment_schedule.amount_due`	Số tiền cần thanh toán cho một lịch biểu thanh toán. Bạn có thể định dạng số tiền đi kèm loại tiền tệ bằng bộ lọc tiền của Liquid.
`payment_schedule.due_at`	Ngày đến hạn của lịch biểu thanh toán. Bạn có thể định dạng ngày bằng bộ lọc ngày Liquid.
`payment_schedule.due_in_days`	Số ngày cho đến ngày đến hạn nếu lịch biểu thanh toán vẫn đang đến hạn (chưa thanh toán).
`payment_schedule.due_later?`	Trả về true nếu lịch biểu thanh toán chưa được thanh toán và ngày đến hạn nằm ở tương lai.
`payment_schedule.number_of_days_overdue?`	Số ngày tính từ ngày đến hạn khi lịch biểu thanh toán đã quá hạn.
`payment_schedule.overdue?`	Trả về true nếu lịch biểu thanh toán chưa được thanh toán và đã qua ngày đến hạn.

Thuộc tính trạng thái thanh toán

Nội dung mô tả về các thuộc tính Liquid mà bạn có thể dùng với đối tượng trạng thái thanh toán trong mẫu thông báo
Thuộc tính	Mô tả
`has_pending_payment`	(boolean) Trả về true nếu đơn hàng có một giao dịch có thanh toán đang chờ xử lý. Tìm hiểu thêm về thanh toán đang chờ xử lý.
`buyer_action_required`	(boolean) Trả về true nếu một đơn hàng có một giao dịch với khoản thanh toán đang chờ xử lý và người mua cần thực hiện hành động để bỏ chặn thanh toán. Khi giá trị này trả về true và phương thức thanh toán hỗ trợ hướng dẫn thanh toán, `buyer_pending_payment_instructions` sẽ cung cấp thông tin chi tiết mà khách hàng có thể dùng để hoàn tất giao dịch mua ngoại tuyến. Tìm hiểu thêm về đối tượng giao dịch trong Liquid.

Thuộc tính thành phần gói sản phẩm

Mỗi bundle_component trong danh sách line_item.bundle_components có các thuộc tính sau đây. (Chỉ dành cho đơn hàng nháp)

Nội dung mô tả về các thuộc tính Liquid mà bạn có thể dùng với đối tượng thành phần gói sản phẩm trong mẫu thông báo
Thuộc tính	Mô tả
`bundle_component.image_url`	Url hình ảnh của thành phần gói sản phẩm.
`bundle_component.product.title`	Tiêu đề của sản phẩm thuộc thành phần gói sản phẩm.
`bundle_component.quantity`	Số lượng cho thành phần gói sản phẩm.
`bundle_component.variant.title`	Tên hiện tại của các giá trị tùy chọn đối với mẫu mã thành phần gói sản phẩm, được nối bằng ký tự `/`. Ví dụ: nhỏ / màu đỏ

Thuộc tính thành phần

Mỗi component trong danh sách line_item.components có các thuộc tính sau. (Chỉ dành cho thanh toán chưa hoàn tất) `

Mô tả các thuộc tính Liquid có thể sử dụng với đối tượng thành phần trong mẫu thông báo
Thuộc tính	Mô tả
`component.image_url`	URL hình ảnh của thành phần.
`component.product.title`	Tiêu đề của sản phẩm thành phần.
`component.quantity`	Số lượng của thành phần.
`component.variant.title`	Tên hiện tại của các giá trị tùy chọn thuộc biến thể thành phần, được nối bằng các ký tự `/`. Ví dụ: nhỏ / màu đỏ

Thuộc tính mục hàng

Mỗi line trong danh sách line_items hoặc subtotal_line_items có các thuộc tính sau.

Mô tả các thuộc tính Liquid có thể sử dụng với đối tượng mục hàng trong mẫu thông báo
Thuộc tính	Mô tả
`line.applied_discounts`(POS and draft orders only)	Danh sách các khoản giảm giá được áp dụng cho mặt hàng này (mỗi khoản giảm giá có các thuộc tính `title`, `code`, `amount`, `savings` và `type`).
`line.bundle_components`(Draft orders only)	Danh sách các mục hàng là thành phần gói sản phẩm của mặt hàng này. Chỉ trả về danh sách nếu mục hàng này là sản phẩm gói.
`line.bundle_parent?`(Draft orders only)	(boolean) Trả về true nếu mục hàng là sản phẩm gói.
`line.components`(Abandoned checkout only)	Danh sách các mục hàng là thành phần của mặt hàng này.
`line.parent?`(Abandoned checkout only)	(boolean) Trả về true nếu mục hàng có các thành phần.
`line.custom`(Draft orders only)	(boolean) Trả về true nếu mặt hàng là mục hàng tùy chỉnh cho đơn hàng nháp.
`line.delivery_agreement`	Thỏa thuận giao hàng liên kết với mục hàng này.
`line.grams`	Trọng lượng của một mặt hàng.
`line.groups`	Nhóm mục hàng của mặt hàng.
`line.image`	Trả về URL của hình ảnh liên kết với mục hàng này. Bạn cũng có thể sử dụng bộ lọc img_url để lấy các kích thước hình ảnh cụ thể, ví dụ: `{{ line.image \| img_url: 'small' }}`
`line.line_price`	Giá nhân với số lượng cho mặt hàng đó.
`line.original_line_price`	Tổng giá của số lượng mặt hàng có trong mục hàng, trước khi áp dụng giảm giá.
`line.final_line_price`	Tổng giá của tất cả các mặt hàng trong mục hàng, bao gồm tất cả các khoản giảm giá cấp mục hàng.
`line.pre_tax_price`	Giá trước thuế cho các mục hàng, nhân với số lượng mục hàng được mua.
`line.price`	Giá cho một mặt hàng.
`line.product.metafields`	Mọi trường siêu dữ liệu ở cấp độ sản phẩm. Sử dụng cú pháp sau: line.product.metafields.NAMESPACE.KEY
`line.product.title`	Tên hiện tại của sản phẩm.
`line.product.vendor`	Nhà cung cấp cho mặt hàng.
`line.properties`	Trả về một mảng thông tin tùy chỉnh cho mặt hàng. Khách hàng chỉ định thuộc tính mục hàng trên trang sản phẩm trước khi thêm sản phẩm vào giỏ hàng.
`line.quantity`	Số lượng cho mặt hàng đó.
`line.current_quantity`	Số lượng hiện tại của mặt hàng sau khi xóa.
`line.requires_shipping`	(boolean) Trả về true nếu biến thể cho mặt hàng được kích hoạt cài đặt Sản phẩm vật lý trên trang sản phẩm.
`line.selling_plan_allocation`	Trả về một đối tượng `selling_plan_allocation`, mô tả cách một gói bán hàng, chẳng hạn như đăng ký, tác động đến mục hàng.
`line.taxable`	(boolean) Trả về true nếu biến thể cho mặt hàng có hộp kiểm 'Tính thuế sản phẩm này' được chọn trên trang sản phẩm.
`line.title`	Tên sản phẩm tại thời điểm bán, theo sau là dấu gạch ngang và tên biến thể tại thời điểm bán. Không bao gồm tên biến thể nếu tên đó là "Default Title". Trong các thông báo gửi cho khách hàng, tên sản phẩm và tên biến thể được dịch sang ngôn ngữ mà khách hàng đã dùng khi thanh toán, khi ngôn ngữ đó khác với ngôn ngữ mặc định của cửa hàng.
`line.url`	URL tương đối của biến thể thuộc mục hàng. URL tương đối không bao gồm URL gốc của cửa hàng (`mystore.myshopify.com`).
`line.variant.barcode`	Mã vạch liên kết với biến thể sản phẩm.
`line.variant.compare_at_price`	Giá so sánh liên kết với biến thể sản phẩm.
`line.variant.image`	Hình ảnh cho biến thể sản phẩm. Chỉ trả về hình ảnh nếu có một hình ảnh cụ thể được chỉ định cho biến thể trong mục hàng.
`line.variant.metafields`	Mọi trường siêu dữ liệu ở cấp độ biến thể. Sử dụng cú pháp sau: line.variant.metafields.NAMESPACE.KEY
`line.variant.sku`	Mã SKU liên kết với biến thể sản phẩm.
`line.variant.title`	Tên hiện hành của các giá trị tùy chọn thuộc biến thể, được nối bằng các ký tự `/`. Ví dụ: nhỏ / màu đỏ
`line.refunded.quantity`(within refund notifications)	Số lượng mặt hàng sẽ được hoàn tiền. Bạn có thể sử dụng thuộc tính này để thêm mã nhận dạng cho các mặt hàng được hoàn tiền trong đơn hàng. Ví dụ: `{% if line.refunded_quantity > 0 %}Mã nhận dạng mục hàng được hoàn tiền{% endif %}`

Phát hiện mặt hàng Shopify Collective trong mẫu thông báo

Thẻ Shopify Collective được áp dụng cho đơn hàng sau khi gửi email xác nhận đơn hàng, do đó, {% if tags contains 'Shopify Collective' %} không bao giờ là true trong mẫu xác nhận đơn hàng. Để phát hiện mặt hàng Shopify Collective, thay vào đó hãy kiểm tra các thẻ cấp độ sản phẩm trên từng mục hàng:

{% assign has_collective_item = false %}
{% for line in line_items %}
  {% if line.product.tags contains 'Shopify Collective' %}
    {% assign has_collective_item = true %}
  {% endif %}
{% endfor %}

{% if has_collective_item %}
  <!-- Collective-specific content -->
{% endif %}

Thuộc tính nhóm mục hàng

Mỗi line_item_group trong danh sách line_item_groups có các thuộc tính sau.

Mô tả các thuộc tính Liquid có thể sử dụng với đối tượng nhóm mục hàng trong mẫu thông báo
Thuộc tính	Mô tả
`line_item_group.display_title`	Tiêu đề của nhóm mục hàng.
`line_item_group.components`	Danh sách các thành phần mục hàng thuộc nhóm.
`line_item_group.image`	Hình ảnh của nhóm mục hàng.
`line_item_group.product_id`	ID sản phẩm của nhóm mục hàng.
`line_item_group.variant`	Đối tượng biến thể của nhóm mục hàng.
`line_item_group.variant_id`	ID biến thể của nhóm mục hàng.

Thuộc tính hoàn tiền

Mô tả các thuộc tính Liquid có thể sử dụng với đối tượng hoàn tiền trong mẫu thông báo
Thuộc tính	Mô tả
`amount`	Số tiền được hoàn lại.
`refund_line_items`	Danh sách mục hàng hoàn tiền sẽ được hoàn tiền.

Thuộc tính refund_line_item

Mỗi refund_line trong danh sách refund_line_items có các thuộc tính sau:

Mô tả về các thuộc tính Liquid có thể sử dụng cùng đối tượng mục hàng hoàn tiền trong mẫu thông báo
Thuộc tính	Mô tả
`refund_line.line_item`	Biến `line_item` đang được hoàn tiền. Biến này có quyền truy cập vào tất cả thuộc tính của line_item.
`refund_line.quantity`	Số lượng mục hàng cần hoàn tiền.

Thuộc tính hoàn tất đơn hàng

Mô tả về các thuộc tính Liquid có thể sử dụng cùng đối tượng hoàn tất đơn hàng trong mẫu thông báo
Thuộc tính	Mô tả
`service_name`	Tên dịch vụ tùy chỉnh được xác định trên trang Cài đặt > Vận chuyển và giao hàng. (Chỉ dành cho yêu cầu thực hiện đơn hàng)
`fulfillment.estimated_delivery_at`	Ngày giao hàng dự kiến dựa trên số theo dõi (nếu có) do một trong các hãng vận chuyển sau cung cấp: USPS, FedEx, UPS, Canada Post (chỉ tại Canada). Thuộc tính này chỉ khả dụng khi sử dụng phí do hãng vận chuyển tính.
`fulfillment.fulfillment_line_items`	Danh sách các mục hàng hoàn tất đơn hàng cần được hoàn tất.
`fulfillment.item_count`	Tổng số lượng tất cả mặt hàng. Tổng số mặt hàng đang được hoàn tất.
`fulfillment.requires_shipping`	(boolean) Trả về true nếu yêu cầu hoàn tất đơn hàng này yêu cầu vận chuyển.
`fulfillment.tracking_company`	Công ty thực hiện theo dõi.
`fulfillment.tracking_numbers`	Danh sách số theo dõi.
`fulfillment.tracking_urls`	Danh sách URL theo dõi.
`items_to_fulfill`(deprecated)	Danh sách mục hàng sẽ được hoàn tất bởi dịch vụ hoàn tất đơn hàng tùy chỉnh cụ thể này. (Chỉ dành cho yêu cầu hoàn tất đơn hàng)
`items_to_fulfill_count`(deprecated)	Tổng số mặt hàng sẽ được hoàn tất bởi yêu cầu này. (Chỉ dành cho yêu cầu hoàn tất đơn hàng)

Thuộc tính fulfillment_line_item

Mỗi fulfillment_line trong danh sách fulfillment_line_items có các thuộc tính sau.

Mô tả về các thuộc tính Liquid có thể sử dụng cùng đối tượng mục hàng hoàn tất đơn hàng trong mẫu thông báo
Thuộc tính	Mô tả
`fulfillment_line.line_item`	Biến `line_item` đang được hoàn tất. Biến này có quyền truy cập vào tất cả thuộc tính của line_item.
`fulfillment_line.quantity`	Số lượng mục hàng đang được hoàn tất.

Thuộc tính gói hàng đã chuẩn bị

Gói hàng đã chuẩn bị bao gồm các mặt hàng được đánh dấu là sẵn sàng để lấy hàng.

Mô tả về các thuộc tính Liquid có thể sử dụng cùng đối tượng gói hàng đã chuẩn bị trong mẫu thông báo
Thuộc tính	Mô tả
`item_count`	Tổng số lượng tất cả mặt hàng trong gói hàng đã chuẩn bị.
`prepared_package_line_items`	Danh sách mục hàng của gói hàng đã chuẩn bị.

Thuộc tính prepared_package_line_item

Mỗi prepared_package_line_item trong danh sách prepared_package_line_items có các thuộc tính sau.

Mô tả về các thuộc tính Liquid có thể sử dụng cùng đối tượng mục hàng của gói hàng đã chuẩn bị trong mẫu thông báo
Thuộc tính	Mô tả
`line_item`	Biến `line_item` được liên kết. Biến này có quyền truy cập vào tất cả thuộc tính của line_item.
`quantity`	Số lượng mục hàng đã được đánh dấu là sẵn sàng để lấy hàng.

Thuộc tính giao hàng

Mô tả về các thuộc tính Liquid có thể sử dụng cùng đối tượng giao hàng trong mẫu thông báo
Thuộc tính	Mô tả
`delivery_agreements`	Danh sách tất cả Thỏa thuận giao hàng của đơn hàng.
`delivery_instructions`	Thông tin giao hàng tận nơi để chia sẻ với khách hàng. Thông tin này được kiểm soát bởi trường Thông tin giao hàng trong cài đặt giao hàng tận nơi.
`consolidated_estimated_delivery_time`	Thông tin ngày giao đơn hàng để chia sẻ với khách hàng. Thông tin này được kiểm soát bởi cài đặt Thời gian xử lý mà bạn đã thiết lập trên trang Vận chuyển và giao hàng. Khi đơn hàng có nhiều phương thức giao hàng, danh sách các phương thức và ngày giao hàng sẽ hiển thị.
`has_multiple_delivery_methods`	(boolean) Trả về true nếu đơn hàng có nhiều phương thức giao hàng.

Thuộc tính Thỏa thuận giao hàng

Mô tả về các thuộc tính Liquid có thể sử dụng cùng đối tượng thỏa thuận giao hàng trong mẫu thông báo
Thuộc tính	Mô tả
`delivery_agreement.delivery_method_type`	Loại phương thức giao hàng.
`delivery_agreement.delivery_method_name`	Loại phương thức giao hàng được dịch sang ngôn ngữ mà người mua sử dụng khi thanh toán, khi ngôn ngữ đó khác với ngôn ngữ mặc định của cửa hàng.
`delivery_agreement.line_item_groups`	Danh sách tất cả nhóm mục hàng có chứa thành phần mục hàng theo gói trong thỏa thuận giao hàng.
`delivery_agreement.line_items`	Danh sách tất cả mục hàng được liên kết với thỏa thuận giao hàng này.

Thuộc tính giảm giá

Có hai loại thuộc tính giảm giá.

discount_applications mô tả lý do và cách một mặt hàng được giảm giá.

discount_allocations mô tả cách một khoản giảm giá cụ thể tác động lên mục hàng và cách giảm giá thành. Bạn nên sử dụng thuộc tính này ở cấp độ mục hàng.

Có thể kết hợp các thuộc tính này để hiển thị thông tin giảm giá ở cấp độ mục hàng hoặc cấp độ đơn hàng.

Ví dụ

Ví dụ này kiểm tra xem mục hàng có được áp dụng giảm giá hay không. Nếu không áp dụng giảm giá ở cấp độ đơn hàng (all), thì tên và số tiền giảm giá sẽ hiển thị.

{% if line.discount_allocations %}
	{% for discount_allocation in line.discount_allocations %}
    	{% if discount_allocation.discount_application.target_selection != 'all' %}
        	{{ discount_allocation.discount_application.title | upcase }}
        	(-{{ discount_allocation.amount | money }})
    	{% endif %}
	{% endfor %}
{% endif %}

Kết quả có thể tương tự như sau:

SPRING5 (-$5.00)

Thuộc tính discount_allocation

Mỗi discount_allocation trong danh sách discount_allocations có các thuộc tính sau.

Mô tả về các thuộc tính Liquid có thể sử dụng cùng đối tượng discount_allocation trong mẫu thông báo
Thuộc tính	Mô tả
`discount_allocation.amount`	Số tiền khách hàng tiết kiệm được trên một mục hàng. Phải được đưa vào một vòng lặp nếu muốn cho phép dùng nhiều mã giảm giá.
`discount_allocation.discount_application`	Lượt áp dụng giảm giá phân bổ số tiền trên mục hàng.

Thuộc tính discount_application

Mỗi discount_application trong danh sách discount_applications có các thuộc tính sau.

Mô tả về các thuộc tính Liquid có thể sử dụng cùng đối tượng discount_application trong mẫu thông báo
Thuộc tính	Mô tả
`discount_application.target_selection`	Mô tả cách khoản giảm giá chọn các mục hàng trong giỏ hàng để giảm giá. Gồm một trong các tùy chọn: `all`: Giảm giá áp dụng cho tất cả mục hàng. `entitled`: Giảm giá áp dụng cho một nhóm mục hàng cụ thể, thường được xác định theo điều kiện. `explicit`: Giảm giá áp dụng cho một mục hàng hoặc dòng vận chuyển được chọn cụ thể.
`discount_application.target_type`	Loại mặt hàng được áp dụng giảm giá (`line_item` hoặc `shipping_line`).
`discount_application.title`	Tên hiển thị với khách hàng của khoản giảm giá. Ví dụ: Welcome10 hoặc CBBWQQAKYBYY
`discount_application.total_allocated_amount`	Tổng số tiền mà giá của đơn hàng được giảm qua khoản giảm giá.
`discount_application.type`	Loại giảm giá. Một trong các loại: `automatic`, `discount_code`, `manual` hoặc `script`.
`discount_application.value`	Giá trị giảm giá.
`discount_application.value_type`	Loại giá trị giảm giá. Một trong các loại: `fixed_amount` hoặc `percentage`.

Thuộc tính đăng ký

Chi tiết về hợp đồng đăng ký, chu kỳ thanh toán hiện tại cùng các mục hàng, phương thức giao hàng và phương thức thanh toán của hợp đồng đều có sẵn cho mọi mẫu email đăng ký.

Để chỉnh sửa mẫu thông báo đăng ký, hãy cài đặt ứng dụng Shopify Subscriptions, rồi tìm mẫu trong Cài đặt > Thông báo thuộc phần Subscriptions.

Thuộc tính chu kỳ thanh toán của hợp đồng đăng ký

Để truy cập các thuộc tính của hợp đồng đăng ký và chu kỳ thanh toán của hợp đồng, hãy sử dụng đối tượng subscription_contract_billing_cycle.

Ví dụ

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

Kết quả:

This contract is currently paused.

Thuộc tính

Mô tả các thuộc tính Liquid mà bạn có thể sử dụng với đối tượng chu kỳ thanh toán của hợp đồng đăng ký trong mẫu thông báo
Thuộc tính	Mô tả
`status`	Trạng thái của hợp đồng. Một trong các trạng thái: `active`, `paused`, `cancelled`, `failed`, `expired`, `stale`,
`delivery_method`	Phương thức giao hàng của đăng ký. Nếu đăng ký là dịch vụ hoặc sản phẩm kỹ thuật số, kết quả trả về sẽ là `nil`.
`billing_frequency`	Tần suất lập hóa đơn cho đăng ký.
`delivery_frequency`	Tần suất giao hàng cho đăng ký.
`origin_order`	Đơn hàng ban đầu đã tạo đăng ký. Nếu đăng ký không được tạo từ đơn hàng Shopify, kết quả trả về sẽ là `nil`.
`customer`	Khách hàng đăng ký.
`line_items`	Các mục hàng trong chu kỳ thanh toán của đăng ký.
`product_names`	Danh sách tên các sản phẩm có trong chu kỳ thanh toán của đăng ký.
`update_payment_method_url`	URL mà khách hàng có thể sử dụng để cập nhật phương thức thanh toán cho hợp đồng này.
`shipping_address`	Địa chỉ giao hàng của đăng ký. Nếu đăng ký là dịch vụ hoặc sản phẩm kỹ thuật số, kết quả trả về sẽ là `nil`.
`billing_address`	Địa chỉ thanh toán của đăng ký.
`subtotal_price`	Giá tổng phụ của các mục hàng đăng ký.
`shipping_price`	Phí vận chuyển của đăng ký.
`total_tax`	Tổng thuế của đăng ký.
`total_price`	Tổng giá của đăng ký.
`total_discounts`	Tổng số tiền giảm giá của đăng ký.
`customer_self_serve_url`	URL tự phục vụ mà khách hàng có thể sử dụng để quản lý đăng ký của họ.
`billing_attempt_expected_date`	Ngày lập hóa đơn cho chu kỳ thanh toán này.
`next_billing_date`	Ngày lập hóa đơn tiếp theo không bị bỏ qua sau chu kỳ thanh toán này.
`last_attempted_billing_date`	Ngày thử lập hóa đơn gần nhất cho chu kỳ thanh toán.
`days_overdue`	Số ngày lập hóa đơn bị quá hạn đối với chu kỳ thanh toán này.
`payment_instrument`	Công cụ thanh toán được liên kết với hợp đồng đăng ký. Công cụ thanh toán này được sử dụng để lập hóa đơn cho khách hàng.

Thuộc tính mục hàng của hợp đồng đăng ký

Thuộc tính đối với từng mục hàng có trong chu kỳ thanh toán. Truy cập các thuộc tính mục hàng của hợp đồng thông qua thuộc tính mẹ subscription_contract_billing_cycle.line_items.

Ví dụ

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}

Mô tả các thuộc tính Liquid mà bạn có thể sử dụng với đối tượng mục hàng của hợp đồng đăng ký trong mẫu thông báo
Thuộc tính	Mô tả
`url`	URL dẫn đến trang chi tiết sản phẩm cho biến thể sản phẩm của mục hàng.
`requires_shipping`	Liệu mục hàng có yêu cầu vận chuyển thực tế hay không.
`unit_price_measurement`	Thước đo đơn giá của mục hàng.
`selling_plan_allocation`	Phân bổ kế hoạch bán hàng của mục hàng.

Thuộc tính phương thức giao hàng của hợp đồng đăng ký

Thuộc tính đối với phương thức giao hàng đang được sử dụng trong chu kỳ thanh toán này. Truy cập các thuộc tính phương thức giao hàng thông qua thuộc tính mẹ subscription_contract_billing_cycle.delivery_method.

Ví dụ

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}

Mô tả các thuộc tính Liquid mà bạn có thể sử dụng với đối tượng phương thức giao hàng của hợp đồng đăng ký trong mẫu thông báo
Thuộc tính	Mô tả
`title`	Tiêu đề của tùy chọn vận chuyển được liên kết với phương thức giao hàng.
`type`	Loại phương thức giao hàng. Một trong các loại: `shipping`, `local` hoặc `pick-up`.

Thuộc tính công cụ thanh toán của hợp đồng đăng ký

Thông tin chi tiết về công cụ thanh toán của hợp đồng đăng ký. Công cụ thanh toán này được sử dụng để lập hóa đơn cho khách hàng. Truy cập các thuộc tính của công cụ thanh toán thông qua thuộc tính mẹ subscription_contract_billing_cycle.payment_instrument.

Ví dụ

{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}

<img src="{{ instrument.payment_type | payment_type_img_url }} "  alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}

Mô tả các thuộc tính Liquid mà bạn có thể sử dụng với đối tượng công cụ thanh toán của hợp đồng đăng ký trong mẫu thông báo
Thuộc tính	Mô tả
`payment_type`	Loại phương thức thanh toán được thể hiện thông qua công cụ thanh toán. Sử dụng bộ lọc thanh toán để xuất URL hình ảnh hoặc SVG.
`credit_card_brand`	Thương hiệu của thẻ tín dụng.
`credit_card_company`	Tên công ty phát hành thẻ tín dụng.
`credit_card_last_four_digits`	4 chữ số cuối của thẻ tín dụng.

Thuộc tính thông báo qua email

Mô tả các thuộc tính Liquid mà bạn có thể sử dụng với đối tượng thông báo qua email trong mẫu thông báo
Thuộc tính	Mô tả
`shop.email_logo_url`	URL cho logo được chỉ định trong phần Tùy chỉnh mẫu email của bảng điều khiển quản trị.
`shop.email_logo_width`	Chiều rộng logo (điểm ảnh) được chỉ định trong phần Tùy chỉnh mẫu email của bảng điều khiển quản trị.
`shop.email_accent_color`	Mã HEX cho màu nhấn được chỉ định trong phần Tùy chỉnh mẫu email của bảng điều khiển quản trị.

Thuộc tính tín dụng cửa hàng

Các thuộc tính chứa chi tiết về việc phát hành tín dụng cửa hàng.

Mô tả các thuộc tính Liquid mà bạn có thể sử dụng với đối tượng tín dụng cửa hàng được phát hành trong mẫu thông báo
Thuộc tính	Mô tả
`issued_store_credit.amount`	Số tiền tín dụng cửa hàng đã được phát hành. Bạn có thể định dạng số tiền này bằng bộ lọc tiền của Liquid.
`issued_store_credit.expires_at`	Ngày và giờ mà tín dụng cửa hàng được phát hành sẽ hết hạn. Bạn có thể định dạng số tiền này bằng bộ lọc ngày Liquid.
`issued_store_credit.balance_after_transaction`	Số dư tài khoản tín dụng cửa hàng sau khi tín dụng được phát hành. Bạn có thể định dạng số tiền này bằng bộ lọc tiền của Liquid.
`customer`	Đối tượng khách hàng chứa các thuộc tính trong đầu ra của khách hàng.