裝箱單變數參考

裝箱單是以 Liquid 呈現，Liquid 是 Shopify 建立的範本語言。

若要變更裝箱單範本，請在 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	您商店的州或省代碼。舉例來說，安大略省的省代碼為 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`。使用 date 篩選器變更格式。

顧客變數

使用此表中的變數，將顧客資訊加入裝箱單。您可以在 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	顧客的州或省代碼。舉例來說，安大略省的省代碼為 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 %}