Flow 的模板变量

也与本节相关的主题

• Liquid 支持

将模板变量添加到操作中，以包含工作流中涉及的客户、订单或产品的相关详细信息。

模板变量是在工作流运行时替换为值的占位符。此类变量描述工作流中涉及的客户、订单和产品的属性。例如，订单号、订单价格、客户姓名等都有对应的模板变量。

大多数模板变量的名称都是自描述性的。例如，显示产品名称的模板变量是 {{ product.title }}。发送消息时，此变量将替换为已订购产品的名称：Large Coffee Mug。

向操作中添加模板变量

添加模板变量最简单的方法是，单击添加模板变量链接，然后从列表中选择变量。

您可以将模板变量添加到包含添加模板变量链接的任何文本字段：

添加模板变量列表中的模板变量将进行筛选，以便您只看到适用于所选触发器的变量。从列表中选择变量后，该变量将被正确格式化并添加到文本框中。

模板变量

适用于创建客户操作的变量：

• 客户变量
• 商店变量

适用于库存数量已更改和已添加产品操作的变量：

• 产品变量
• 商店变量

适用于订单已付款和已分析订单风险操作的变量：

• 订单变量
• 商店变量

适用于订单已发货操作的变量：

• 发货变量
• 订单变量
• 商店变量

适用于为订单退款操作的变量：

• 订单变量
• 退款变量
• 商店变量

客户变量

下表介绍了与客户相关的模板变量：

模板变量及其描述。

