通知變數參照

從您商店送出的通知，會使用 Liquid 進行轉譯。Liquid 是 Shopify 一種簡單又易於使用的程式語言，與我們在 佈景主題商店 中建立的佈景主題所使用的程式語言相同。

若要編輯從商店送出的通知，您可以對通知範本進行基本自訂。

如需進階變更或變更自訂通知範本的相關協助，可前往 Shopify 論壇中的社群，您將能在此獲得友善的協助與實用的建議。您也可以聘請 Shopify 專家為您執行自訂作業。

下列為您可以在商店管理員中自訂的 Liquid 通知範本：

• 未完成結帳作業
• 聯絡客戶
• 顧客帳號邀請
• 顧客帳號歡迎通知
• 顧客帳號密碼重設
• 訂單發票草稿
• 物流作業申請
• 禮品卡已建立
• 新訂單
• 新訂單 (行動版)
• 訂單已取消
• 訂單確認
• POS 及行動版收據
• 訂單退款
• 運送確認
• 運送狀態

管理員中的所有範本，均可存取其對應訂單的屬性：

訂單屬性

許多訂單屬性都能以 Liquid、在範本及其他指令碼中直接使用。

下列範本均可使用訂單屬性：

• 訂單確認
• 新訂單
• 新訂單 (行動版)
• 運送確認
• 運送狀態
• 其他指令碼
• 物流作業申請

備註

與其他大多數 Liquid 物件不同，訂單物件本身不會在任何電子郵件範本或新增至「其他指令碼」方塊的程式碼中以名稱參照。因此您應使用 {{ shipping_method.title }} 而非在您的訂單確認電子郵件範本中使用 {{ order.shipping_method.title }}。但針對 SMS 通知，訂單屬性必須照常加上 order。

訂單屬性說明

