Shopify POS 的打印收据代码编辑器

您可以在 Shopify 后台中使用代码编辑器来自定义打印收据。构成收据的文件包含 Shopify 的模板语言 Liquid。与可视化编辑器相比，您可以使用代码编辑器通过 HTML、CSS 和 Liquid 实现更高级的自定义。

您可以更改打印收据中使用的收据模板和分区模板。收据模板文件是您可以在商店中打印的收据类型。分区是收据的组成部分，例如标头或页脚。分区可供多个收据重复使用。

本页内容

使用收据代码编辑器的注意事项

在使用收据代码编辑器之前，请查看以下注意事项：

访问限制

您只能在台式电脑上从 Shopify 后台使用代码编辑器。
代码编辑器不适用于意大利或法国的任何 POS 地点。

更改适用范围

您所做的代码更改仅适用于所选地点。
代码编辑器中的自定义项仅适用于 POS Pro 地点。如果您使用代码编辑器并且有非 POS Pro 地点，则可以使用可视化编辑器为这些地点自定义标头和页脚。
您可以自定义在代码编辑器中具有模板的打印收据，例如销售收据、礼品收据、礼品卡收据以及退货和换货收据。

代码语言

构成收据的文件包含 Shopify 的模板语言 Liquid。详细了解 Liquid 的使用方法。
要在收据代码编辑器中编辑模板，您需要熟悉 HTML、CSS 和 Liquid。Shopify 模板支持团队无法为您大幅编辑收据模板，但在 Shopify 设计政策的权限范围内，也许能够帮助您对免费的 Shopify 模板进行细微调整。如需进行较复杂的更改，请考虑聘请 Shopify 合作伙伴。

自定义限制

您无法从代码编辑器中预览不同打印机尺寸的收据。若要按打印机尺寸进行预览，请使用可视化编辑器。
产品描述不可作为变量用于收据模板中，并且无法添加到打印收据中。

模板维护

如果您使用收据代码编辑器自定义收据，那么您的现有模板可能会缺少新属性（例如 selling_plan_name）。若要将最新可用属性添加到模板，您需要将收据模板重置为默认值。将收据模板重置为默认值会移除您对其所做的任何自定义设置。在重置之前，请记下您的自定义代码。重置模板后，您需要手动重新应用您的自定义设置。

访问代码编辑器

您可以使用代码编辑器编辑模板。您必须先从默认的可视化编辑器切换为使用代码编辑器，并且可以随时切换回可视化编辑器。

在不同编辑器之间切换的步骤略有不同，这取决于您所有的 POS 地点是否都符合代码编辑器的使用条件，或者是否只有部分 POS 地点符合条件（例如，您的某些 POS 地点未使用 POS Pro，或位于意大利或法国）。

步骤：

所有 POS Pro 地点

在您的 Shopify 后台中，转至 销售终端 > 设置。
在 自定义 部分中，点击 打印小票，打开 POS 编辑器。
点击左侧边栏中的图标。
点击编辑代码。
在编辑打印收据的代码对话框中，编辑您要更改的代码。
点击保存。
可选：若要继续使用 POS 编辑器编辑更多 Shopify POS 页面，请在浏览器窗口中返回上一页。

拥有 Lite 或意大利地点

在您的 Shopify 后台中，转至 销售终端 > 设置。
在 自定义 部分中，点击 打印小票，打开 POS 编辑器。
在收据自定义页面中，点击代码编辑器。

在收据模板中使用自定义文件

您可以使用上传到 Shopify 后台的文件（例如图片资产）来自定义打印的收据。

文件必须先上传到您的 Shopify 后台，然后才能在打印的收据中使用。详细了解文件上传。

步骤：

在您的 Shopify 后台中，转至内容 > 文件。
在要包含在打印收据代码中的文件旁边，点击以复制链接。
导航到代码编辑器。
在模板中包含资产链接。

将收据模板重置为默认值

您可以使用代码编辑器将收据模板重置为默认版本。

步骤：

所有 POS Pro 地点

在您的 Shopify 后台中，转至 销售终端 > 设置。
在 自定义 部分中，点击 打印小票，打开 POS 编辑器。
点击自定义您的收据。
点击编辑代码。
点击要重置的代码文件。
点击图标。
在将文件重置为默认值对话框中，点击重置。

拥有 Lite 或意大利地点

在您的 Shopify 后台中，转至 销售终端 > 设置。
在 自定义 部分中，点击 打印小票，打开 POS 编辑器。
在收据自定义页面中，点击代码编辑器。
点击要重置的代码文件。
点击图标。
在将文件重置为默认值对话框中，点击重置。