变量名称	描述
customer.acceptsMarketing	客户是否同意接收营销材料。
customer.averageOrderAmountV2.amount	客户每个订单的平均消费额。
customer.canDelete	商家是否可以从商店中删除顾客。
customer.createdAt	将客户添加到商店的日期和时间。
customer.displayName	客户的全名，名字 + 姓氏。
customer.email
customer.firstName
customer.hasNote	客户是否有与自己相关的备注。
customer.hasTimelineComment	商家是否已在客户页面添加关于该客户的时间备注。
customer.id	全局唯一标识符。
customer.lastName
customer.lifetimeDuration	自首次将客户添加到商店以来的时间。
customer.note	由商家撰写的关于客户的备注。
customer.ordersCount	客户使用期内在商店中所下的订单数。
customer.phone
customer.state	客户居住地所在的州或省。
customer.taxExempt	客户的订单是否免税。
customer.totalSpent	客户在所有时期消费的订单总金额。
customer.UpdatedAt	客户上次更新的日期和时间。
customer.verifiedEmail	电子邮件地址格式是否正确。
customer.defaultAddress.address1	地址行 1（街道地址/邮政信箱/公司名称）。
customer.defaultAddress.address2	地址行 2（公寓/套房/单元/大楼）。
customer.defaultAddress.city	城市/区/郊区/城镇/村。
customer.defaultAddress.company	公司/组织/政府。
customer.defaultAddress.country	州/县/省（或直辖市/自治区）/地区。
customer.defaultAddress.countryCode	国家/地区代码（两个字母）。
customer.defaultAddress.firstName	客户的名字。
customer.defaultAddress.formattedArea	逗号分隔的城市、省/直辖市/自治区和国家/地区列表。
customer.defaultAddress.lastName	客户的姓氏。
customer.defaultAddress.latitude	客户地址的纬度坐标。
customer.defaultAddress.longitude	客户地址的经度坐标。
customer.defaultAddress.name	客户姓名，名字 + 姓氏。
customer.defaultAddress.phone	客户的唯一电话号码。
customer.defaultAddress.province	州/县/省（或直辖市/自治区）/地区。
customer.defaultAddress.provinceCode	省或州代码（两个字母）。
customer.defaultAddress.zip	邮编/邮政编码。
customer.image.altText	用于描述图片的本义或内容的字词或短语。
customer.lastOrder.billingAddressMatchesShippingAddress	账单邮寄地址是否与收货地址一致。
customer.lastOrder.buyerAcceptsMarketing	客户是否同意接收营销材料。
customer.lastOrder.canMarkAsPaid	是否可以手动将订单标记为已付款。
customer.lastOrder.cancelReason	取消订单的原因。
customer.lastOrder.capturable	是否可以捕获订单的付款。
customer.lastOrder.cartDiscountAmountSet.shopMoney.amount	订单级别折扣的金额（不包含任何订单项目折扣）。
customer.lastOrder.clientIp	与此订单关联的客户端的 IP 地址。
customer.lastOrder.closed	订单是否已关闭。
customer.lastOrder.confirmed	是否已为该订单保留库存。
customer.lastOrder.currencyCode	下单时商店采用的货币。
customer.lastOrder.customerLocale
customer.lastOrder.discountCode	客户提供的折扣码。
customer.lastOrder.displayFinancialStatus	可以向商家显示的订单的财务状态。
customer.lastOrder.displayFulfillmentStatus	可向商家显示的订单的发货状态。
customer.lastOrder.email	客户提供的电子邮件地址。
customer.lastOrder.fulfillable	是否存在可以发货的产品。
customer.lastOrder.fullyPaid	订单是否已全额付清。
customer.lastOrder.hasTimelineComment	商家是否对订单添加了时间表评论。
customer.lastOrder.landingPageDisplayText
customer.lastOrder.name	订单上显示的订单的唯一标识符。
customer.lastOrder.netPaymentSet.shopMoney.amount	订单的净收款金额，“总收款金额 - 总退款金额”。
customer.lastOrder.note	与订单关联的备注内容。
customer.lastOrder.phone	客户提供的电话号码。
customer.lastOrder.referralCode	客户访问您商店所使用的链接中的营销推荐代码。
customer.lastOrder.referrerDisplayText	将客户引导至您的在线商店的网址。
customer.lastOrder.refundable	订单是否可以退款。
customer.lastOrder.requiresShipping	订单中是否有任何订单产品需要实际配送。
customer.lastOrder.riskLevel	订单的欺诈风险等级。
customer.lastOrder.subtotalPriceSet.shopMoney.amount	订单项目及其折扣的小计（不包含运费、运费折扣和订单级别折扣）。
customer.lastOrder.taxesIncluded	订单小计价格中是否包括税费。
customer.lastOrder.test	订单是否为测试订单。
customer.lastOrder.totalCapturable	订单的授权金额，即未捕获或正在捕获的金额。
customer.lastOrder.totalDiscountsSet.shopMoney.amount	订单折扣总额（包括订单级别和订单项目折扣）。
customer.lastOrder.totalPriceSet.shopMoney.amount	订单总金额（包括税金和折扣）。
customer.lastOrder.totalReceived	客户收到的订单总金额。
customer.lastOrder.totalRefunded	订单退款总额。
customer.lastOrder.totalShippingPrice	配送订单的总费用。
customer.lastOrder.totalTax	适用于订单的所有税金总额。
customer.lastOrder.totalWeight	订单总重量（克）。
customer.lastOrder.unpaid	是否未对订单付款。

发货变量

下表介绍了与发货相关的模板变量：

与发货相关的模板变量的描述。

变量名称	描述
fulfillment.displayStatus	此发货的人类可读显示状态。
fulfillment.id	全局唯一标识符。
fulfillment.name	此发货的人类可读参考标识符。
fulfillment.status
fulfillment.totalQuantity
fulfillment.service.handle	此配送服务的人类可读唯一标识符。
fulfillment.service.inventoryManagement
fulfillment.service.productBased
fulfillment.service.serviceName
order.all_line_items_shippable

订单变量

下表介绍了与订单相关的模板变量：

与订单相关的模板变量的描述。

