通知變數參照

此頁面列印時間為 Dec 07, 2022。如須最新版本，請至 https://help.shopify.com/zh-TW/manual/orders/notifications/email-variables。

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

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

如需有關進階變更或變更自訂通知範本的協助，您可以在論壇中詢問社群成員，也可以聘僱 Shopify 專家為您進行自訂。深入瞭解如何聘請 Shopify 專家。

下列為您可以在 Shopify 管理介面中自訂的 Liquid 通知範本：

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

Shopify 管理介面中的所有範本，均可存取其對應訂單的屬性。

訂單屬性

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

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

  • 訂單確認
  • 新訂單
  • 新訂單 (行動版)
  • 訂單發票
  • 運送確認
  • 運送資訊更新
  • 其他指令碼
  • 物流作業申請
訂單屬性說明
屬性 說明 
id

供內部使用的系統級訂單唯一 ID。您可以使用下列範例，在商店的管理員區段中產生訂單連結。例如，在「新增訂單」範本中，您可以新增下列代碼：

<a href="{{ shop.url }}/admin/orders/{{ id }}">檢視訂單</a>
 
email
 與訂單相關聯的電子郵件。 
name

order_number 後通常有井字號。

範例: #1004

 
order_name
 與名稱相同。 
order_number

Shop 訂單的唯一編號，前方不含「#」符號，亦不含商店擁有人於商店偏好設定中新增至訂單 ID 的任何前綴或後綴符號。

範例：1004

 
created_at

顧客建立訂單的日期與時間。您可以使用日期篩選條件進行格式化。

範例：2009-05-30T17:43:51+02:00

 
payment_terms

付款條款規定了訂單的付款日期。

瞭解如何為訂單發票新增付款條款。

如需更多詳細資訊，請參閱 payment_terms 的 Liquid 參考。
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。若您的 ref 等於特定值，則可以執行特定動作：

{% if landing_site_ref == 'my-tracking-token' %} 我的動作... {% endif %}
 
cancelled
 (布林值) 如果訂單已取消，系統會傳回 true。 
cancelled_at
 訂單取消的時間。 
cancel_reason
 取消訂單時所選取的原因，可能為下列其中之一：庫存、顧客、付款遭拒、詐騙或其他。 
has_high_risks?
(deprecated)

如果訂單為高風險訂單，系統會傳回 true。

 
unique_gateways

傳回訂單的唯一付款服務供應商清單。例如若客戶使用 Visa、Mastercard 和現金付款，傳回的清單將為 shopify_payments, cash。

 
location (POS only)

顯示訂單的實體地點。有數個地點屬性可供使用，請見此處。您可以在管理員介面的「地點」區域中設定地點。

 
order_status_url

返回該訂單之訂單狀態頁面的連結。 

fulfilled_line_items
(deprecated) 		已出貨完成的商品數目清單。 
unfulfilled_line_items
(deprecated) 		尚未完全出貨的商品項目清單。 
b2b?

如果該訂單為企業對企業 (B2B) 訂單，系統會回傳 true。使用包含 B2B 變數的屬性來顯示相關資訊，例如公司名稱、公司地點和電子郵件地址。例如，您可以針對 B2B 訂單為範本新增頁首，並包含以下資訊：

{% if b2b? %}
        <p> Customer: {{ customer.name }}
        <p> Company: {{ company.name }}
        <p> Location: {{ company_location.name }}
      {% endif%}
      
company

企業對企業 (B2B) 訂單上您販售商品的對象公司。

 
company.name

企業對企業 (B2B) 訂單上的公司名稱。

 
company.id

企業對企業 (B2B) 訂單上的公司 ID。

 
company_location

企業對企業 (B2B) 訂單上的公司地點。向您購買商品的公司可以擁有多個地點。

 
company_location.name

企業對企業 (B2B) 訂單上的公司地點名稱。

 
company_location.id

企業對企業 (B2B) 訂單上公司地點的 ID 號碼。

 
company_location.shipping_address