屬性	說明
id	供內部使用的訂單系統級唯一 ID。您可以在商店的管理員區段中使用它來產生訂單連結。例如，在您的「新增訂單」範本中，您可以放置： <a href="{{ shop.url }}/admin/orders/{{ id }}">檢視訂單</a>
email	與訂單相關聯的電子郵件。
name	order_number 後通常有一個英鎊符號，例如 Order #1004。
order_name	與名稱相同。
order_number	商店訂單的唯一編號 (例如「1004」)，前方不含「#」符號，亦不含店主於商店偏好設定中附加於訂單 ID 的任何前綴或後綴符號。
created_at	客戶建立訂單的日期與時間 (例如「2009-05-30T17:43:51+02:00」)。您可以使用日期篩選條件進行格式化。
tags	傳回所有訂單標籤。標籤會依英文字母順序傳回。請參閱 Liquid 變數參照文件以瞭解詳細資訊。
transactions	傳回此訂單的交易陣列。
tax_price	訂單中所有產品項目的合計稅金。
tax_lines	所收取的稅金會依「等級」劃分。 {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title	稅金名稱 (例如「QST」或「VAT」)。
tax_line.price	金額。
tax_line.rate	費率。若為 17.5%，系統將會傳回 0.175。
tax_line.rate_percentage	以人類可讀格式顯示的稅率。若為 0.175，系統將會傳回 17.5。
customer	包含客戶輸出屬性的客戶對象。
billing_address	帳單地址。
billing_address.first_name	客戶的名字。
billing_address.last_name	客戶的姓氏。
billing_address.company	用於開立帳單的公司名稱。
billing_address.phone	帳單地址的電話號碼。
shop.name	您的商店名稱。
shop.phone	商店的電話號碼。
subtotal_price	扣除任何商品項目折扣或購物車折扣後，訂單所有商品項目價格的總金額。小計金額不包含稅金 (除非稅金包含於價格中) 或運費。
discounts	折扣清單。
discounts_amount	套用於所有折扣的折扣金額 (例如 +$5.00)。
discounts_savings	全部折扣所省下的金額 (例如 -$5.00)。
total_price	訂單的總金額 (小計 + 運費 - 運費折扣 + 稅金)。
financial_status	目前的付款狀態。狀態可能為下列其中之一：「無」、「待處理」、「已授權」、「已付款」、「已作廢」、「已退款」。
requires_shipping	(布林值) 如果訂單中有至少一項產品需要出貨，系統會傳回 true。
shipping_method.title	運費費率名稱 (例如「標準運送」)。
shipping_method.price	包含任何運費折扣的運費金額。 範例：{{ shipping_method.price | money }}
shipping_price	運費價格。 範例：{{ shipping_price | money }}
shipping_address	運送地址。
shipping_address.first_name	運送地址的收件人名字。
shipping_address.company	運送地址的公司名稱。
shipping_address.phone	運送地址的電話號碼。
line_items	訂單中所有商品項目的清單。
item_count	所有商品項目數量的總和。
fulfillment_status	訂單的目前出貨狀態。狀態可能為下列其中之一：「未出貨」、「部分出貨」、「已出貨」。
note	附加於訂單的備註。備註可以從客戶取得，及/或於 Shopify 管理員的「訂單詳細資訊」頁面中編輯。
attributes	附加於訂單的任何屬性。 範例：{{ attributes.gift-note }}
referring_site	包含將客戶導向您商店的轉介網站 URL。 範例：https://www.google.com/?s=great+products
landing_site	包含客戶所使用的登陸網站路徑，亦即客戶抵達商店時所看見的第一個頁面。 範例：/products/great-product?ref=my-tracking-token
landing_site_ref	請查看登陸網站，並擷取其引用參數。引用參數可為：ref、source、r。 若 landing_site 為 /products/great-product?ref=my-tracking-token，則 landing_site_ref 將為 my-tracking-token。若您的參照等於特定值，您可以完成特定動作： {% if landing_site_ref == 'my-tracking-token' %} 我的動作... {% endif %}
cancelled	(布林值) 如果訂單已取消，系統會傳回 true。
cancelled_at	訂單取消的時間。
cancel_reason	取消訂單時所選擇的原因。原因可為下列其中之一：「庫存」、「客戶」、「詐騙」、「其他」。
has_high_risks?	如果訂單為高風險訂單，系統會傳回 true。
translate="no" unique_gateways	傳回訂單的唯一付款服務供應商清單。例如若客戶使用 Visa、Mastercard 和現金付款，傳回的清單將為 shopify_payments, cash。
location (POS only)	顯示訂單的實體位置。若要瞭解可用的地點屬性，請見此處。您可以在管理員的「地點」中設定地點。
order_status_url	返回該訂單之訂單狀態頁面的連結。
fulfilled_line_items (已停用)	已出貨完成的商品數目清單。
unfulfilled_line_items (已停用)	尚未完全出貨的商品項目清單。

訂單草稿屬性

訂單草稿屬性可用於「訂單草稿發票」電子郵件範本中，該範本可用於向客戶通知未付發票。

備註

您無法使用簡訊傳送訂單草稿通知。

訂單草稿屬性說明

屬性	說明
id	供內部使用的訂單草稿唯一 ID。
invoice_url	可供客戶前往使用 Shopify 的安全結帳作業支付發票款項的連結。
reserve_inventory_until	訂單草稿中商品項目的保留期限，例如：2015-05-30T17:43:51+02:00。 您可以使用 Liquid 日期篩選條件來格式化日期。
user	最後一個修改訂單草稿的員工。
user.name	最後一個修改訂單草稿的員工名稱。
user.email	最後一個修改訂單草稿的員工電子郵件地址。
email	與訂單草稿相關聯的電子郵件地址。
name	訂單草稿的唯一 number，前方加上 # 數字符號。
number	訂單草稿的唯一編號 (不含訂單前綴或後綴)。
created_at	客戶建立訂單草稿的日期與時間，例如：2009-05-30T17:43:51+02:00。 您可以使用 Liquid 日期篩選條件來格式化日期。
tags	傳回所有訂單標籤。標籤會依英文字母順序傳回。請參閱 Liquid 變數參照文件以瞭解詳細資訊。
tax_price	訂單草稿中所有商品項目的合計稅金。
tax_lines	所收取的稅金會依「等級」劃分。 {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title	稅金名稱，例如：QST 或 VAT。
tax_line.price	稅金金額。
tax_line.rate	以十進位格式顯示的稅率。例如：稅率 17.5% 將會傳回 0.175。
tax_line.rate_percentage	以百分比格式顯示的稅率。例如：稅率 0.175 將會傳回 17.5%。
customer	包含客戶輸出屬性的客戶對象。
billing_address	訂單草稿的帳單地址。
billing_address.first_name	客戶的名字。
billing_address.last_name	客戶的姓氏。
billing_address.company	帳單地址的公司名稱。
billing_address.phone	帳單地址的電話號碼。
shop.name	您的商店名稱
shop.phone	商店的電話號碼。
subtotal_price	扣除任何商品項目折扣或購物車折扣後，訂單草稿所有商品項目價格的總金額。小計金額不包含稅金 (除非稅金包含於價格中) 或運費。
discounts	折扣清單。
discounts_amount	套用於所有折扣的折扣金額 (例如 +$5.00)。
discounts_savings	全部折扣所省下的金額 (例如 -$5.00)。
total_price	訂單的總金額 (小計 + 運費 - 運費折扣 + 稅金)。
requires_shipping	如果訂單草稿中有至少一項產品需要出貨，系統會傳回 true。如果訂單草稿中沒有產品需要出貨，系統會傳回 false。
shipping_method.title	運費費率名稱 (例如「標準運送」)。
shipping_method.price	運送方式的價格。傳回與 shipping_price 相同的資訊。
shipping_price	運費價格。 您可以使用 Liquid 金額篩選條件來格式化此金額。
shipping_address	運送地址。 備註：有別於正式訂單，訂單草稿的運送地址可能不完整。
shipping_address.first_name	運送地址的收件人名字。
shipping_address.company	運送地址的公司名字。
shipping_address.phone	運送地址的電話號碼。
line_items	訂單草稿中所有商品項目的清單。
item_count	訂單草稿中所有商品項目數量的總和。
note	附加於訂單草稿的備註。備註可以從客戶取得，亦可於 Shopify 管理員的「訂單草稿詳細資訊」頁面中編輯。
location	訂單的實體位置。若要瞭解可用的地點屬性，請見此處。 您可以在 Shopify 管理員的「地點」頁面中設定地點。

商品項目屬性

在 line_items 清單中的每個 line，均具有下列屬性：

商品項目屬性說明

屬性	說明
line.applied_discounts (僅限 POS 和訂單草稿)	套用於此商品項目的折扣清單 (每項折扣都會包含「標題」、「折扣碼」、「金額」、「節省金額」及「類型」屬性)。
line.custom (僅限訂單草稿)	(布林值) 如果該項目為訂單草稿的自訂商品項目，系統會傳回 true。
line.grams	單一商品項目的重量。
line.image	傳回與此商品項目相關聯的圖片 URL。您也可以使用 img_url 篩選條件來取得特定的圖片尺寸，例如：{{ line.image | img_url: 'small' }}
line.line_price	價格乘以該商品項目的數量。
line.price	單一商品項目的價格。
line.properties	傳回商品項目的一系列自訂資訊。在將產品加入購物車之前，商品項目屬性是由客戶於產品頁面中指定。
line.quantity	商品項目的數量。
line.requires_shipping	(布林值) 如果商品系列的子類選項在產品頁面中已勾選「這是實體產品」核取方塊，系統會傳回 true。
line.variant.sku	與產品相關聯的 SKU。
line.taxable	(布林值) 如果商品系列的子類選項在產品頁面中有勾選「對此產品加收稅金」核取方塊，系統會傳回 true。
line.title	產品名稱，後方有一個短破折號，然後是子類選項名稱。子類選項名稱若為「預設標題」則不包含在內。
line.variant.barcode	與產品相關聯的條碼。
line.variant.image	產品子類選項的圖片。只有當商品項目中的子類選項有指派特定圖片時，才會回傳圖片。
line.product.vendor	商品項目的廠商。

退款屬性

這些附加屬性可用於「退款」電子郵件範本中。此電子郵件範本可用於通知客戶，退款 (全部或部分退款) 已套用於其訂單。除了下列變數之外，您也可以使用「訂單電子郵件」通知範本可用的任何變數：

退款屬性說明

屬性	說明
amount	退款金額。
refund_line_items	待退款的 Refund_line_items 清單。

Refund_line_item 屬性

在 refund_line_items 清單中的每個 refund_line，均具有下列屬性：

退款商品項目屬性說明

屬性	說明
refund_line.line_item	正在進行退款作業的 line_item，可存取所有的 line_item 屬性。
refund_line.quantity	待退款的商品項目數量。

訂單出貨屬性

這些附加屬性可用於「運送確認」、「運送狀態」及「訂單出貨要求」電子郵件範本中。

「運送確認」及「運送狀態」可用於通知您的客戶，其訂單中的部分或所有商品項目已經出貨完成，或為客戶提供最新的貨態資訊。

「訂單出貨要求」電子郵件範本，則可用於商店管理員中所定義的任何自訂訂單出貨服務。若要新增自訂訂單出貨服務，請前往「設定」>「運送」頁面，然後向下捲動至「訂單出貨作業/廠商直送」區段。

出貨作業屬性說明

屬性	說明
service_name	於「設定」>「運送」頁面中所定義的自訂服務名稱。(僅限訂單出貨要求)
fulfillment.estimated_delivery_at	預計配送日期是以下列任一貨運業者所提供的追蹤編號 (若有) 為依據：USPS、FedEx、UPS、Canada Post (僅現加拿大)。這項屬性僅在使用貨運業者運費計算時適用。
fulfillment.fulfillment_line_items	待出貨的 Fulfillment_line_items 清單。
fulfillment.item_count	所有商品項目數量的總和。正在出貨的商品項目總數。
fulfillment.requires_shipping	(布林值) 如果此訂單出貨要求需要運送，系統會傳回 true。
fulfillment.tracking_company	負責執行追蹤作業的公司。
fulfillment.tracking_numbers	追蹤編號清單。
fulfillment.tracking_urls	追蹤 URL 網址清單。
items_to_fulfill (已停用)	要藉由此項特定的自訂訂單出貨服務來出貨的商品項目清單。(僅限訂單出貨要求)
items_to_fulfill_count (已停用)	要藉由此要求來出貨的商品項目總數。(僅限訂單出貨要求)

Fulfillment_line_item 屬性

在 fulfillment_line_items 清單中的每個 fulfillment_line，均具有下列屬性。

出貨商品項目屬性說明

屬性	說明
fulfillment_line.line_item	正在出貨的 line_item。可存取所有的 line_item 屬性。
fulfillment_line.quantity	正在出貨的商品項目數量。

折扣屬性

折扣屬性說明

屬性	說明
discounts.first.code	可供客戶輸入以套用折扣的代碼。若要允許客戶輸入多個折扣碼，必須以迴圈輸入。
discounts.first.amount	訂單的總折扣金額。
discounts.first.savings	客戶使用折扣碼所省下的金額。
discounts.first.type	折扣類型 (FixedAmountDiscount、PercentageDiscount 或 ShippingDiscount)。

電子郵件通知屬性

電子郵件通知屬性說明

屬性	說明
shop.email_logo_url	管理員的「自訂電子郵件範本」區段中所指定的標誌 URL。
shop.email_logo_width	管理員的「自訂電子郵件範本」區段中所指定的標誌寬度 (單位為像素)。
shop.email_accent_color	管理員的「自訂電子郵件範本」區段中所指定的強調色十六進位碼。