变量名称	描述
order.billingAddressMatchesShippingAddress	账单邮寄地址是否与收货地址一致。
order.buyerAcceptsMarketing	客户是否同意接收营销材料。
order.canMarkAsPaid	是否可以手动将订单标记为已付款。
order.cancelReason	取消订单的原因。
order.cancelledAt	订单取消的日期和时间。
order.capturable	是否可以捕获订单的付款。
order.cartDiscountAmountSet.shopMoney.amount	订单级别折扣的金额（不包含任何订单项目折扣）。
order.clientIp	与此订单关联的客户端的 IP 地址。
order.closed	订单是否已关闭。
order.closedAt	订单取消的日期和时间。
order.confirmed	是否已为该订单保留库存。
order.createdAt	创建订单的日期和时间。
order.currencyCode	下单时商店采用的货币。
order.customerLocale
order.discountCode	客户提供的折扣码。
order.displayFinancialStatus	可以向商家显示的订单的财务状态。
order.displayFulfillmentStatus	可向商家显示的订单的发货状态。
order.email	客户提供的电子邮件地址。
order.fulfillable	是否存在可以发货的产品。
order.fullyPaid	订单是否已全额付清。
order.hasTimelineComment	商家是否对订单添加了时间表评论。
order.id	全局唯一标识符。
order.customerJourney.lastVisit.landingPageHtml
order.lineItems	一系列订单订单项目。
order.name	订单上显示的订单的唯一标识符。
order.netPaymentSet.shopMoney.amount	订单的净收款金额，“总收款金额 - 总退款金额”。
order.note	与订单关联的备注内容。
order.phone	客户提供的电话号码。
order.presentmentCurrencyCode	此订单的客户付款货币。
order.processedAt	处理订单的日期和时间。
order.customerJourney.lastVisit.referralCode	客户访问您商店所使用的链接中的营销推荐代码。
order.customerJourney.lastVisit.referralInfoHtml	将客户引导至您的在线商店的网址。
order.refundable	订单是否可以退款。
order.requiresShipping	订单中是否有任何订单产品需要实际配送。
order.riskLevel	订单的欺诈风险等级。
order.subtotalPriceSet.shopMoney.amount	订单项目及其折扣的小计（不包含运费、运费折扣和订单级别折扣）。
order.taxesIncluded	订单小计价格中是否包括税费。
order.test	订单是否为测试订单。
order.totalCapturableSet.shopMoney.amount	订单的授权金额，即未捕获或正在捕获的金额。
order.totalDiscountsSet.shopMoney.amount	订单折扣总额（包括订单级别和订单项目折扣）。
order.totalPriceSet.shopMoney.amount	订单总金额（包括税金和折扣）。
order.totalReceivedSet.shopMoney.amount	客户收到的订单总金额。
order.totalRefundedSet.shopMoney.amount	订单退款总额。
order.totalShippingPriceSet.shopMoney.amount	配送订单的总费用。
order.totalTaxSet.shopMoney.amount	适用于订单的所有税金总额。
order.totalWeight	订单总重量（克）。
order.unpaid	是否未对订单付款。
order.UpdatedAt	上次修改订单的日期和时间。
order.billingAddress.address1	地址行 1（街道地址/邮政信箱/公司名称）。
order.billingAddress.address2	地址行 2（公寓/套房/单元/大楼）。
order.billingAddress.city	城市/区/郊区/城镇/村。
order.billingAddress.company	公司/组织/政府。
order.billingAddress.country	州/县/省（或直辖市/自治区）/地区。
order.billingAddress.countryCodeV2	国家/地区代码（两个字母）。
order.billingAddress.firstName	客户的名字。
order.billingAddress.formattedArea	逗号分隔的城市、省/直辖市/自治区和国家/地区列表。
order.billingAddress.lastName	客户的姓氏。
order.billingAddress.latitude	客户地址的纬度坐标。
order.billingAddress.longitude	客户地址的经度坐标。
order.billingAddress.name	客户姓名，名字 + 姓氏。
order.billingAddress.phone	客户的唯一电话号码。
order.billingAddress.province	州/县/省（或直辖市/自治区）/地区。
order.billingAddress.provinceCode	省或州代码（两个字母）。
order.billingAddress.zip	邮编/邮政编码。
order.publication.name	发布的名称。
order.publication.supportsFuturePublishing	此发布是否支持未来发布。
order.customer.acceptsMarketing	客户是否同意接收营销材料。
order.customer.averageOrderAmountV2.amount	客户每个订单的平均消费额。
order.customer.canDelete	商家是否可以从商店中删除顾客。
order.customer.displayName	客户的全名，名字 + 姓氏。
order.customer.email
order.customer.firstName
order.customer.hasNote	客户是否有与自己相关的备注。
order.customer.hasTimelineComment	商家是否已在客户页面添加关于该客户的时间备注。
order.customer.lastName
order.customer.lifetimeDuration	自首次将客户添加到商店以来的时间。
order.customer.note	由商家撰写的关于客户的备注。
order.customer.ordersCount	客户使用期内在商店中所下的订单数。
order.customer.phone
order.customer.state	客户居住地所在的州或省。
order.customer.taxExempt	客户的订单是否免税。
order.customer.totalSpent	客户在所有时期消费的订单总金额。
order.customer.verifiedEmail	电子邮件地址格式是否正确。
order.customerJourney.customerOrderIndex
order.customerJourney.daysToConversion
order.displayAddress.address1	地址行 1（街道地址/邮政信箱/公司名称）。
order.displayAddress.address2	地址行 2（公寓/套房/单元/大楼）。
order.displayAddress.city	城市/区/郊区/城镇/村。
order.displayAddress.company	公司/组织/政府。
order.displayAddress.country	州/县/省（或直辖市/自治区）/地区。
order.displayAddress.countryCodeV2	国家/地区代码（两个字母）。
order.displayAddress.firstName	客户的名字。
order.displayAddress.formattedArea	逗号分隔的城市、省/直辖市/自治区和国家/地区列表。
order.displayAddress.lastName	客户的姓氏。
order.displayAddress.latitude	客户地址的纬度坐标。
order.displayAddress.longitude	客户地址的经度坐标。
order.displayAddress.name	客户姓名，名字 + 姓氏。
order.displayAddress.phone	客户的唯一电话号码。
order.displayAddress.province	州/县/省（或直辖市/自治区）/地区。
order.displayAddress.provinceCode	省或州代码（两个字母）。
order.displayAddress.zip	邮编/邮政编码。
order.customerJourney.firstVisit.utmParameters.campaign
order.customerJourney.firstVisit.utmParameters.content
order.customerJourney.firstVisit.utmParameters.medium
order.customerJourney.firstVisit.utmParameters.source
order.customerJourney.firstVisit.utmParameters.term
order.physicalLocation.isActive	指示某个位置是否处于活动状态。
order.physicalLocation.name
order.physicalLocation.shipsInventory	指示此位置是否运送库存。
order.shippingAddress.address1	地址行 1（街道地址/邮政信箱/公司名称）。
order.shippingAddress.address2	地址行 2（公寓/套房/单元/大楼）。
order.shippingAddress.city	城市/区/郊区/城镇/村。
order.shippingAddress.company	公司/组织/政府。
order.shippingAddress.country	州/县/省（或直辖市/自治区）/地区。
order.shippingAddress.countryCodeV2	国家/地区代码（两个字母）。
order.shippingAddress.firstName	客户的名字。
order.shippingAddress.formattedArea	逗号分隔的城市、省/直辖市/自治区和国家/地区列表。
order.shippingAddress.lastName	客户的姓氏。
order.shippingAddress.latitude	客户地址的纬度坐标。
order.shippingAddress.longitude	客户地址的经度坐标。
order.shippingAddress.name	客户姓名，名字 + 姓氏。
order.shippingAddress.phone	客户的唯一电话号码。
order.shippingAddress.province	州/县/省（或直辖市/自治区）/地区。
order.shippingAddress.provinceCode	省或州代码（两个字母）。
order.shippingAddress.zip	邮编/邮政编码。
order.shippingLine.custom
order.shippingLine.originalPriceSet.shopMoney.amount
order.shippingLine.shippingRateHandle
order.shippingLine.title
order.suggestedRefund.amountSet.shopMoney.amount
order.suggestedRefund.maximumRefundableSet.shopMoney.amount
order.suggestedRefund.subtotalSet.shopMoney.amount
order.suggestedRefund.totalTaxSet.shopMoney.amount

