SHOPIFY帮助指南
通知变量参考
从您的商店发出的通知使用Liquid呈现。 Liquid是Shopify简单易用的编程语言。它与我们在Theme Store中的主题构建的编程语言相同。
要编辑从商店发送的通知,您可以对通知模板进行基本自定义。
有关更多高级更改的帮助或更改自定义通知模板,您可以在我们的论坛上与社区联系 – 您经常会在那里找到友好和有用的建议。您也可以考虑聘请Shopify专家为您进行自定义。
以下是您可以从商店管理员自定义的Liquid通知模板列表:
- 弃单
- 联系客户
- 客户账户邀请
- 客户账户欢迎
- 客户账户密码重置
- 订单发票草稿
- 履行要求
- 礼品卡创建
- 新命令
- 新订单(手机)
- 订单已取消
- 订单确认
- POS和移动收据
- 订单退款
- 装运确认
- 送货更新
管理员中的所有模板都可以访问相应订单的属性。
相关主题
- 订单属性
- 草稿订单属性
- 订单项属性
- 退款属性
- 履行属性
- 折扣属性
- 电子邮件通知属性
订单属性
订单的许多属性可以使用Liquid,模板和其他脚本直接获得。
以下模板中提供了订单的属性:
- 订单确认
- 新命令
- 新订单(手机)
- 装运确认
- 送货更新
- 其他脚本
- 履行要求
注意
与大多数其他Liquid对象不同,订单对象本身不会在任何电子邮件模板中添加名称或添加到“附加脚本”框中的代码。 因此,不要在订单确认电子邮件模板中使用{{order.shipping_method.title}},而只需使用{{shipping_method.title}}但是,对于SMS通知,通常订单属性需要以订单为前缀。
属性 | 简介 |
---|---|
id | 系统范围内部使用订单的唯一ID。 使用此 e.g. 生成商店管理部分中订单的链接。 例如,在您的**新订单**模板中,您将放置: |
与订单关联的电子邮件。 | |
name | 通常,这是一个英镑符号,后跟order_number,例如 订单#1004。 |
order_name | 与名称相同。 |
order_number | 购买订单的唯一编号,例如 1004,没有磅#前缀,或者店主在他的商店偏好中添加到订单ID的任何前缀或后缀。 |
created_at | 客户创建订单的日期和时间,例如2009-05-30T17:43:51+ 02:00。 您可以使用日期过滤器对其进行格式化。 |
tags | 返回所有订单标签的数组。 标签按字母顺序返回。 有关详细信息,请参阅我们的Liquid参考文档。 |
transaction | 通知可以访问每个事务属性。 有关这些属性的完整列表,请参阅我们的Transaction API文档。 |
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对象。 |
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 | (boolean)如果订单中至少有一个项目需要发货,则返回true。 |
shipping_method.title | 运费率名称,例如 “标准运输”。 |
shipping_method.price | 与shipping_price相同。 |
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 | 包含将客户带到您商店的引荐来源网址。 例如: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 | (boolean)如果订单已被取消,则返回true。 |
cancelled_at | 订单取消的时间。 |
cancel_reason | 取消订单时选择的原因。 其中之一:'库存','客户','欺诈','其他'。 |
has_high_risks? | 如果订单具有高风险,则返回true |
unique_gateways | 返回订单上唯一支付提供商的列表。 例如,如果有人使用Visa,万事达卡和现金付款,则返回的列表将为“shopify_payments,cash”。 |
location (POS only) | 显示订单的物理位置。 这里列出了几个可用的位置属性。 您可以在管理员的“位置”区域中配置位置。 |
order_status_url | 返回此订单的订单状态页面的链接。 |
fulfilled_line_items (deprecated) | 已完成的行项目列表。 |
unfulfilled_line_items (deprecated) | 尚未完全履行的行项目列表。 |
草稿订单属性
草稿订单发票电子邮件模板上提供了草稿订单属性,该模板通知您的客户未完成的发票。
注意
您无法使用SMS发送草稿订单通知。
属性 | 简介 |
---|---|
id | 供内部使用的草稿订单的唯一ID。 |
invoice_url | 客户可以使用Shopify安全结账支付发票的链接。 |
reserve_inventory_until | 保留草稿中行项目的日期和时间,例如,2015-05-30T17:43:51 + 02:00。 您可以使用Liquid日期过滤器格式化日期。 |
user | 修改草案订单的最后一名工作人员。 |
user.name | 修改草稿订单的最后一名工作人员的姓名。 |
user.email | 修改草稿订单的最后一名工作人员的电子邮件地址。 |
与草稿订单关联的电子邮件地址。 | |
name | 草稿订单的唯一编号,以数字符号#为前缀。 |
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对象。 |
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 money过滤器格式化此金额。 |
shipping_address | 送货地址。 注意:与常规订单不同,草稿订单的送货地址可能不完整。 |
shipping_address.first_name | 送货地址的第一个名称。 |
shipping_address.company | 送货地址上的公司名称。 |
shipping_address.phone | 送货地址中的电话号码。 |
line_items | 草稿订单中所有订单项的列表。 |
item_count | 草稿订单中所有项目数量的总和。 |
note | 该草案附有说明。 该笔记可以从客户处获得,也可以在Shopify管理员的草稿订单详细信息屏幕中进行编辑。 |
location | 订单的物理位置。 有几个位置属性可用。 您可以在Shopify管理员的“位置”页面中配置位置。 |
订单项属性
line_items列表中的每一行都具有以下属性:
属性 | 简介 |
---|---|
line.applied_discounts (POS and draft orders only) | 应用于此项目的折扣列表(每个折扣都有标题,代码,金额,节省和类型属性)。 |
line.custom (Draft orders only) | (boolean)如果项是草稿订单的自定义行项,则返回true。 |
line.grams | 单个物品的重量。 |
line.image | 返回与此订单项关联的图片的网址。 您还可以使用img_url过滤器来获取特定的图像大小,例如{{line.image | img_url:'small'}} |
line.line_price | 价格乘以该商品的数量。 |
line.price | 单个商品的价格。 |
line.properties | 返回项的自定义信息数组。 在将产品添加到购物车之前,客户在产品页面上指定订单项属性。 |
line.quantity | 该项目的数量。 |
line.requires_shipping | (boolean)如果项目的变体具有复选框**,则返回true。这是在产品页面上检查的物理产品**。 |
line.sku | 与产品相关的SKU。 |
line.taxable | (boolean)如果项目的变量在产品页面上选中了“对此产品征收税”复选框,则返回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 | 要退款的订单项的数量。 |
履行属性
这些附加属性可在“运输确认”,“运输更新”和“履行”请求电子邮件模板中找到。
发货确认和发货更新用于通知您的客户其订单中的部分或全部商品已成功完成,或使用新的发货信息进行更新。
Fulfillment请求电子邮件模板用于商店管理员中定义的任何自定义实施服务。 要添加自定义配送服务,请转到设置>送货页面,然后向下滚动到“配送/送货”部分。
属性 | 简介 |
---|---|
service_name | “设置”>“送货”页面中定义的自定义服务的名称。 (仅限满足要求) |
fulfillment.estimated_delivery_at | 预计交付日期基于以下运营商之一提供的跟踪号码(如果有):USPS,FedEx,UPS,Canada Post(仅限加拿大)。 此属性仅在运营商计算的费率使用时可用。 |
fulfillment.fulfillment_line_items | 要履行的Fulfillment Line_items列表。 |
fulfillment.item_count | 所有项目数量的总和。 正在履行的项目总数。 |
fulfillment.requires_shipping | (boolean)如果此履行请求需要发货,则返回true。 |
fulfillment.tracking_company | 该公司正在进行跟踪。 |
fulfillment.tracking_numbers | 跟踪号码列表。 |
fulfillment.tracking_urls | 跟踪网址列表。 |
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 | 正在履行的订单项的数量。 |
折扣属性
属性 | 简介 |
---|---|
discounts.first.code | 客户输入的代码以应用折扣。 如果要允许多个折扣代码,则必须在循环中输入。 |
discounts.first.amount | 从订单总额中扣除的金额。 |
discounts.first.savings | 由于折扣代码,客户节省的金额。 |
discounts.first.type | 折扣类型(FixedAmountDiscount,PercentageDiscount或ShippingDiscount)。 |
电子邮件通知属性
属性 | 简介 |
---|---|
shop.email_logo_url | 管理员的“自定义电子邮件模板”部分中指定的图标的网址。 |
shop.email_logo_width | 管理员的“自定义电子邮件模板”部分中指定的图标宽度(像素)。 |
shop.email_accent_color | 管理员的“自定义电子邮件模板”部分中指定的重音颜色的十六进制代码。 |