通知變數參照

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

若要編輯從商店送出的通知，您可以對通知範本進行基本自訂。若要存取您可以自訂的完整通知清單，請前往 Shopify 管理介面中的「通知」頁面。

如需協助進行進階變更或變更自訂通知範本，您可以在論壇中詢問社群成員，也能聘僱 Shopify 合作夥伴為您代勞自訂。深入瞭解如何聘僱 Shopify 合作夥伴。

此頁面上

訂單屬性

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

可與訂單物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
id	供內部使用的系統級訂單唯一 ID。您可以使用下列範例，在商店的管理員區段中產生訂單連結。例如，在「新增訂單」範本中，您可以新增下列代碼： <a href="{{ shop.url }}/admin/orders/{{ id }}">檢視訂單</a>
email	與訂單相關聯的電子郵件。
name	`order_number` 後通常有井字號。範例: #1004
order_name	與名稱相同。
order_number	Shop 訂單的唯一編號，前方不含「#」符號，亦不含商店擁有人於商店偏好設定中新增至訂單 ID 的任何前綴或後綴符號。範例：1004
confirmation_number	可能會向顧客顯示的隨機產生訂單英數識別碼，而不是按照順序顯示訂單名稱。此值不一定是唯一的。範例：XPAV284CT
created_at	顧客建立訂單的日期與時間。您可以使用日期篩選條件進行格式化。範例：2009-05-30T17:43:51+02:00
payment_terms	付款條款規定了訂單的付款日期。瞭解如何為訂單發票新增付款條款。如需更多詳細資訊，請參閱 payment_terms 的 Liquid 參考。
destination	品項應送達的收件地。
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	訂單中所有商品項目的清單。
line_items_including_zero_quantity	訂單中所有商品項目清單，包括數量為零的商品項目。全額退款後，商品項目的數量為零。
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) 訂單上公司地點的帳單地址。
customer_order_url	客戶要求使用新顧客帳號退貨的訂單新訂單詳細資訊頁面。

訂單草稿屬性

可與訂單草稿物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
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	訂單的總金額 (小計 + 運送成本 - 運送成本折扣 + 稅金)。
amount_due_now	訂單發票草稿所需的金額。
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) 訂單上公司地點的帳單地址。

付款排程屬性

可與付款排程物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
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。

付款狀態屬性

可與付款狀態物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
has_pending_payment	(布林值) 如果訂單有一筆有待付款的交易，則返回 true。深入瞭解待處理付款。
buyer_action_required	(布林值) 如果訂單有一筆有待付款的交易，並且需要買家操作來解除付款阻擋，則返回 true。當此值返回 true 且付款條件支援付款說明時，`buyer_pending_payment_instructions` 提供買家可用於離線購買的詳細資訊。深入瞭解 Liquid 交易對象。

商品項目屬性

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

可與商品項目物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
line.applied_discounts (POS and draft orders only)	套用於此商品項目的折扣清單 (每項折扣都會包含`「標題」`、`「折扣碼」`、`「金額」`、`「節省金額」`及`「類型」`屬性)。
line.bundle_components (Draft orders only)	作為這個品項的套裝元件的商品項目清單。僅在這個商品項目是套裝組合商品時，才會傳回清單。
line.bundle_parent? (Draft orders only)	(布林值) 如果該商品項目是套裝組合商品，系統會傳回 true。
line.custom (Draft orders only)	(布林值) 如果該項目為訂單草稿的自訂商品項目，系統會傳回 true。
line.delivery_agreement	與此商品項目相關聯的配送協議。
line.grams	單一商品項目的重量。
line.image	傳回與此商品項目相關聯的圖片網址。您也可以使用 img_url 篩選條件以取得特定尺寸的圖片 (例如：`{{ line.image \| img_url: 'small' }}`)
line.line_price	價格乘以該商品項目的數量。
line.original_line_price	套用折扣前，行中所含品項數量的合併價格。
line.final_line_price	商品項目中所有品項的合併價格，包含所有品項層級的折扣金額。
line.pre_tax_price	商品項目的稅前價格，乘以購買的商品項目數量。
line.price	單一商品項目的價格。
line.product.metafields	位於商品層級的中繼欄位。請使用以下語法： line.product.metafields.NAMESPACE.KEY
line.product.title	目前商品名稱。
line.product.vendor	品項的廠商。
line.properties	傳回項目的自訂資訊陣列。在將產品加入購物車之前，商品項目屬性是由顧客於產品頁面中指定。
line.quantity	商品項目的數量。
line.current_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)	要退款的品項數量。您可以使用此屬性，為訂單中已退款的品項新增識別碼。例如： `{% if line.refunded_quantity > 0 %}已退款品項識別碼{% endif %}`

退款屬性

可與退款物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
amount	退款金額。
refund_line_items	待退款的退款商品項目清單。

Refund_line_item 屬性

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

可與退款商品項目物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
refund_line.line_item	正在進行退款作業的 line_item，可存取所有的 line_item 屬性。
refund_line.quantity	待退款的商品項目數量。

出貨作業屬性

可與出貨物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
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，均具有下列屬性。

可與出貨商品項目物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
fulfillment_line.line_item	正在出貨的 line_item。可存取所有的 line_item 屬性。
fulfillment_line.quantity	正在出貨的商品項目數量。

備妥的包裹屬性

備妥的包裹包含標示為「備妥可供取貨」的品項。