产品变量

下表介绍了与产品相关的模板变量：

与产品相关的模板变量的描述。

变量名称	描述
product.availablePublicationCount	已在其中发布产品且没有反馈错误的渠道的数量。
product.createdAt	创建产品的日期和时间。
product.defaultCursor	用于分页的默认光标。
product.description	产品的精简描述，删除了 HTML 标签的单行文本。
product.handle
product.hasOnlyDefaultVariant	产品是否只有一个具有默认选项和值的多属性。
product.hasOutOfStockVariants
product.id	全局唯一标识符。
product.isGiftCard
product.publishedAt	产品发布到在线商店的日期和时间。
product.productType
product.publicationCount	发布产品的渠道数量。
product.publishedOnCurrentChannel	检查产品是否已发布到调用应用的频道。
product.templateSuffix
product.title
product.totalInventory
product.totalVariants
product.tracksInventory
product.UpdatedAt	上次修改产品的日期和时间。
product.vendor
product.feedback.summary
product.seo.description	SEO 描述。
product.seo.title	SEO 标题。
product_variant.availableForSale	指示产品多属性是否可供销售。
product_variant.barcode
product_variant.compareAtPrice
product_variant.defaultCursor	用于分页的默认光标。
product_variant.displayName	多属性的显示名称，基于产品标题和多属性标题。
product_variant.harmonizedSystemCode
product_variant.id	全局唯一标识符。
product_variant.inventoryManagement
product_variant.inventoryPolicy
product_variant.inventoryQuantity	可销售的多属性总数量
product_variant.inventoryQuantityPrior
product_variant.position
product_variant.price
product_variant.requiresShipping
product_variant.sku
product_variant.taxable
product_variant.title
product_variant.weight
product_variant.weightUnit
product_variant.fulfillmentService.handle	此配送服务的人类可读唯一标识符。
product_variant.fulfillmentService.inventoryManagement
product_variant.fulfillmentService.productBased
product_variant.fulfillmentService.serviceName
product_variant.image.altText	用于描述图片的本义或内容的字词或短语。
product_variant.product.availablePublicationCount	已在其中发布产品且没有反馈错误的渠道的数量。
product_variant.product.defaultCursor	用于分页的默认光标。
product_variant.product.description	产品的精简描述，删除了 HTML 标签的单行文本。
product_variant.product.handle
product_variant.product.hasOnlyDefaultVariant	产品是否只有一个具有默认选项和值的多属性。
product_variant.product.hasOutOfStockVariants
product_variant.product.isGiftCard
product_variant.product.productType
product_variant.product.publicationCount	发布产品的渠道数量。
product_variant.product.publishedOnCurrentChannel	检查产品是否已发布到调用应用的频道。
product_variant.product.templateSuffix
product_variant.product.title
product_variant.product.totalInventory
product_variant.product.totalVariants
product_variant.product.tracksInventory
product_variant.product.vendor

