通知变量参考

您商店发出的通知是使用 Liquid 呈现的。Liquid 是 Shopify 推出的一种简单易用的编程语言。它与 Theme Store 中的模板所基于的编程语言相同。

若要编辑从您的商店发送的通知，您可以对通知模板进行基本自定义。若要访问您可以自定义的通知的完整列表，请在 Shopify 后台中转到通知页面。

如需获取有关更高级更改的帮助，或者要对自定义通知模板进行更改，您可以在我们的论坛上联系社区，也可以聘请 Shopify 合作伙伴为您进行自定义。详细了解如何聘请 Shopify 合作伙伴。

在此页面上

订单属性

订单的许多属性都可以直接通过 Liquid 和模板使用。

可在通知模板中与订单对象一起使用的 Liquid 属性的说明
属性	描述
`id`	供内部使用的订单的全系统唯一 ID。使用以下示例可在您商店的后台部分中生成指向订单的链接。例如，在您的新订单模板中，您可以添加以下代码： `查看订单`
`email`	与订单关联的电子邮件。
`name`	通常为 # 符号，后跟 `order_number`。示例：#1004
`order_name`	与 name 相同。
`order_number`	订单的商店唯一编号，不含 # 前缀，也不含店主在其商店偏好设置中为订单 ID 添加的任何前缀或后缀。示例：1004
`confirmation_number`	为订单随机生成的字母数字识别码，可能会向客户显示此识别码，而不是按顺序显示的订单名称。不保证此值为唯一值。示例：XPAV284CT
`created_at`	客户创建订单的日期和时间。您可以使用日期筛选器来设置此格式。示例：2009-05-30T17:43:51+02:00
`payment_terms`	支付条款指定了订单的应付款日期。了解如何将支付条款添加到订单发票中。有关更多详细信息，请参阅 payment_terms 的 Liquid 参考。
`destination`	商品应发往的目的地。
`tags`	返回订单所有标记的数组。标记按字母顺序返回。在生成通知电子邮件时，应用或平台功能动态应用的标记（例如 `Shopify Collective` 标记）可能不可用。若要检测来自特定功能的商品，请改为检查每个订单项目的产品级别标记。参阅 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`	当前支付状态。以下状态之一：nil、`pending`、`authorized`、`paid`、`voided`、`refunded`。
`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`	订单中所有订单项目的列表，包括数量为零的订单项目。订单项目在全额退款后数量会变为零。
`line_item_groups`(Orders and POS only)	订单中包含订单项目组成产品的所有订单项目组的列表。
`item_count`	所有商品数量的总和。
`fulfillment_status`	订单的当前发货状态。以下状态之一：`unfulfilled`、`partial`、`fulfilled`。
`note`	附加到订单的备注。该备注可从客户处获取，您也可以在后台的订单详细信息屏幕中对其进行编辑。
`attributes`	附加到订单的任何属性。示例：`{{ attributes.gift-note }}`
`metafields`	订单上的任何元字段。请使用以下语法： metafields.NAMESPACE.KEY
`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' %} My action... {% endif %}`
`cancelled`	（布尔值）如果订单已取消，则返回 true。
`cancelled_at`	订单取消的时间。
`cancel_reason`	取消订单时选择的原因。以下原因之一：`inventory`、`customer`、`declined`、`fraud` 或 `other`。
`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 money 筛选器设置此金额的格式。
`shipping_address`	收货地址。备注：与常规订单不同，草稿订单的收货地址可能不完整。
`shipping_address.first_name`	收货地址中的名字。
`shipping_address.company`	收货地址中的公司名称。
`shipping_address.phone`	收货地址中的电话号码。
`line_items`	草稿订单中所有订单项目的列表。
`item_count`	草稿订单中所有商品数量的总和。
`note`	附加到草稿订单的备注。该备注可以从客户处获取，也可以在您的 Shopify 后台的草稿订单详细信息页面中进行编辑。
`metafields`	草稿订单上的任何元字段。请使用以下语法： metafields.NAMESPACE.KEY
`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 订单上公司地点的账单地址。
`payment_methods`	可用于处理草稿总额的已保存付款方式的列表。
`payment_method.payment_instrument`	支付工具，其中包含有关已保存付款方式的详细信息。
`payment_method.payment_instrument.payment_type`	已保存的付款方式类型。例如“credit_card、apple_pay”
`payment_method.payment_instrument.credit_card_brand`	当 `payment_type` 为 “credit_card” 时，表示卡的品牌
`payment_method.payment_instrument.credit_card_company`	当 `payment_type` 为 “credit_card” 时，表示发卡公司
`payment_method.payment_instrument.credit_card_company`	当 `payment_type` 为 “credit_card” 时，表示卡的末 4 位数字

付款时间表属性

可在通知模板中与付款时间表对象一起使用的 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_item.bundle_components 列表中的每个 bundle_component 都具有以下属性。（仅限草稿订单）

可在通知模板中与套装组件对象一起使用的 Liquid 属性的说明
属性	描述
`bundle_component.image_url`	套装组件的图片 URL。
`bundle_component.product.title`	套装组件产品的标题。
`bundle_component.quantity`	套装组件的数量。
`bundle_component.variant.title`	套装组件多属性的选项值的当前名称，由 `/` 字符连接。示例：小号 / 红色

组件属性

