通知变量参考

从商店发出的通知是使用 Liquid 呈现的。Liquid 是 Shopify 的简单易用的编程语言。我们在模板商店中提供的模板也是采用这种编程语言构建的。

若要编辑从商店发送的通知,您可以对您的通知模板进行基本的自定义

若要获取有关更高级的更改或更改自定义通知模板的帮助,您可以访问我们论坛上的社区,也可以聘请一位 Shopify 专家来为您完成自定义工作。

以下是您可以从 Shopify 后台自定义的 Liquid 通知模板的列表:

  • 弃单
  • 联系客户
  • 客户账户邀请
  • 客户账户欢迎
  • 客户账户密码重置
  • 草稿订单发票
  • 发货请求
  • 礼品卡已创建
  • 新订单
  • 新订单(移动版)
  • 订单已取消
  • 订单确认
  • POS 和移动收据
  • 订单退款
  • 发货确认
  • 发货更新信息

Shopify 后台中的所有模板都可以访问相应订单的属性。

订单属性

一个订单的许多属性可以直接通过使用 Liquid、模板和自定义脚本获取。

以下模板中提供订单的属性:

  • 订单确认
  • 新订单
  • 新订单(移动版)
  • 发货确认
  • 发货更新信息
  • 自定义脚本
  • 发货请求

注:与大多数其他 Liquid 对象不同,订单对象在电子邮件模板中不按名称引用。例如,您应使用 {{ shipping_method.title }},而不是订单确认电子邮件模板中的 {{ order.shipping_method.title }}。但是,对于短信通知,订单属性则需要照常在前面加上 order

订单属性的描述
属性 描述
id

订单在系统范围内的唯一 ID,供内部使用。使用以下示例在商店的后台部分生成指向订单的链接。例如,在新订单模板中,您可以添加以下代码:

<a href="{{ shop.url }}/admin/orders/{{ id }}">查看订单</a>
email
与订单关联的电子邮件。
name

通常是一个 # 符号,后跟 order_number

示例:#1004

order_name
与名称相同。
order_number

订单在商店中的唯一编号,没有 # 前缀,店主也不会在商店偏好设置中为订单 ID 添加任何前缀或后缀。

例如:1004

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
包含 customer 输出属性的 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
附加至订单的备注。该备注可以从客户处获取以及/或者在您的后台界面的订单详情页中编辑。
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

查看登陆网站并从中提取引用参数。引用参数可以为:refsourcer

如果 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
取消订单时所选择的原因。可以为以下原因之一:库存客户已拒绝欺诈其他
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
包含 customer 输出属性的 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_itemssubtotal_line_items 列表中的每个 line 都具有以下属性。

提示:subtotal_line_items 返回用于计算订单的 subtotal_price 的订单项目。subtotal_line_items 排除小费订单项目。

订单项属性的描述
属性 描述
line.applied_discounts
(仅限 POS 和草稿订单)
应用于此产品的折扣列表,每个折扣都有 title(标题)、code(代码)、amount(金额)、savings(节省金额)和 type(类型)属性。
line.custom
(仅限草稿订单)
(布尔值)如果产品是草稿订单的自定义订单项目,则返回 true。
line.grams
单件产品的重量。
line.image
返回与此订单项目关联的图片的 URL。您还可以使用 img_url 筛选器筛选出特定的图片尺寸,例如 {{ line.image | img_url: 'small' }}
line.line_price
价格乘以该产品的数量。
line.original_line_price
在应用折扣之前,订单中包含的商品数量的总计价格。
line.final_line_price
订单项目中所有商品的总计价格,包括所有订单项目级别的折扣金额。
line.price
单个产品的价格。
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
订单项目多属性的相对 URL。相对 URL 不包含您商店的根 URL(mystore.myshopify.com)。
line.variant.barcode
与产品多属性相关联的条码。
line.variant.compare_at_price
与产品多属性相关的原价
line.variant.image
产品多属性的图片。如果为订单项目中的多属性分配了特定图片,则仅返回图片。
line.variant.sku
与产品多属性相关的 SKU。
line.variant.title

多属性的选项值,由 / 字符连接。

示例:小/红色

退款属性

退款电子邮件模板中提供了这些附加属性。此电子邮件模板用于通知客户已对其订单应用退款(全部或部分)。除以下变量外,您还可以使用订单电子邮件通知模板的任何可用变量:

退款属性的描述
属性 描述
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
(已弃用)
要通过特定的自定义发货平台发货的订单项目列表。(仅请求发货)
items_to_fulfill_count
(已弃用)
此请求要发货的产品总数。(仅请求发货)

Fulfillment_line_item 属性

fulfillment_line_items 列表中的每个 fulfillment_line 都具有以下属性。

发货订单项属性的描述
属性 描述
fulfillment_line.line_item
要发货的订单项目。这可以访问所有订单项目的属性
fulfillment_line.quantity
要发货的订单项目的数量。

配送属性

配送属性的描述
属性 描述
delivery_instructions
要与客户共享的本地配送信息。此信息由本地配送设置中的配送信息字段控制。

折扣属性

有两种类型的折扣属性。

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

描述如何选择购物车中的订单项目以应用折扣。可能的属性值包括:

  • 全部:此折扣适用于所有订单项目。
  • 已授权:此折扣适用于订单项目的特定子集,通常由条件定义。
  • 显式:此折扣适用于专门选择的订单项目或发货项目。
discount_application.target_type
折扣适用的商品类型(line_itemshipping_line)。
discount_application.title

面向客户的折扣名称。

示例:Welcome10 或 CBBWQQAKYBYY

discount_application.total_allocated_amount
折扣所节省的订单价格的总金额。
discount_application.type
折扣类型。可能的属性值包括:自动discount_code手动脚本
discount_application.value
折扣的值。
discount_application.value_type
折扣值的类型。可能的属性值包括:fixed_amount百分比

电子邮件通知属性

电子邮件通知属性的描述
属性 描述
shop.email_logo_url
在后台的自定义电子邮件模板部分中指定的 logo 的 URL。
shop.email_logo_width
在后台的自定义电子邮件模板部分中指定的 logo 宽度(像素)。
shop.email_accent_color
在后台的自定义电子邮件模板部分中指定的主题色的十六进制代码。

准备好开始使用 Shopify 进行销售了吗?

免费试用