退款变量

下表介绍了与退款相关的模板变量：

与退款相关的模板变量的描述。

变量名称	描述
refund.id	全局唯一标识符。
refund.note
refund.restocked
refund.staffMember.active	员工是否处于活跃状态。
refund.staffMember.email
refund.staffMember.exists
refund.staffMember.firstName
refund.staffMember.isShopOwner	用户是否是所有者。
refund.staffMember.lastName
refund.staffMember.name
refund.staffMember.phone

商店变量

下表介绍了与商店相关的模板变量：

与商店相关的模板变量的描述。

变量名称	描述
shop.channelCount	显示渠道数量。
shop.checkoutApiSupported	指定商店是否通过结账 API 支持结账。
shop.currencyCode
shop.customerAccounts
shop.description
shop.email
shop.ianaTimezone
shop.myshopifyDomain
shop.name
shop.limitedPendingOrderCount.count
shop.setupRequired
shop.taxShipping	指定是否对运费收税。
shop.taxesIncluded	指定适用税费是否包含在产品价格中的设置。
shop.weightUnit
shop.billingAddress.address1	地址行 1（街道地址/邮政信箱/公司名称）。
shop.billingAddress.address2	地址行 2（公寓/套房/单元/大楼）。
shop.billingAddress.city	城市/区/郊区/城镇/村。
shop.billingAddress.company	公司/组织/政府。
shop.billingAddress.country	州/县/省（或直辖市/自治区）/地区。
shop.billingAddress.countryCode	国家/地区代码（两个字母）。
shop.billingAddress.firstName	客户的名字。
shop.billingAddress.formattedArea	逗号分隔的城市、省/直辖市/自治区和国家/地区列表。
shop.billingAddress.lastName	客户的姓氏。
shop.billingAddress.latitude	客户地址的纬度坐标。
shop.billingAddress.longitude	客户地址的经度坐标。
shop.billingAddress.name	客户姓名，名字 + 姓氏。
shop.billingAddress.phone	客户的唯一电话号码。
shop.billingAddress.province	州/县/省（或直辖市/自治区）/地区。
shop.billingAddress.provinceCode	省或州代码（两个字母）。
shop.billingAddress.zip	邮编/邮政编码。
shop.countriesInShippingZones.includeRestOfWorld	是否在所有送货区域定义了“世界其他地区”。
shop.features.branding	商店的品牌推广。
shop.features.financialReports
shop.features.harmonizedSystemCode	在产品上显示协调制度代码。跨境运输时用于海关。
shop.features.liveView	是否显示实时视图。实时视图对正在试用或没有店面的商家是隐藏的。
shop.features.shopifyPlus
shop.features.showMetrics	是否显示指标。在指标变得有意义之前，指标对商家是隐藏的。
shop.features.storefront
shop.primaryDomain.host	域名的主机名（例如：example.com）。
shop.primaryDomain.sslEnabled	是否已启用 SSL。
shop.resourceLimits.maxProductOptions	允许的最大产品选项数。
shop.resourceLimits.maxProductVariants	允许的最大多属性数。
shop.resourceLimits.redirectLimitReached	商店是否已达到其可为资源进行的 URL 重定向数量的限制。