line_item.components 列表中的每个 component 都具有以下属性。（仅限已放弃的结账） `

可在通知模板中与组件对象一起使用的 Liquid 属性的说明
属性	描述
`component.image_url`	组件的图片 URL。
`component.product.title`	组件产品的标题。
`component.quantity`	组件的数量。
`component.variant.title`	组件多属性的选项值的当前名称，由 `/` 字符连接。示例：小号 / 红色

订单项目属性

line_items 或 subtotal_line_items 列表中的每个 line 都具有以下属性。

可在通知模板中与订单项目对象一起使用的 Liquid 属性的说明
属性	描述
`line.applied_discounts`(POS and draft orders only)	应用于此商品的折扣列表（每个折扣都有 `title`、`code`、`amount`、`savings` 和 `type` 属性）。
`line.bundle_components`(Draft orders only)	作为此商品套装组件的订单项目列表。仅当此订单项目是套装产品时才返回列表。
`line.bundle_parent?`(Draft orders only)	（布尔值）如果订单项目是套装产品，则返回 true。
`line.components`(Abandoned checkout only)	作为此商品组件的订单项目列表。
`line.parent?`(Abandoned checkout only)	（布尔值）如果订单项目有组件，则返回 true。
`line.custom`(Draft orders only)	（布尔值）如果该商品是草稿订单的自定义订单项目，则返回 true。
`line.delivery_agreement`	与此订单项目关联的配送协议。
`line.grams`	单个商品的重量。
`line.groups`	商品的订单项目组。
`line.image`	返回与此订单项目关联的图片的 URL。您还可以使用 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`	订单项目多属性的相对 URL。相对 URL 不包含您商店的根 URL (`mystore.myshopify.com`)。
`line.variant.barcode`	与产品多属性关联的条码。
`line.variant.compare_at_price`	与产品多属性关联的市场价。
`line.variant.image`	产品多属性的图片。仅当订单项目中的多属性已分配特定图片时，才会返回图片。
`line.variant.metafields`	多属性级别的任何元字段。请使用以下语法： line.variant.metafields.NAMESPACE.KEY
`line.variant.sku`	与产品多属性关联的 SKU。
`line.variant.title`	多属性选项值的当前名称，由 `/` 字符连接。示例：小号 / 红色
`line.refunded.quantity`(within refund notifications)	要退款的商品的数量。您可以使用此属性向订单中的已退款商品添加识别码。例如：`{% if line.refunded_quantity > 0 %}已退款项目识别码{% endif %}`

在通知模板中检测 Shopify Collective 商品

Shopify Collective 标记会在发送订单确认电子邮件后应用于订单，因此在订单确认模板中，{% if tags contains 'Shopify Collective' %} 永远不会为 true。若要检测 Shopify Collective 商品，请改为检查每个订单项目的产品级别标记：

{% assign has_collective_item = false %}
{% for line in line_items %}
  {% if line.product.tags contains 'Shopify Collective' %}
    {% assign has_collective_item = true %}
  {% endif %}
{% endfor %}

{% if has_collective_item %}
  <!-- Collective-specific content -->
{% endif %}

订单项目群组属性

line_item_groups 列表中的每个 line_item_group 都具有以下属性。

可在通知模板中与订单项目群组对象一起使用的 Liquid 属性的说明
属性	描述
`line_item_group.display_title`	订单项目群组的标题。
`line_item_group.components`	属于该群组的订单项目组成产品列表。
`line_item_group.image`	订单项目群组的图片。
`line_item_group.product_id`	订单项目群组的产品 ID。
`line_item_group.variant`	订单项目群组的多属性对象。
`line_item_group.variant_id`	订单项目群组的多属性 ID。

退款属性

可在通知模板中与退款对象一起使用的 Liquid 属性的说明
属性	描述
`amount`	退款金额。
`refund_line_items`	要退款的退款订单项目列表。

退款订单项目属性

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_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_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_item_groups`	配送协议中包含捆绑订单项目组成产品的所有订单项目群组的列表。
`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 应用，然后在设置 > 通知下的 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`	客户可用于更新此合同的付款方式的 URL。
`shipping_address`	订阅的收货地址。如果订阅的是服务或数字产品，则返回 `nil`。
`billing_address`	订阅的账单地址。
`subtotal_price`	订阅订单项目的小计价格。
`shipping_price`	订阅的发货价格。
`total_tax`	订阅的总税款。
`total_price`	订阅的总价格。
`total_discounts`	订阅的总折扣。
`customer_self_serve_url`	客户可用于管理其订阅的自助服务 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`	指向订单项目产品多属性的产品详细信息页面的 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`	支付工具代表的付款方式类型。使用支付筛选器可输出图片 URL 或 SVG。
`credit_card_brand`	信用卡的品牌。
`credit_card_company`	信用卡公司的名称。
`credit_card_last_four_digits`	信用卡的后 4 位数字。

电子邮件通知属性

可在通知模板中与电子邮件通知对象结合使用的 Liquid 属性的描述。
属性	描述
`shop.email_logo_url`	在后台的自定义电子邮件模板部分中指定的 logo 的 URL。
`shop.email_logo_width`	在后台的自定义电子邮件模板部分中指定的 logo 宽度（像素）。
`shop.email_accent_color`	在后台的自定义电子邮件模板部分中指定的个性色的 HEX 代码。

商店抵扣额属性

包含有关商店抵扣额发放的详细信息的属性。

可在通知模板中与已发放商店抵扣额对象结合使用的 Liquid 属性的描述。
属性	描述
`issued_store_credit.amount`	已发放的商店抵扣额金额。您可以使用 Liquid money 筛选器设置此金额的格式。
`issued_store_credit.expires_at`	已发放的商店抵扣额将过期的日期和时间。您可以使用 Liquid 日期筛选器设置此日期的格式。
`issued_store_credit.balance_after_transaction`	发放抵扣额后商店抵扣额账户的余额。您可以使用 Liquid money 筛选器设置此金额的格式。
`customer`	包含客户输出属性的客户对象。