Редактор кода для печатных чеков в Shopify POS
Редактор кода чеков позволяет настраивать печатные чеки с помощью HTML, CSS и Liquid. Вы можете редактировать шаблоны чеков — типы чеков, которые можно распечатать в вашем магазине, а также шаблоны разделов — многократно используемые элементы чеков, такие как шапка и футер.
На этой странице
- Что нужно учесть при использовании редактора кода квитанций
- Доступ к редактору кода
- Использование пользовательских файлов в шаблоне квитанции
- Сброс шаблона квитанции до версии по умолчанию
- Переменные Liquid, доступные в редакторе кода квитанций
- Фильтры Liquid, доступные в редакторе кода квитанций
- Пример настройки кода шаблона печатной квитанции
- Предпросмотр изменений в редакторе кода
Особенности использования редактора кода для чеков
Прежде чем использовать редактор кода для чеков, ознакомьтесь со следующими особенностями:
Ограничения доступа
- Редактором кода можно пользоваться только в панели администратора Shopify на компьютере.
- Редактор кода недоступен для мест расположения POS в Италии или Франции.
- Для новых магазинов и мест расположения редактор кода недоступен. Он остаётся доступным для магазинов с существующими настройками, которые ещё не были перенесены.
Область применения изменений
- Изменения кода, которые вы вносите, применяются только к выбранному месту расположения.
- Настройки в редакторе кода применяются только к точкам продаж POS Pro. Если вы используете редактор кода и у вас есть точки продаж без подписки POS Pro, то для этих точек продаж вы можете настроить шапку и подвал с помощью визуального редактора.
- Вы можете настраивать печатные чеки, для которых в редакторе кода есть шаблон, например чеки продаж, подарочные чеки, чеки подарочных карт, а также чеки возврата и обмена.
Языки кода
- Файлы, из которых состоят ваши квитанции, содержат код на Liquid — языке шаблонов Shopify. Подробнее об использовании Liquid.
- Чтобы редактировать шаблоны в редакторе кода квитанций, необходимо знание HTML, CSS и Liquid. Служба поддержки тем Shopify не может вносить значительные изменения в шаблоны квитанций за вас, но может помочь с небольшими корректировками бесплатных тем Shopify в рамках Политики дизайна Shopify. Для выполнения более сложных изменений подумайте о том, чтобы нанять партнера Shopify.
Ограничения настройки
- В редакторе кода нельзя предварительно просматривать квитанции для разных размеров принтеров. Чтобы выполнить предварительный просмотр с учетом размера принтера, используйте визуальный редактор.
- Описания товаров недоступны в качестве переменной в шаблонах квитанций, и их нельзя добавить в печатные квитанции.
Поддержка шаблонов
- Шаблоны чеков в редакторе кода больше не получают обновлений. Свойства, добавленные после 1 июня 2026 года, доступны только в визуальном редакторе.
- Сброс шаблона до значений по умолчанию больше не поддерживается. Чтобы вернуться к шаблону по умолчанию, перейдите в визуальный редактор.
Доступ к редактору кода
Вы можете открыть редактор кода из визуального редактора чеков или из настроек Point of Sale. Ссылка Использовать редактор кода в визуальном редакторе чеков доступна, только если все ваши места расположения POS поддерживают работу с редактором кода. Если некоторые из ваших мест расположения POS не используют тариф POS Pro, либо находятся в Италии или Франции, откройте редактор кода из настроек Point of Sale.
Шаги:
Из визуального редактора чеков
В панели администратора Shopify перейдите в раздел Каналы продаж > Point of Sale.
В разделе Настройка обслуживания в магазине нажмите Редактировать рядом с пунктом Чеки.
Нажмите Использовать редактор кода.
Из настроек Point of Sale
В панели администратора Shopify перейдите в раздел Point of Sale > Настройки.
В разделе Настройка нажмите Печатные чеки.
В разделе Настройка макета нажмите Редактор кода.
Использование пользовательских файлов в шаблоне квитанции
Вы можете использовать файлы (например, изображения), загруженные в панель администратора Shopify, для настройки печатных квитанций.
Прежде чем использовать файл локали в печатной квитанции, загрузите его в панель администратора Shopify. Подробнее о загрузке файлов локали.
Шаги:
В панели администратора Shopify перейдите в раздел Контент > Файлы.
Рядом с файлом, который вы хотите добавить в код печатной квитанции, нажмите значок
, чтобы скопировать ссылку.
Добавьте ссылку на ресурс в свой шаблон.
Сброс шаблона квитанции до настроек по умолчанию
Сброс шаблона до значений по умолчанию не поддерживается в редакторе кода чеков. Чтобы вернуться к шаблону печатного чека по умолчанию, перейдите в визуальный редактор чеков, в котором предусмотрен шаблон по умолчанию со всеми стандартными полями.
Переменные Liquid, доступные в редакторе кода квитанций
Следующие переменные Liquid приведены для справки, чтобы помочь вам разобраться в существующих настройках чеков во время переноса. Новые настройки следует создавать в визуальном редакторе чеков.
В редакторе кода квитанций доступны следующие объекты данных:
Объекты квитанции
| Объект | Описание |
|---|---|
shop | Содержит информацию о магазине, например его название. |
location | Содержит информацию о розничной точке, например адрес и номер телефона. |
order | Содержит данные заказа, включая позиции, скидки, налоги и информацию о транзакциях. |
return |
Доступен только в шаблоне return-and-exchange-receipt.liquid и связанных с ним частичных шаблонах.
Содержит данные о возвратах и обменах, включая возвращаемые позиции, новые позиции, итоговую сумму и информацию о транзакциях.
|
gift_card |
Доступен только в шаблоне gift-card.liquid.
Содержит данные подарочной карты, включая баланс, буквенно-цифровой код и контент QR-кода, который можно отсканировать в приложении POS.
|
Объект заказа
| Свойство | Описание |
|---|---|
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 | ИД позиции. |
name | Название товара, к которому при необходимости добавляется название варианта (если применимо). |
variant_title | Название варианта на момент создания заказа. |
price | Цена за единицу товара в позиции на момент создания заказа. Это значение не учитывает скидки. |
is_gift_card | Указывает, представляет ли позиция покупку подарочной карты. |
discount | Общая скидка, назначенная позиции приложениями для скидок, включая скидки, назначенные на возвращенное и удаленное количество товара. |
total_price | Итоговая сумма по этой позиции. |
selling_plan_name | Название плана подписки, назначенного для этой позиции. |
tax_rates | Налоговые строки для этой позиции. |
custom_attributes | Список атрибутов, которые представляют собой пользовательские функции или специальные запросы. |
variant_title | Название варианта. |
variant_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 см. в разделе «Фильтры» справочника по Liquid для тем Shopify.
В редакторе кода квитанций доступны следующие фильтры:
| Свойство | Описание | |
|---|---|---|
t | Переводит предопределённые метки на язык, указанный для вашей точки продаж. | |
money | Форматирует цену в валюте вашей точки продаж. | |
escape |
Экранирует специальные символы HTML, такие как <>, ' и &, и преобразует их в escape-последовательности.
| |
barcode | Генерирует SVG-файл одномерного штрихкода. | |
qrcode | Генерирует SVG-файл двумерного штрихкода. |
Пример настройки кода шаблона печатной квитанции
Вы можете использовать Liquid для добавления условных сообщений. Эта возможность аналогична сохранению настроек для одной точки продаж в визуальном редакторе. Например, ваш бизнес начинался с одной точки продаж, а теперь у вас их несколько. И вы хотите выделить свой первый магазин на печатных квитанциях.
Вы можете добавить собственное сообщение в шаблон header.liquid в папке Sections редактора кода и с помощью Liquid отображать его только для вашего флагманского местоположения.
Приведённый ниже код проверяет название местоположения (в данном случае — вашего первого местоположения «Home») и отображает сообщение «Добро пожаловать в наш первый магазин, открытый в 1972 году», если название местоположения совпадает. На квитанциях, напечатанных в других ваших местоположениях, будет отображаться сообщение «Добро пожаловать в наш магазин».
{% if location.name == 'Home' %}
Welcome to our original store, opened in 1972.
{% else %}
Welcome to our store.
{% endif %}Предварительный просмотр изменений кода в редакторе
Вы можете просмотреть изменения печатных чеков в редакторе кода POS в панели администратора Shopify.
В зависимости от выбранного файла Liquid в окне предварительного просмотра выделяется элемент оформления или раздел квитанции, за который отвечает этот файл. По умолчанию в окне предварительного просмотра отображаются данные последнего заказа в POS. Для всех файлов Liquid, кроме gift-card.liquid, можно выбрать конкретный заказ, данные которого будут использоваться для предварительного просмотра квитанции. Для gift-card.liquid в качестве вариантов предварительного просмотра можно выбирать только места расположения.
Шаги:
Все места расположения POS Pro
В панели администратора Shopify перейдите в раздел Каналы продаж > Point of Sale.
В разделе Настройка обслуживания в магазине нажмите Редактировать рядом с пунктом Чеки.
Нажмите «Настроить квитанции».
Нажмите «Редактировать код».
Нажмите на файл кода, который хотите просмотреть. Ваша квитанция отобразится в крайнем правом окне редактора.
Необязательно: чтобы выбрать конкретный заказ, содержимое которого будет использоваться для предпросмотра квитанции, выполните следующие действия:
- Нажмите значок
.
- В диалоговом окне «Выбрать заказ для предпросмотра» отображаются продажи из канала Point of Sale по всем местоположениям. Выберите заказ из списка или найдите конкретные заказы и местоположения с помощью строки поиска.
- Нажмите «Подтвердить».
- Нажмите значок
Необязательно: если вы просматриваете файл
gift-card.liquid, нажмите значоки выберите местоположение, для которого хотите просмотреть шаблон.
С местами расположения на тарифе Lite/в Италии/во Франции
В панели администратора Shopify перейдите в раздел Каналы продаж > Point of Sale.
В разделе Настройка обслуживания в магазине нажмите Редактировать рядом с пунктом Чеки.
На странице «Настройка квитанций» нажмите «Редактор кода».
Нажмите на файл кода, который хотите просмотреть. Ваша квитанция отобразится в крайнем правом окне редактора.
Необязательно: чтобы выбрать конкретный заказ, содержимое которого будет использоваться для предпросмотра квитанции, выполните следующие действия:
- Нажмите значок
.
- В диалоговом окне «Выбрать заказ для предпросмотра» отображаются продажи из канала Point of Sale по всем местоположениям. Выберите заказ из списка или найдите конкретные заказы и местоположения с помощью строки поиска.
- Нажмите «Подтвердить».
- Нажмите значок
Необязательно: если вы просматриваете файл
gift-card.liquid, нажмите значоки выберите местоположение, для которого хотите просмотреть шаблон.