order.lineItems 的模板变量

如果您有使用 Shopify Liquid 的经验，则您可能希望在工作流程中使用 Liquid 标签等高级功能。例如，您可以使用 for 循环标签列出订单商品的详细信息，如每个产品订单的名称及其 SKU 和价格。为此，可以使用 order.lineItems 对象，该对象与 Shopify Liquid 文档中描述的 line_item 对象略有不同。

查看使用 order.lineItems 的消息示例。

下表介绍了 Flow 中 order.lineItems 对象支持的模板变量：

order.lineItems 对象支持的模板变量的描述。

模板变量	数据类型	描述
canRestock	布尔	订单项目中订购的产品是否可以在退货或订单取消时重新入库。
totalDiscountSet.shopMoney.amount	金钱	应用于订单项目的折扣金额。
discountedUnitPrice	金钱	产品多属性在应用每单位折扣后的单价。
fulfillableQuantity	整数	仍待发货的产品多属性数量。此值基于 _quantity - max(refunded_quantity, fulfilled_quantity) - pending_fulfilled_quantity - open_fulfilledquantity。
fulfillmentStatus	字符串	订单中的订单项目的发货进度。有效值：已发货、null 或部分发货。
姓名	字符串	订购产品的名称。
nonFulfillableQuantity	整数	无法发货的订单产品数。
originalTotal	金钱	订单项目的总价（不含折扣），基于多属性的原始单价乘以订购数量。
originalUnitPriceSet	金钱	未应用折扣的多属性价格。
数量	数字	订购的多属性产品数。
refundableQuantity	整数	订单项目中可退款的项目数量。
requiresShipping	布尔	多属性是否需要进行实物运输。
sku	字符串	多属性 SKU 编号。
taxable	布尔	该多属性是否应该纳税。
标题	字符串	产品或多属性标题（此字段仅适用于自定义订单产品）。
totalDiscount	金钱	订单折扣总额。包括订单产品折扣和订单级折扣。
unfulfilledDiscountedTotal	金钱
unfulfilledOriginalTotal	金钱
unfulfilledQuantity	整数
variantTitle	字符串	多属性的名称。
供应商	字符串	制造多属性的供应商的名称。

高级功能

如果您是具有 Shopify Liquid 代码编写经验的开发人员，则还可以使用 Liquid 编写模板变量。若要了解详细信息，请参阅 Flow 中的 Liquid 支持。

示例

查看使用模板变量的消息和备注的示例。

相关链接

• 创建工作流
• 工作流触发器、条件和操作
• 工作流示例