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

# Mặt hàng trong mẫu

> Lặp qua các mặt hàng của đơn hàng bằng Liquid và in tên, số lượng, giá, SKU, hình ảnh, khối lượng và thuộc tính của chúng.

Các mặt hàng của một đơn hàng nằm trong `line_items`. Để in chúng, bạn lặp qua danh sách: mọi nội dung giữa `{% for line_item in line_items %}` và `{% endfor %}` được lặp lại một lần cho mỗi mặt hàng, và `line_item` là mặt hàng hiện tại. Các trường của mặt hàng chỉ hoạt động bên trong vòng lặp.

## Bảng mặt hàng cơ bản

```liquid theme={null}
<table>
  {% for line_item in line_items %}
    <tr>
      <td>{{ line_item.title }}</td>
      <td>{{ line_item.sku }}</td>
      <td>{{ line_item.quantity }}</td>
      <td>{{ line_item.price | money }}</td>
      <td>{{ line_item.line_price | money }}</td>
    </tr>
  {% endfor %}
</table>
```

## Các trường của mặt hàng

| Biến | Nội dung được in |
| - | - |
| `line_item.title` | Tên mặt hàng (sản phẩm và mẫu mã) |
| `line_item.name` | Tên của mặt hàng |
| `line_item.product_title` | Tên sản phẩm |
| `line_item.variant_title` | Tên mẫu mã, chẳng hạn "Blue / Large" |
| `line_item.quantity` | Số lượng đã đặt, bao gồm cả mặt hàng đã hoàn tiền |
| `line_item.fulfillable_quantity` | Số lượng còn cần xử lý |
| `line_item.refunded_quantity` | Số lượng đã hoàn tiền |
| `line_item.sku` | SKU |
| `line_item.vendor` | Nhà cung cấp |
| `line_item.price` | Đơn giá, sau giảm giá theo dòng (xu) |
| `line_item.original_price` | Đơn giá trước giảm giá (xu) |
| `line_item.line_price` | Tổng của dòng: đơn giá × số lượng, sau giảm giá theo dòng (xu) |
| `line_item.total_discount` | Giảm giá của dòng (xu) |
| `line_item.discount_per_item` | Giảm giá cho mỗi mặt hàng (xu) |
| `line_item.total_tax` | Thuế của dòng (xu) |
| `line_item.cost` | Giá vốn của mặt hàng, dùng cho đơn đặt mua hàng (xu) |
| `line_item.tax_lines` | Các khoản thuế của dòng: lặp để lấy `title`, `rate`, `price` |
| `line_item.discount_allocations` | Các khoản giảm giá áp dụng cho dòng: lặp để lấy `amount` |
| `line_item.properties` | Thuộc tính mặt hàng. Xem [Thuộc tính đơn hàng và thuộc tính mặt hàng](https://foliant-help.iforiti.com/vi/template-editor/liquid-custom-fields.md). |
| `line_item.hs_tariff_code` | Mã HS |
| `line_item.country_of_origin` | Quốc gia xuất xứ |
| `line_item.weight` | Khối lượng của một mặt hàng, theo đơn vị riêng của nó |
| `line_item.grams` | Khối lượng của một mặt hàng, tính bằng gam; `{{ line_item.grams \| weight_with_unit }}` thêm đơn vị |
| `line_item.total_weight` | Khối lượng của dòng (mặt hàng × số lượng) |
| `line_item.image` | Hình ảnh của mặt hàng; `{{ line_item.image \| img_url: 'thumb' \| img_tag }}` sẽ in hình ảnh |
| `line_item.requires_shipping` | Mặt hàng có cần vận chuyển hay không |
| `line_item.gift_card` | Mặt hàng có phải thẻ quà tặng hay không |
| `line_item.product` | Sản phẩm (`title`, `type`, `vendor`, `tags`, `handle`…) |
| `line_item.variant` | Mẫu mã (`title`, `sku`, `barcode`, `option1`, `inventory_quantity`…) |

## Các mẫu thường dùng

In tên mẫu mã dưới tên sản phẩm, chỉ khi có mẫu mã:

```liquid theme={null}
{{ line_item.product_title }}
{% if line_item.variant_title != blank %}<br>{{ line_item.variant_title }}{% endif %}
```

Bỏ các mặt hàng đã hoàn tiền toàn bộ khỏi phiếu đóng gói:

```liquid theme={null}
{% for line_item in line_items %}
  {% if line_item.quantity > line_item.refunded_quantity %}
    {{ line_item.title }} × {{ line_item.quantity | minus: line_item.refunded_quantity }}
  {% endif %}
{% endfor %}
```

Hiển thị mã vạch cho từng SKU:

```liquid theme={null}
{{ line_item.sku | barcode }}
```

## Một tài liệu cho mỗi lô hàng

Khi mẫu in một tài liệu cho mỗi lô hàng (**Tách lô hàng** trên trang cài đặt của mẫu), `document_fulfillment` là lô hàng đang được in. Để chỉ liệt kê những gì có trong lô hàng đó:

```liquid theme={null}
{% if document_fulfillment %}
  {% assign line_items = document_fulfillment.line_items %}
{% endif %}
```

## Lưu ý

* Giá được tính bằng xu: bạn luôn in giá bằng bộ lọc tiền tệ. Xem [Tiền và tiền tệ trong mẫu](https://foliant-help.iforiti.com/vi/template-editor/liquid-money-and-currency.md).
* Hình ảnh mặt hàng được in theo kích thước bạn yêu cầu với `img_url`, chẳng hạn `'thumb'`, `'small'`, `'medium'` hoặc `'120x120'`.
* Trường meta của sản phẩm và mẫu mã nằm trong `line_item.product.metafields` và `line_item.variant.metafields`. Xem [Trường meta trong mẫu](https://foliant-help.iforiti.com/vi/template-editor/metafields.md).
* Bạn có thể tự chọn tên biến vòng lặp, nhưng `line_item` khớp với tài liệu tham khảo và các mẫu khởi đầu.
* Đơn hàng từ Bold Product Options và Infinite Options có thêm `line_item.options`, `line_item.option_addon`, `line_item.option_addons` và giá đã gồm tiện ích bổ sung, nên bạn có thể in các tiện ích bổ sung có tính phí dưới mặt hàng của chúng. Xem [Ứng dụng tùy chọn sản phẩm (Bold, Infinite Options)](https://foliant-help.iforiti.com/vi/templates/product-options-apps.md).

## Bài viết liên quan

* [Đối tượng đơn hàng và các biến thường dùng](https://foliant-help.iforiti.com/vi/template-editor/liquid-order-variables.md)
* [Tiền và tiền tệ trong mẫu](https://foliant-help.iforiti.com/vi/template-editor/liquid-money-and-currency.md)
* [Thuộc tính đơn hàng và thuộc tính mặt hàng](https://foliant-help.iforiti.com/vi/template-editor/liquid-custom-fields.md)
* [Trường meta trong mẫu](https://foliant-help.iforiti.com/vi/template-editor/metafields.md)
* [Ứng dụng tùy chọn sản phẩm (Bold, Infinite Options)](https://foliant-help.iforiti.com/vi/templates/product-options-apps.md)


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