通知變數參照
從您商店送出的通知,會使用 Liquid 進行轉譯。Liquid 是 Shopify 一種簡單又易於使用的程式語言,與我們建立佈景主題商店中的佈景主題所使用的程式語言相同。
若要編輯從商店送出的通知,您可以對通知範本進行基本自訂。
如需有關進階變更或變更自訂通知範本的協助,您可以在論壇中詢問社群成員,也可以聘僱 Shopify 專家為您進行自訂。深入瞭解如何聘請 Shopify 專家。
下列為您可以在 Shopify 管理介面中自訂的 Liquid 通知範本:
- 未完成結帳作業
- 聯絡客戶
- 顧客帳號邀請
- 顧客帳號歡迎通知
- 顧客帳號密碼重設
- 訂單發票草稿
- 物流作業申請
- 禮品卡已建立
- 新訂單
- 新訂單 (行動版)
- 訂單發票
- 訂單已取消
- 訂單確認
- 訂單退款
- 付款提醒
- POS 及行動版收據
- 運送確認
- 運送資訊更新
Shopify 管理介面中的所有範本,均可存取其對應訂單的屬性。
訂單屬性
許多訂單屬性都能以 Liquid、在範本及其他指令碼中直接使用。
下列範本均可使用訂單屬性:
- 訂單確認
- 新訂單
- 新訂單 (行動版)
- 訂單發票
- 運送確認
- 運送資訊更新
- 其他指令碼
- 物流作業申請
- 付款提醒
屬性 | 說明 |
---|---|
id |
供內部使用的系統級訂單唯一 ID。您可以使用下列範例,在商店的管理員區段中產生訂單連結。例如,在「新增訂單」範本中,您可以新增下列代碼: <a href="{{ shop.url }}/admin/orders/{{ id }}">檢視訂單</a> |
與訂單相關聯的電子郵件。 | |
name |
範例: #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 |
依「稅金類型」劃分的稅金:
|
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_price |
運費價格。 範例: |
shipping_address |
運送地址。 |
shipping_address.first_name |
運送地址的收件人名字。 |
shipping_address.company |
運送地址的公司名稱。 |
shipping_address.phone |
運送地址的電話號碼。 |
line_items |
訂單中所有商品項目的清單。 |
item_count |
所有商品項目數量的總和。 |
fulfillment_status |
訂單目前的出貨狀態,可能為下列其中之一:未出貨 、部分出貨 、已出貨 。 |
note |
附加於訂單的備註。備註可以從客戶取得,及/或於 Shopify 管理員的「訂單詳細資訊」頁面中編輯。 |
attributes |
附加於訂單的任何屬性。 範例: |
referring_site |
包含將客戶導向您商店的轉介網站 URL。 範例: |
landing_site |
包含客戶所使用的登陸網站路徑,亦即客戶抵達商店時所看見的第一個頁面。 範例: |
landing_site_ref |
請查看登陸網站,並擷取其引用參數。引用參數可為: 若 {% if landing_site_ref == 'my-tracking-token' %} 我的動作... {% endif %} |
cancelled |
(布林值) 如果訂單已取消,系統會傳回 true。 |
cancelled_at |
訂單取消的時間。 |
cancel_reason |
取消訂單時所選取的原因,可能為下列其中之一:庫存 、顧客 、付款遭拒 、詐騙 或其他 。 |
has_high_risks?(deprecated) |
如果訂單為高風險訂單,系統會傳回 true。 |
unique_gateways |
傳回訂單的唯一付款服務供應商清單。例如若客戶使用 Visa、Mastercard 和現金付款,傳回的清單將為 |
location (POS only) |
顯示訂單的實體地點。有數個地點屬性可供使用,請見此處。您可以在管理員介面的「地點」區域中設定地點。 |
order_status_url |
返回該訂單之訂單狀態頁面的連結。 |
fulfilled_line_items(deprecated) |
已出貨完成的商品數目清單。 |
unfulfilled_line_items(deprecated) |
尚未完全出貨的商品項目清單。 |
b2b? |
如果該訂單為企業對企業 (B2B) 訂單,系統會回傳 true。使用包含 B2B 變數的屬性來顯示相關資訊,例如公司名稱、公司地點和電子郵件地址。例如,您可以針對 B2B 訂單為範本新增頁首,並包含以下資訊:
|
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) 訂單上公司地點的帳單地址。 |
customer_order_url |
訂單草稿屬性
訂單草稿屬性可用於「訂單草稿發票」電子郵件範本中,該範本可用於向客戶通知未付發票。
屬性 | 說明 |
---|---|
id |
供內部使用的訂單草稿唯一 ID。 |
invoice_url |
可供客戶前往使用 Shopify 的安全結帳作業支付發票款項的連結。 |
reserve_inventory_until |
訂單草稿中商品項目的保留期限,例如: 您可以使用 Liquid 日期篩選條件來格式化日期。 |
user |
最後一個修改草擬訂單的員工。 |
user.name |
最後一個修改草擬訂單的員工姓名。 |
user.email |
最後一個修改草擬訂單的員工電子郵件地址。 |
與訂單草稿相關聯的電子郵件地址。 | |
name |
訂單草稿的唯一 number ,前方加上 # 數字符號。 |
number |
訂單草稿的唯一編號 (不含訂單前綴或後綴)。 |
created_at |
客戶建立訂單草稿的日期與時間,例如: 您可以使用 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 訂單為範本新增頁首,並包含以下資訊:
|
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) 訂單上公司地點的帳單地址。 |
付款排程屬性
付款提醒電子郵件範本提供付款排程屬性,可提醒顧客何時為付款到期日。
屬性 | 說明 |
---|---|
payment_schedule.amount_due |
付款排程的應付金額。 您可以使用 Liquid 金額篩選條件來設定金額格式。 |
payment_schedule.due_at |
付款排程的到期日。 您可以使用 Liquid 日期篩選條件來格式化日期。 |
payment_schedule.due_in_days |
付款排程尚未到期 (未付款) 時,距離到期日的天數。 |
payment_schedule.due_later? |
如果付款排程尚未付款且到期日未到,系統會傳回 true。 |
payment_schedule.number_of_days_overdue? |
付款排程過期時,超過到期日的天數。 |
payment_schedule.overdue? |
如果付款排程尚未付款且已過期,系統會傳回 true。 |
付款狀態屬性
屬性 | 說明 |
---|---|
has_pending_payment |
(布林值) 如果訂單有一筆有待付款的交易,則返回 true。 深入瞭解待處理付款。 |
buyer_action_required |
(布林值) 如果訂單有一筆有待付款的交易,並且需要買家操作來解除付款阻擋,則返回 true。當此值返回 true 且付款條件支援付款說明時, 深入瞭解 Liquid 交易對象。 |
商品項目屬性
在 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.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) |
要退款的品項數量。您可以使用此屬性,為訂單中已退款的品項新增識別碼。 例如: |
退款屬性
這些附加屬性可用於「退款」電子郵件範本中。此電子郵件範本可用於通知客戶,退款 (全部或部分退款) 已套用於其訂單。除了下列變數之外,您也可以使用「訂單電子郵件」通知範本可用的任何變數:
屬性 | 說明 |
---|---|
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.amount |
顧客在商品項目上省下的金額。若要允許顧客輸入多個折扣代碼,則必須以迴圈輸入。 |
discount_allocation.discount_application |
依商品項目金額分配套用的折扣。 |
Discount_application 屬性
在 discount_applications
清單中的每個 discount_application
,均具有下列屬性。
屬性 | 說明 |
---|---|
discount_application.target_selection |
說明一項折扣如何選取購物車中要提供折扣的商品項目,可能為下列其中之一:
|
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 |
管理員的「自訂電子郵件範本」區段中所指定的強調色十六進位碼。 |