Tài liệu tham khảo về biến phiếu đóng gói

Phiếu đóng gói được hiển thị bằng Liquid, một ngôn ngữ mẫu do Shopify tạo ra.

Bạn có thể thay đổi mẫu phiếu đóng gói bằng cách nhấp vào Mẫu phiếu đóng gói trong phần Tài liệu trên trang Vận chuyển và giao hàng thuộc trang quản trị Shopify.

Trên trang này

Biến cửa hàng

Sử dụng các biến trong bảng này để thêm chi tiết về cửa hàng vào phiếu đóng gói. Bạn có thể tìm và chỉnh sửa thông tin cửa hàng trên trang cài đặt Chung trong trang quản trị Shopify.

Mô tả về các biến cửa hàng Liquid mà bạn có thể sử dụng trong mẫu phiếu đóng gói
Biến	Mô tả
shop.name	Tên cửa hàng.
shop.email	Địa chỉ email của cửa hàng.
shop.domain	Miền của cửa hàng.

Biến địa chỉ cửa hàng

Sử dụng các biến trong bảng này để thêm địa chỉ cửa hàng vào phiếu đóng gói. Bạn có thể tìm và chỉnh sửa chi tiết địa chỉ trong phần Địa điểm gửi hàng đi trên trang Vận chuyển và giao hàng thuộc trang quản trị Shopify.

Mô tả về các biến địa chỉ cửa hàng Liquid mà bạn có thể sử dụng trong mẫu phiếu đóng gói
Biến	Mô tả
shop_address.address1	Địa chỉ cửa hàng.
shop_address.address2	Căn hộ hoặc dãy phòng của cửa hàng.
shop_address.company	Tên công ty.
shop_address.city	Thành phố của cửa hàng
shop_address.province_code	Mã tiểu bang hoặc tỉnh/thành phố của cửa hàng. Ví dụ: mã tỉnh/thành phố của Ontario là ON.
shop_address.province	Tiểu bang hoặc tỉnh/thành phố của cửa hàng
shop_address.zip	Mã zip hoặc mã bưu chính của cửa hàng.
shop_address.country_code	Mã quốc gia của cửa hàng. Ví dụ: mã quốc gia của Canada là CA.
shop_address.country	Quốc gia của cửa hàng.
shop_address.summary	Địa chỉ đầy đủ của cửa hàng.

Biến đơn hàng

Sử dụng các biến trong bảng này để thêm chi tiết về đơn hàng vào phiếu đóng gói. Bạn có thể xem danh sách đơn hàng trên trang Đơn hàng thuộc trang quản trị Shopify.

Mô tả về các biến đơn hàng Liquid mà bạn có thể sử dụng trong mẫu phiếu đóng gói
Biến	Mô tả
order.order_number	Mã đơn hàng không có tiền tố hoặc hậu tố. Ví dụ: `1004`.
order.name	Mã đơn hàng bao gồm các tiền tố hoặc hậu tố được thiết lập trên trang cài đặt Chung thuộc trang quản trị Shopify. Ví dụ: `#1004`.
order.note	Ghi chú liên kết với đơn hàng, nếu có.
order.created_at	Ngày và giờ tạo đơn hàng. Ví dụ: `2009-05-30T17:43:51+02:00`. Sử dụng bộ lọc ngày để thay đổi định dạng.

Biến khách hàng

Sử dụng các biến trong bảng này để thêm thông tin khách hàng vào phiếu đóng gói. Bạn có thể xem danh sách đơn hàng trên trang Khách hàng thuộc trang quản trị Shopify.

Mô tả về các biến khách hàng Liquid mà bạn có thể sử dụng trong mẫu phiếu đóng gói
Biến	Mô tả
customer.first_name	Tên của khách hàng.
customer.last_name	Họ của khách hàng.
customer.name	Họ tên đầy đủ của khách hàng.
customer.email	Email của khách hàng.

Biến địa chỉ giao hàng và thanh toán của khách hàng

Sử dụng các biến trong bảng này để thêm địa chỉ giao hàng hoặc thanh toán của khách hàng vào phiếu đóng gói. Bạn có thể xem danh sách đơn hàng trên trang Khách hàng thuộc trang quản trị Shopify.

Mô tả về các biến địa chỉ khách hàng Liquid mà bạn có thể sử dụng trong mẫu phiếu đóng gói
Biến	Mô tả
shipping_address.address1 billing_address.address1	Địa chỉ của khách hàng.
shipping_address.address2 billing_address.address2	Căn hộ hoặc dãy phòng của khách hàng.
shipping_address.first_name billing_address.first_name	Tên của khách hàng.
shipping_address.last_name billing_address.last_name	Họ của khách hàng.
shipping_address.name billing_address.name	Họ tên đầy đủ của khách hàng.
shipping_address.phone billing_address.phone	Số điện thoại của khách hàng.
shipping_address.company billing_address.company	Tên công ty của khách hàng cho địa chỉ giao hàng.
shipping_address.city billing_address.city	Thành phố của khách hàng.
shipping_address.province_code billing_address.province_code	Mã bang hoặc tỉnh của khách hàng. Ví dụ: mã tỉnh của Ontario là ON.
shipping_address.province billing_address.province	Bang hoặc tỉnh của khách hàng.
shipping_address.zip billing_address.zip	Mã zip hoặc mã bưu chính của khách hàng.
shipping_address.country_code billing_address.country_code	Mã quốc gia của khách hàng. Ví dụ: mã quốc gia của Canada là CA.
shipping_address.country billing_address.country	Quốc gia của khách hàng.
shipping_address.summary billing_address.summary	Địa chỉ đầy đủ của khách hàng.