企業對企業 (B2B) 訂單上公司地點的運送地址。

 
company_location.billing_address

企業對企業 (B2B) 訂單上公司地點的帳單地址。

訂單草稿屬性

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

訂單草稿屬性說明
屬性 說明 
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 管理員的「地點」頁面中設定地點。

 
b2b?

如果該訂單為企業對企業 (B2B) 訂單，系統會回傳 true。使用包含 B2B 變數的屬性來顯示相關資訊，例如公司名稱、公司地點和電子郵件地址。例如，您可以針對 B2B 訂單為範本新增頁首，並包含以下資訊：

{% if b2b? %}
          <p> Customer: {{ customer.name }}
          <p> Company: {{ company.name }}
          <p> Location: {{ company_location.name }}
        {% endif %}
        
company

企業對企業 (B2B) 訂單上您販售商品的對象公司。

 
company.name

企業對企業 (B2B) 訂單上的公司名稱。

 
company.id

企業對企業 (B2B) 訂單上的公司 ID。

 
company_location

企業對企業 (B2B) 訂單上的公司地點。向您購買商品的公司可以擁有多個地點。

 
company_location.name

企業對企業 (B2B) 訂單上的公司地點名稱。

 
company_location.id

企業對企業 (B2B) 訂單上公司地點的 ID 號碼。

 
company_location.shipping_address

企業對企業 (B2B) 訂單上公司地點的運送地址。

 
company_location.billing_address

企業對企業 (B2B) 訂單上公司地點的帳單地址。

商品項目屬性

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

商品項目屬性說明
屬性 說明 
line.applied_discounts
(POS and draft orders only) 		套用於此商品項目的折扣清單 (每項折扣都會包含「標題」、「折扣碼」、「金額」、「節省金額」及「類型」屬性)。 
line.custom
(Draft orders only) 		(布林值) 如果該項目為訂單草稿的自訂商品項目，系統會傳回 true。 
line.grams
 單一商品項目的重量。 
line.image
 傳回與此商品項目相關聯的圖片網址。您也可以使用 img_url 篩選條件以取得特定尺寸的圖片 (例如：{{ line.image | img_url: 'small' }}) 
line.line_price
 價格乘以該商品項目的數量。 
line.original_line_price
 套用折扣前，行中所含品項數量的合併價格。 
line.final_line_price
 商品項目中所有品項的合併價格，包含所有品項層級的折扣金額。 
line.price
 單一商品項目的價格。 
line.product.metafields

位於商品層級的中繼欄位。請使用以下語法：

line.product.metafields.NAMESPACE.KEY

 
line.product.title
 產品名稱， 
line.product.vendor
 品項的廠商。 
line.properties
 傳回項目的自訂資訊陣列。在將產品加入購物車之前，商品項目屬性是由顧客於產品頁面中指定。 
line.quantity
 商品項目的數量。 
line.requires_shipping
 (布林值) 如果商品系列的子類在產品頁面中已勾選「這是實體產品」核取方塊，系統會傳回 true。 
line.selling_plan_allocation
 傳回 selling_plan_allocation 物件，這說明販售的方案 (例如訂閱方案) 如何影響商品項目。 
line.taxable
 (布林值) 如果商品系列的子類在產品頁面中有勾選「對此產品加收稅金」核取方塊，系統會傳回 true。 
line.title
 產品名稱，後方有一個短破折號，接著是子類名稱。子類名稱若為「預設標題」則不包含在內。 
line.url
 商品項目子類的相對網址。相對網址不包含您商店的根網址 (mystore.myshopify.com)。 
line.line_item.variant.barcode
 與該產品子類相關聯的條碼。 
line.variant.compare_at_price
 售價與產品子類相關聯。 
line.variant.image
 產品子類選項的圖片。只有當商品項目中的子類選項有指派特定圖片時，才會回傳圖片。 
line.variant.metafields

位於子類層級的中繼欄位。請使用以下語法：

line.product.metafields.NAMESPACE.KEY

 
line.variant.sku
 與該產品子類相關聯的存貨單位 (SKU)。 