收据代码编辑器中可用的 Liquid 变量

您可以使用 Liquid 来自定义打印收据模板和收据类型。

以下数据对象可供收据代码编辑器使用：

收据对象

收据数据对象的描述
对象	描述
shop	包含商店信息，例如商店名称。
location	包含零售地点信息，例如地址和电话号码。
order	包含订单数据，包括订单项目、折扣、税款和交易信息。
return	仅在模板 `return-and-exchange-receipt.liquid` 及其关联的部分模板中可用。包含退货和换货数据，包括已退货的订单项目、新订单项目、净总计和交易信息。
gift_card	仅在模板 `gift-card.liquid` 中可用。包含礼品卡数据，包括余额、字母数字代码以及可由 POS 应用扫描的二维码内容。

订单对象

订单对象的描述
属性	描述
id	订单的 ID。
created_at	创建订单时的 ISO 8601 格式日期和时间。
source_identifier	唯一的 POS 或第三方订单识别码。
change_due	订单的应找零额。
balance_due	此订单的欠款金额。
name	订单的唯一识别码，会显示在 Shopify 后台的订单页面和订单状态页面上。例如，“#1001”、“EN1001”或“1001-A”。此值在多个商店之间不是唯一的。
note	与订单关联的备注的内容。
line_items	订单的订单项目列表。
subtotal_price	所有订单项目在扣除折扣后、退货前的价格总和。如果 `taxesIncluded` 为 true，则小计也包括税款。
total_price	退货前的订单总价。此价格包含税款和折扣。
total_tip_received	订单的所有小费金额的总和。
discounts	折扣总额。
transactions	与订单关联的交易列表。
taxes_included	订单的小计价格是否包含税款。
tax_lines	退货前应用于订单上订单项目的所有税费项目的列表。税费项目价格代表具有相同税率和标题的所有税费项目的总价。
customer	下单的客户。
shipping_address	订单上的收货地址。
shipping_groups	订单的发货组列表。每个组都包含一起发货的订单项目。

退货对象

退货对象描述
属性	描述
name	退货的唯一识别码，会显示在 Shopify 后台的订单页面和订单状态页面上。例如，“#1000-R1”。此值在多个商店之间不是唯一的。
created_at	创建退货时采用 ISO 8601 格式的日期和时间。
is_unverified	一个布尔值，指示此退货是否创建为未验证的退货。
is_exchange	一个布尔值，用于指明退货是否包含换货。这包括退款到礼品卡的情况。
exchange_type	换货的类型（如果退货包含换货）。可能的值为 `LIKE_FOR_LIKE`、`NET_REFUNDABLE` 和 `NET_PAYABLE`。
return_discount	已退款的订单折扣总额。
return_subtotal	所有退货订单项目在扣除折扣前的价格总和。如果 `taxesIncluded` 为 true，则小计也包括税款。
return_total	可能的退款总额。这包括税款、折扣、运费和小费。此金额可能不是实际退款金额。
exchange_subtotal	换货中所有新订单项目在扣除折扣前的价格总和。如果 `taxesIncluded` 为 true，则小计也包括税款。
exchange_total	换货中所有新订单项目的总金额。此金额包含税款和折扣。
total_cash_rounding_adjustment	应用于退货或换货的现金舍入调整。
total_adjusted_amount	经现金舍入调整后的退货或换货总金额。
net_total	在进行现金舍入之前，为退货或换货实际支付或退款的总金额。
return_line_items	已退货的订单项目。
exchange_line_items	换货中的新订单项目。
return_tax_lines	已退货订单项目的税费项目。
exchange_tax_lines	换货中新订单项目的税费项目。
shipping_refund_amount	已退款的运费金额。
tip_refund_amount	已退款的小费金额。
transactions	与退货或换货关联的交易。

发货组对象

发货组对象描述
属性	描述
destination	要发货的产品的目的地。
products	要发货的产品的列表。

订单项目对象

订单项目对象描述
属性	描述
id	订单项目的 ID。
name	产品标题，可选择性地附加多属性的标题（如果适用）。
variant_title	创建订单时的多属性标题。
price	创建订单时订单项目的单价。此值不包含折扣。
is_gift_card	订单项目是否代表礼品卡购买。
discount	由折扣应用分配给订单项目的总折扣，包括分配给已退款和已移除数量的折扣。
total_price	此订单项目的总计。
selling_plan_name	分配给订单项目的订阅套餐的名称。
tax_rates	此订单项目的税费项目。
custom_attributes	表示自定义功能或特殊请求的属性列表。
variant_title	多属性标题。
variant_id	多属性的 ID。
variant_metafields	商家与多属性关联的自定义字段列表。
staff_member_description	归于此订单项目的员工。
product_metafields	商家与产品关联的自定义字段列表。