Biến mục hàng trong lô hàng

Sử dụng các biến trong bảng này để thêm chi tiết sản phẩm vào phiếu đóng gói. Để xem các sản phẩm trong đơn hàng, hãy đi tới trang Đơn hàng trong bảng điều khiển quản trị Shopify và nhấp vào mã đơn hàng.

Mô tả về biến mục hàng trong lô hàng của Liquid mà bạn có thể dùng trong mẫu phiếu đóng gói
Biến	Mô tả
line_items_in_shipment	Danh sách các mục hàng thuộc cùng một lô hàng. Từng mục hàng riêng lẻ có thể nằm trong vòng lặp dưới dạng line_item: `{% for line_item in line_items_in_shipment %} {{ line_item.image }} {{ line_item.title }} ... {% endfor %}` Tất cả thuộc tính khả dụng của line_item được liệt kê bên dưới: `line_item.image` - Hình ảnh sản phẩm (nếu có). `line_item.title` - Tên sản phẩm. Nếu sản phẩm có nhiều mẫu mã, tên mẫu mã cũng sẽ được bao gồm. `line_item.variant_title` - Tên biến thể sản phẩm. `line_item.vendor` - Nhà cung cấp sản phẩm. `line_item.sku` - Mã SKU của sản phẩm. `line_item.quantity` - Tổng số lượng của sản phẩm đó. `line_item.shipping_quantity` - Số lượng sản phẩm đó đang được hoàn thành trong lô hàng. `line_item.properties` - Thuộc tính sản phẩm. `line_item.groups` - Danh sách các nhóm mục hàng mà sản phẩm thuộc về, chẳng hạn như gói sản phẩm hoặc tiện ích bổ sung. Mỗi nhóm có các thuộc tính sau: `group.title` - Tiêu đề hiển thị của nhóm. `group.deliverable?` - Trả về `true` nếu mục hàng là tiện ích bổ sung cho sản phẩm mẹ, hoặc `false` nếu mục hàng là một phần của gói sản phẩm.
includes_all_line_items_in_order	Boolean Nếu là `true`, tất cả mặt hàng trong đơn hàng sẽ được bao gồm trong lô hàng. Nếu là `false`, không phải tất cả mặt hàng từ đơn hàng đều được bao gồm trong lô hàng.

Hình ảnh

Chỉ cho phép hình ảnh từ miền https://cdn.myshopify.com/. Tất cả hình ảnh khác đều bị lọc bỏ. Bạn có thể bao gồm bất kỳ hình ảnh nào đã tải lên trang Tệp trong bảng điều khiển quản trị Shopify.

Để thêm hình ảnh sản phẩm hoặc hình thu nhỏ vào phiếu đóng gói, hãy dùng biến line_item.image.

Ví dụ về biến phiếu đóng gói

Các ví dụ sau cho thấy cách bạn có thể sử dụng một số biến phiếu đóng gói.

now

Bạn có thể dùng định dạng sau để hiển thị ngày và giờ hiện tại:

{{ "now" | date: "%Y-%m-%d %H:%M" }}

Đầu ra là:

2018-09-10 14:23

line_items_in_shipment

Biến line_items_in_shipment hiển thị một mảng các mục hàng có trong lô hàng.

Ví dụ:

{% for line_item in line_items_in_shipment %}
  {{ line_item.title }}
  {{ line_item.variant_title }}
  ...
{% endfor %}

Các trường được trả về trong mỗi mục nhập line_item như sau:

line_item.image
line_item.title
line_item.variant_title
line_item.sku
line_item.vendor
line_item.quantity
line_item.shipping_quantity
line_item.properties
line_item.groups

line_item.groups

Nếu cửa hàng của bạn sử dụng gói sản phẩm hoặc tiện ích bổ sung, bạn có thể hiển thị thông tin nhóm cho từng mục hàng:

{% for group in line_item.groups %}
  {% if group.deliverable? %}
    Add-on for: {{ group.title }}
  {% else %}
    Part of: {{ group.title }}
  {% endif %}
{% endfor %}

line_item.image

Bạn có thể hiển thị hình ảnh cho mục hàng của mình bằng định dạng sau:

{% if line_item.image != blank %}
  {{ line_item.image | img_url: '58x58' | img_tag }}
{% endif %}

Bạn có thể hiển thị số lượng và số lượng vận chuyển cho các mục hàng bằng định dạng sau:

{{ line_item.shipping_quantity }} of {{ line_item.quantity }}

Ví dụ, hệ thống có thể hiển thị:

2 of 5

includes_all_line_items_in_order

Bạn có thể sử dụng biến này để hiển thị thông báo nếu đang vận chuyển một số mặt hàng trong đơn hàng. Ví dụ:

{% unless includes_all_line_items_in_order %}
  There are other items from your order not included in this shipment.
{% endunless %}