line.variant.title

子類的選項值，加上 / 字元。

範例：s / 紅色

 
line.refunded.quantity
(within refund notifications)

要退款的品項數量。您可以使用此屬性，為訂單中已退款的品項新增識別碼。

例如： {% if line.refunded_quantity > 0 %}已退款品項識別碼{% endif %}

退款屬性

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

退款屬性說明
屬性 說明 
amount
 退款金額。 
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、加拿大郵政 (僅適用於加拿大)。這項屬性僅在使用貨運業者計算費率時適用。 
fulfillment.fulfillment_line_items
 待出貨的出貨作業商品項目清單。 
fulfillment.item_count
 所有商品項目數量的總和。正在出貨的商品項目總數。 
fulfillment.requires_shipping
 (布林值) 如果此訂單出貨要求需要運送，系統會傳回 true。 
fulfillment.tracking_company
 負責執行追蹤作業的公司。 
fulfillment.tracking_numbers
 追蹤編號清單。 
fulfillment.tracking_urls
 追蹤 URL 網址清單。 
items_to_fulfill
(deprecated) 		藉由此特定自訂出貨服務的商品項目清單。(僅限出貨作業要求) 
items_to_fulfill_count
(deprecated) 		要藉由此要求來出貨的商品項目總數。(僅限訂單出貨要求)

Fulfillment_line_item 屬性

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

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

配送屬性

配送屬性說明
屬性 說明 
delivery_instructions
 可與顧客分享的當地配送資訊。此資訊受當地配送設定的配送資訊欄位控制。 
consolidated_estimated_delivery_time
 可以和顧客分享的訂單配送日期資訊。這項資訊由您在「運送和配送」頁面的「處理時間」設定控制。

折扣屬性

有兩種類型的折扣屬性。

discount_applications 說明品項的折扣原因及方式。

discount_allocations 說明特定的折扣如何影響商品項目，以及如何降低價格。您應在商品項目層級使用這項屬性。

您可以合併這些屬性，讓折扣資訊在商品項目或訂單層級顯示。

範例

此範例可用於檢查折扣是否已套用至商品項目。如果折扣未套用至訂單層級 (all)，此處就會顯示折扣名稱及金額。

{% if line.discount_allocations %}
    {% for discount_allocation in line.discount_allocations %}
        {% if discount_allocation.discount_application.target_selection != 'all' %}
            {{ discount_allocation.discount_application.title | upcase }}
            (-{{ discount_allocation.amount | money }})
        {% endif %}
    {% endfor %}
{% endif %}

結果可能會如下所示：

SPRING5 (-$5.00)

Discount_allocation 屬性

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

discount_allocation 屬性說明
屬性 說明 
discount_allocation.amount
 顧客在商品項目上省下的金額。若要允許顧客輸入多個折扣代碼，則必須以迴圈輸入。 
discount_allocation.discount_application
 依商品項目金額分配套用的折扣。

Discount_application 屬性

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

Discount_application 屬性說明
屬性 說明 
discount_application.target_selection

說明一項折扣如何選取購物車中要提供折扣的商品項目，可能為下列其中之一：

  • all：折扣適用於所有商品項目。
  • entitled：折扣適用於特定商品項目的子集，通常以一項條件定義。
  • explicit：折扣適用特別選取的商品項目或運送公司。
 
discount_application.target_type
 折扣適用的品項類型 (line_item 或 shipping_line)。 
discount_application.title

供顧客使用的折扣名稱。

範例：Welcome10 或 CBBWQQAKYBYY

 
discount_application.total_allocated_amount
 訂單價格減去折扣得到的總金額。 
discount_application.type
 折扣的類型，可能為下列其中之一：automatic、discount_code、manual 或 script。 
discount_application.value
 折扣價值。 
discount_application.value_type
 折扣的價值類型，可能為下列其中之一：fixed_amount 或 percentage 。

電子郵件通知屬性

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

準備好開始透過 Shopify 銷售商品了嗎？

免費試用