退货订单项目对象

包含订单项目对象中的所有内容以及以下属性：

订单项目对象描述
属性	描述
return_reason	订单项目的退货原因。
return_reason_note	与退货原因相关的可选备注。

收据代码编辑器中可用的 Liquid 筛选器

您可以使用 Liquid 筛选器调整收据模板中的信息。例如，您可以更改货币的格式或特定文本（如税务代码）的大小写。

若要应用筛选器，请在双大括号 {{ }} 之间的 Liquid 代码块内添加一个管道符 |，然后添加筛选器。筛选器只能应用于 Liquid 代码块。

在以下示例中，过滤器会将税务代码从小写调整为大写。

{{ tax_line.title | upcase }}

在示例代码块中，product 是对象，title 是其属性，而 upcase 是应用的过滤器。upcase 过滤器会将 tax_line.title 的值的大小写形式更改为大写。例如，如果 tax_line.title 的值为 Hst，则 upcase 过滤器会将该值更改为 HST。

有关如何使用 Liquid 筛选器的详细信息，请参阅 Shopify 模板 Liquid 参考中的“筛选器”部分。

收据代码编辑器中提供以下过滤器：

收据过滤器描述
属性	描述
t	将预定义标签翻译为分配给您地点的语言。
money	以您地点的货币设置价格格式。
escape	对 HTML 中的特殊字符（例如 `<>`、`'` 和 `&`）进行转义，并将这些字符转换为转义序列。
barcode	生成 1D 条码 SVG。
qrcode	生成 2D 条码 SVG。

打印收据模板代码自定义示例

您可以使用 Liquid 添加条件消息。此功能类似于使用可视化编辑器为单个地点进行保存。例如，您的业务最初只有一个地点，现在您有了几个新地点。您想在打印的收据上突出显示您的原始商店。

您可以在代码编辑器的 Sections 文件夹中将自定义消息添加到 header.liquid 模板，并使用 Liquid 以仅为您的旗舰店显示该消息。

以下代码会检查地点的名称（在本例中是名为“Home”的原始地点），如果地点与该名称匹配，则显示消息“Welcome to our original store, opened in 1972.”。从您的其他地点打印的收据将改为显示消息“Welcome to our store.”。

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}

在代码编辑器中预览代码更改

您可以在 Shopify 后台的 POS 代码编辑器中预览对打印收据所做的更改。

根据所选的 Liquid 文件，预览窗口会突出显示受该文件影响的收据设计或分区。默认情况下，预览窗口会显示您最近的 POS 订单的内容。对于除 gift-card.liquid 文件之外的所有 Liquid 文件，您可以选择特定订单用作预览窗口中的收据内容；而 gift-card.liquid 文件仅将不同地点显示为可选预览选项。

步骤：

所有 POS Pro 地点

在您的 Shopify 后台中，转至 销售终端 > 设置。
在 自定义 部分中，点击 打印小票，打开 POS 编辑器。
点击自定义您的收据。
点击编辑代码。
点击要预览的代码文件。您的收据将显示在最右侧的编辑器窗口中。
可选：若要选择特定订单用作预览窗口中的收据内容，请执行以下操作：
1. 点击图标。
2. 所有地点通过 POS 渠道完成的销售将显示在选择要预览的订单对话框中。从列表中选择一个订单，或使用搜索栏搜索特定订单和地点。
3. 点击确认。
可选：如果您要预览 gift-card.liquid 文件，请点击图标，然后选择要为其预览模板的地点。

拥有 Lite 或意大利地点

在您的 Shopify 后台中，转至 销售终端 > 设置。
在 自定义 部分中，点击 打印小票，打开 POS 编辑器。
在收据自定义页面中，点击代码编辑器。
点击要预览的代码文件。您的收据将显示在最右侧的编辑器窗口中。
可选：若要选择特定订单用作预览窗口中的收据内容，请执行以下操作：
1. 点击图标。
2. 所有地点通过 POS 渠道完成的销售将显示在选择要预览的订单对话框中。从列表中选择一个订单，或使用搜索栏搜索特定订单和地点。
3. 点击确认。
可选：如果您要预览 gift-card.liquid 文件，请点击图标，然后选择要为其预览模板的地点。