紙本收據程式碼編輯器

您可以使用 Shopify 管理介面中的程式碼編輯器自訂紙本收據。相較於視覺化編輯器，程式碼編輯器可讓您使用 HTML、CSS 和 Liquid，建立更進階的自訂內容。

您可以變更紙本收據所使用的收據範本和區段範本。收據範本檔案是您商店中可列印的收據類型。區段是收據的部分內容，例如頁首或頁尾。區段可供多張收據重複使用。

此頁面上

使用收據程式碼編輯器的考量事項

使用收據程式碼編輯器之前，請先查看以下考量事項：

只能從電腦版 Shopify 管理介面使用程式碼編輯器。
您所變更的程式碼將套用至所有 POS Pro 地點，但您可以新增條件來顯示特定地點的自訂內容。深入瞭解如何在 Liquid 中使用控制流程標籤。
切換至程式碼編輯器後，您無法透過 Shopify POS 應用程式自訂收據範本的任何內容，但仍可以從採用 POS Pro 訂閱方案的地點，使用 Shopify POS 應用程式調整「列印選項」。
程式碼編輯器中的自訂內容僅套用至 POS Pro 地點。如果您使用程式碼編輯器並具有 POS Lite 地點，則可以使用視覺化編輯器自訂 Lite 地點的頁首和頁尾。
收據檔案中包含 Liquid，這是 Shopify 的範本語言。深入瞭解如何使用 Liquid。
若要在收據程式碼編輯器中編輯範本，您必須熟悉 HTML、CSS 和 Liquid。Shopify 佈景主題支援服務可在 Shopify 設計政策所述範圍內，協助您稍微調整範本內容。
某些類型的紙本收據無法自訂。
程式碼編輯器不適用於義大利的任何地點。

收據類型的不相容情況考量事項

某些類型的紙本收據無法在收據程式碼編輯器中自訂。程式碼編輯器中沒有範本的收據類型與自訂功能不相容。

您可以自訂以下類型的紙本收據：

銷售收據
禮品卡收據
禮品收據

您無法自訂以下收據：

退貨收據
換貨收據

此外，義大利境內地點的所有收據類型都不符合自訂要求。

存取程式碼編輯器

您可以使用程式碼編輯器來編輯範本。

步驟如下：

在 Shopify 管理介面中，前往「設定」>「應用程式和銷售管道」。
在「應用程式和銷售管道」頁面中，點擊 Point of sale。
點擊「開啟銷售管道」。
點按「設定」>「收據自訂內容」。
按一下「自訂收據」。
按一下「...」>「編輯程式碼」。
在「編輯程式碼」對話方塊中，點按「編輯程式碼」。

在收據範本中使用自訂檔案

您可以使用上傳的檔案自訂收據。如果您想要在收據上列印自訂圖片，請將這些圖片上傳至 Shopify 管理介面，然後在自訂收據上使用。深入瞭解檔案上傳。

步驟如下：

在 Shopify 管理介面中，前往「設定」>「應用程式和銷售管道」。
在「應用程式和銷售管道」頁面中，點擊 Point of sale。
點擊「開啟銷售管道」。
點按「設定」>「收據自訂內容」。
按一下「自訂收據」。
點按「內容頁面」。
找到要在收據範本中使用的檔案並複製該檔案旁的連結。
將此連結加入範本。

將收據範本重設為預設值

您可以使用程式碼編輯器將收據範本重設為預設版本。

步驟如下：

在 Shopify 管理介面中，前往「設定」>「應用程式和銷售管道」。
在「應用程式和銷售管道」頁面中，點擊 Point of sale。
點擊「開啟銷售管道」。
點按「設定」>「收據自訂內容」。
按一下您要重設的範本。
按一下「重設」圖示。
在「將檔案重設為預設值」互動視窗中，點按「重設」以確認操作。

收據程式碼編輯器中可用的 Liquid 變數

您可以使用 Liquid 自訂紙本收據範本和收據類型。

收據程式碼編輯器中提供以下資料物件：

收據資料物件說明
物件	說明
shop	包含商店資訊，例如商店名稱。
location	包含零售地點資訊，例如地址和電話號碼。
order	包含訂單資料，包括商品項目、折扣、稅額和交易資訊。
gift_card	僅在 `gift_card.liquid` 範本中提供，包含禮品卡資料，例如餘額、英數字元代碼，以及可透過 POS 應用程式掃描的 QR 碼內容。

收據程式碼編輯器中提供 Liquid 篩選條件

您可以使用 Liquid 篩選條件調整收據範本中的資訊。例如，您可以變更幣別格式或特定文字 (例如課稅碼) 的大小寫。

若要套用篩選條件，請新增一個豎線字元「|」，然後在雙大括號 {{ }} 之間的 Liquid 程式碼區塊內新增篩選條件。篩選條件只能套用至 Liquid 程式碼區塊。

在以下範例中，篩選條件將課稅碼從小寫調整為大寫。

{{ tax_line.title | upcase }}

在範例程式碼區塊中，product 是物件，title 是其屬性，而 upcase 是套用的篩選條件。upcase 篩選條件將 tax_line.title 的值改為大寫字體。例如，如果 tax_line.title 值為 Hst，則 upcase 篩選條件將值變更為 HST。

請參閱 Shopify 佈景主題 Liquid 參考資料的篩選條件區段，以詳細瞭解如何使用 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.」(歡迎來到我們的創始店，該店於 1972 年開業)。反之，其他地點列印的收據則會顯示訊息「Welcome to our store.」(歡迎光臨本店)。

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