可與備妥的包裹物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
item_count	備妥的包裹中所有品項數量的總和。
prepared_package_line_items	備妥的包裹商品項目清單。

Prepared_package_line_item 屬性

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

可與備妥的包裹商品項目物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
line_item	相關聯的 line_item，可存取所有的 line_item 屬性。
quantity	已標示為「備妥可供取貨」的商品項目數量。

配送屬性

可與配送物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
delivery_agreements	訂單的所有配送協議清單。
delivery_instructions	可與顧客分享的當地配送資訊。此資訊受當地配送設定的配送資訊欄位控制。
consolidated_estimated_delivery_time	可以和顧客分享的訂單配送日期資訊。這項資訊由您在「運送和配送」頁面的「處理時間」設定控制。當訂單有多個配送方式時，系統會顯示配送方式和日期的清單。
has_multiple_delivery_methods	(布林值) 如果訂單有多個配送方式，系統會傳回 true。

配送協議屬性

可與配送協議物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
delivery_agreement.delivery_method_type	配送方式類型。
delivery_agreement.delivery_method_name	若買家結帳時使用的語言與預設商店語言不同，配送方式類型會翻譯為買家結帳所用的語言。
delivery_agreement.line_items	與此配送協議相關聯的所有商品項目清單。

折扣屬性

有兩種類型的折扣屬性。

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 物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
discount_allocation.amount	顧客在商品項目上省下的金額。若要允許顧客輸入多個折扣代碼，則必須以迴圈輸入。
discount_allocation.discount_application	依商品項目金額分配套用的折扣。

Discount_application 屬性

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

可與 discount_application 物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
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` 。

訂閱屬性

所有訂閱電子郵件範本皆提供訂閱合約、目前帳單週期、商品項目、配送方式及付款方式的詳細資訊。

若要編輯訂閱通知範本，請安裝Shopify Subscriptions 應用程式，然後在「訂閱」區段下前往「設定」>「通知」尋找該範本。

訂閱合約帳單週期屬性

若要存取訂閱合約及其帳單週期的屬性，請使用 subscription_contract_billing_cycle 物件。

範例

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

結果：

This contract is currently paused.

屬性

可與訂閱合約帳單週期物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
status	合約狀態。狀態為以下其中之一：`active` (啟用中)、`paused` (暫停)、`cancelled` (已取消)、`failed` (失敗)、`expired` (已到期)、`stale` (過時)
delivery_method	訂閱項目的配送方式。如果訂閱項目為服務或數位商品，則 nil 為傳回的訊息。
billing_frequency	訂閱項目計費頻率。
delivery_frequency	訂閱項目配送頻率。
origin_order	首次建立訂閱的原始訂單。如果未使用 Shopify 訂單建立訂閱，則傳回 `nil`。
customer	訂閱的顧客。
line_items	訂閱帳單週期中的商品項目。
product_names	訂閱帳單週期中所含的商品名稱清單。
update_payment_method_url	顧客欲更新合約的付款方式時可用的網址。
shipping_address	訂閱項目的運送地址。如果訂閱項目為服務或數位商品，則傳回 `nil`。
billing_address	訂閱項目的帳單地址。
subtotal_price	訂閱商品項目的小計價格。
shipping_price	訂閱項目的運費。
total_tax	訂閱項目的總稅額。
total_price	訂閱項目總價。
total_discounts	訂閱項目的總折扣額。
customer_self_serve_url	顧客欲管理訂閱時可用的自助式網址。
billing_attempt_expected_date	此帳單週期的結帳日期。
next_billing_date	此帳單週期後的下一個結帳日期 (不予略過)。
last_attempted_billing_date	此帳單週期的最後一個嘗試結帳日期。
days_overdue	此帳單週期的帳單過期天數。
payment_instrument	與訂閱合約關聯的付款工具。此付款工具用於為顧客計費。

訂閱合約商品項目屬性

帳單週期中每個商品項目的屬性。透過上層屬性 subscription_contract_billing_cycle.line_items 存取合約商品項目屬性。

範例

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}

可與訂閱合約商品項目物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
url	商品項目子類選項的商品細節頁面網址。
requires_shipping	商品項目是否需要實體運送。
unit_price_measurement	商品項目的單價計價單位。
selling_plan_allocation	商品項目的銷售方案分配。

訂閱合約配送方式屬性

此帳單週期中所用配送方式的屬性。透過上層屬性 subscription_contract_billing_cycle.delivery_method 存取配送方式屬性。

範例

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}

可與訂閱合約配送方式物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
title	此配送方式的關聯運送選項名稱。
type	配送方式類型。類型為以下其中之一：`shipping` (運送)、`local` (當地配送) 或 `pick-up` (到店取貨)。

訂閱合約付款工具屬性

關於訂閱合約付款工具的詳細資訊。此付款工具用於為顧客計費。透過上層屬性 subscription_contract_billing_cycle.payment_instrument 存取付款工具屬性。

範例

{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}

<img src="{{ instrument.payment_type | payment_type_img_url }} " alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}

可與訂閱合約付款工具物件一同用於通知範本的 Liquid 屬性說明
屬性	說明
payment_type	付款工具所代表的付款方式類型。使用付款篩選條件輸出圖片網址或可擴充向量圖形 (SVG)。
credit_card_brand	信用卡品牌。
credit_card_company	信用卡公司名稱。
credit_card_last_four_digits	信用卡卡號末 4 碼。

電子郵件通知屬性

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