装箱单变量参考

您的装箱单使用 Shopify 创建的模板语言 Liquid 进行呈现。

在 Shopify 后台发货和配送 页面的文档部分中，点击装箱单模板即可对装箱单模板进行更改。

本页内容

商店变量

使用此表中的变量可将有关您商店的详细信息添加到您的装箱单中。您可以在 Shopify 后台的通用设置页面中查找和编辑您的商店信息。

可在装箱单模板中使用的 Liquid 商店变量的说明
变量	描述
shop.name	您商店的名称。
shop.email	您的商店的电子邮件地址。
shop.domain	您的商店的域名。

商店地址变量

使用此表中的变量可将您的商店地址添加到装箱单中。您可以在 Shopify 后台的发货和配送页面中的 发货地部分查找和编辑您的地址详细信息。

可在装箱单模板中使用的 Liquid 商店地址变量的描述
变量	描述
shop_address.address1	您的商店地址。
shop_address.address2	您的商店的公寓或套房。
shop_address.company	您的公司名称。
shop_address.city	您的商店所在城市
shop_address.province_code	您的商店所在州或省的代码。例如，安大略省 (Ontario) 的省代码为 ON。
shop_address.province	您的商店所在州或省
shop_address.zip	您的商店的邮政编码。
shop_address.country_code	您的商店所在国家/地区代码。例如，加拿大的国家/地区代码为 CA。
shop_address.country	您的商店所在国家/地区。
shop_address.summary	您的商店的完整地址。

订单变量

使用此表中的变量可将有关订单的详细信息添加到装箱单中。您可以在 Shopify 后台的订单页面上查看订单列表。

可在装箱单模板中使用的 Liquid 订单变量的描述
变量	描述
order.order_number	不带任何前缀或后缀的订单号。例如：`1004`。
order.name	包含在 Shopify 后台通用设置页面上设置的任何前缀或后缀的订单号。例如：`#1004`。
order.note	与订单关联的备注（如果存在）。
order.created_at	创建订单的日期和时间。例如：`2009-05-30T17:43:51+02:00`。使用日期筛选更改格式。

客户变量

使用此表中的变量可将您的客户信息添加到装箱单中。您可以在 Shopify 后台的客户页面上查看订单列表。

可在装箱单模板中使用的 Liquid 客户变量的描述
变量	描述
customer.first_name	客户的名字。
customer.last_name	客户的姓氏。
customer.name	客户的全名。
customer.email	客户的电子邮件。

客户收货地址和账单地址变量

使用此表中的变量可将客户的收货地址或账单地址添加到装箱单中。您可以在 Shopify 后台的客户页面上查看订单列表。

可在装箱单模板中使用的 Liquid 客户地址变量的描述
变量	描述
shipping_address.address1 billing_address.address1	客户的地址。
shipping_address.address2 billing_address.address2	客户的公寓或套房。
shipping_address.first_name billing_address.first_name	客户的名字。
shipping_address.last_name billing_address.last_name	客户的姓氏。
shipping_address.name billing_address.name	客户的全名。
shipping_address.phone billing_address.phone	客户的电话号码。
shipping_address.company billing_address.company	客户收货地址中的公司名称。
shipping_address.city billing_address.city	客户所在城市。
shipping_address.province_code billing_address.province_code	客户所在州或省的代码。例如，安大略省 (Ontario) 的省代码为 ON。
shipping_address.province billing_address.province	客户所在州或省。
shipping_address.zip billing_address.zip	客户的邮政编码。
shipping_address.country_code billing_address.country_code	您的客户所在国家/地区代码。例如，加拿大的国家/地区代码为 CA。
shipping_address.country billing_address.country	客户所在国家/地区。
shipping_address.summary billing_address.summary	您的客户的完整地址。

货件中的订单项目变量

使用此表中的变量可将产品详细信息添加到您的装箱单。若要查看订单中的产品，请转到 Shopify 后台的订单页面，然后点击订单号。

可在装箱单模板中使用的 Liquid 货件中订单项目变量的描述
变量	描述
line_items_in_shipment	属于同一货件的订单项目列表。各个订单项目可位于循环中，如 line_item： `{% for line_item in line_items_in_shipment %} {{ line_item.image }} {{ line_item.title }} ... {% endfor %}` line_item 的所有可用属性如下： `line_item.image` - 产品图片（如果存在）。 `line_item.title` - 产品名称。如果产品具有多个多属性，则也会包含多属性名称。 `line_item.variant_title` - 产品多属性名称。 `line_item.vendor` - 产品厂商。 `line_item.sku` - 产品的 SKU。 `line_item.quantity` - 该产品的总数量。 `line_item.shipping_quantity` - 在该货件中发货的该产品数量。 `line_item.properties` - 产品属性。 `line_item.groups` - 产品所属的订单项目群组列表，例如套装或附加服务。每个群组具有以下属性： `group.title` - 群组的显示标题。 `group.deliverable?` - 如果订单项目是父级产品的附加服务，则返回 `true`；如果订单项目是套装的一部分，则返回 `false`。
includes_all_line_items_in_order	布尔值如果为 `true`，则订单中的所有商品均包含在货件中。如果为 `false`，则并非订单中的所有商品都包含在货件中。

图片

只允许使用来自 https://cdn.myshopify.com/ 域名的图片。所有其他图片都会被筛选掉。您可以添加您已上传到 Shopify 后台文件页面的任何图片。

若要将产品图片或缩略图添加到装箱单中，请使用 line_item.image 变量。

装箱单变量示例

以下示例说明了如何使用部分装箱单变量。

now

您可以使用以下格式显示当前时间和日期：

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

输出为：

2018-09-10 14:23

line_items_in_shipment

line_items_in_shipment 变量显示一个包含在货件中的订单项目的数组。

例如：

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

每个 line_item 条目中返回的字段如下：

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

如果您的商店使用套装或附加服务，您可以显示每个订单项目的群组信息：

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

line_item.image

您可以使用以下格式显示订单项目的图片：

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

您可以使用以下格式显示订单项目的数量和发货数量：

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

例如，这可以显示：

2 of 5

includes_all_line_items_in_order

如果您要为订单中的部分商品发货，则可使用此变量来显示一条消息。例如：

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