通知变量参考

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

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

若要获取有关更高级的更改或更改自定义通知模板的帮助,您可以访问我们的论坛上的社区 - 您通常会在此处找到友好且有用的建议。您还可以考虑聘请一位 Shopify 专家来为您完成自定义工作。

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

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

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

订单属性

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

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

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

备注:与大多数其他 Liquid 对象不同,订单对象本身未在任何电子邮件模板中或添加到附加脚本框的代码中按名称引用。因此,无需在订单确认电子邮件模板等内容中使用 {{ order.shipping_method.title }},而只需使用 {{ shipping_method.title }}。但是,对于短信通知,订单属性则需照常在前面加上 order

属性 描述
id

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

<a href="{{ shop.url }}/admin/orders/{{ id }}">查看订单</a>
email
与订单关联的电子邮件。
name
通常是一个 # 符号,后跟 order_number,例如订单 #1004。
order_name
与名称相同。
order_number
订单在商店中的唯一编号,例如 1004,没有井号 # 前缀,店主也不会在商店偏好设置中为订单 ID 添加任何前缀或后缀。
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 或增值税。
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
当前的付款状态。可能的属性值包括:“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
订单中所有订单商品的列表。
item_count
所有商品的数量总和。
fulfillment_status
订单的当前发货状态。可能的属性值包括:“unfulfilled”(未发货)、“partial”(部分发货)和“fulfilled”(已发货)。
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' %} 我的操作... {% 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增值税
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
运费名称,例如 Standard Shipping(标准运费)。
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_items 列表中的每个 line 都具有以下属性:

属性 描述
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.price
单个产品的价格。
line.properties
返回一组产品的自定义信息。在将产品添加到购物车之前,客户在产品页面上指定了订单商品属性
line.quantity
产品数量。
line.requires_shipping
(布尔值)如果针对产品多属性在产品页面上选中了需要运输复选框,则返回 true。
line.variant.sku
与产品相关的 SKU。
line.taxable
(布尔值)如果针对产品多属性在产品页面上选中了“需要收税”复选框,则返回 true。
line.title
用短划线连接产品名称和多属性名称,产品名称 - 多属性名称。为“默认标题”时,多属性名称则不包含在内。
line.variant.barcode
与产品相关的条码。
line.variant.image
产品多属性的图片。如果为订单项目中的多属性分配了特定图片,则仅返回图片。
line.product.vendor
产品的厂商。

退款属性

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

属性 描述
amount
退款金额。
refund_line_items
要退款的 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_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
要发货的订单项目的数量。

折扣属性

属性 描述
discounts.first.code
客户应用折扣需输入的代码。如果要允许多个折扣码,则必须在循环中输入。
discounts.first.amount
订单总额中因折扣而扣除的金额。
discounts.first.savings
客户因折扣代码而节省的金额。
discounts.first.type
折扣类型(FixedAmountDiscount、PercentageDiscountShippingDiscount)。

电子邮件通知属性

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

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

免费试用