Редактор кода для печатных чеков в Shopify POS

Прежде чем использовать редактор кода для чеков, ознакомьтесь со следующими особенностями:

Ограничения доступа

• Редактором кода можно пользоваться только в панели администратора Shopify на компьютере.
• Редактор кода недоступен для мест расположения POS в Италии или Франции.
• В редактор кода нельзя добавлять новые магазины или места расположения. Редактор кода остается доступным для магазинов с существующими настройками, которые еще не были перенесены.

Область применения изменений

• Изменения кода, которые вы вносите, применяются только к выбранному месту расположения.
• Настройки в редакторе кода применяются только к точкам продаж POS Pro. Если вы используете редактор кода и у вас есть точки продаж без подписки POS Pro, то для этих точек продаж вы можете настроить шапку и подвал с помощью визуального редактора.
• Вы можете настраивать печатные чеки, для которых в редакторе кода есть шаблон, например чеки продаж, подарочные чеки, чеки подарочных карт, а также чеки возврата и обмена.

Языки кода

• Файлы, из которых состоят ваши квитанции, содержат код на Liquid — языке шаблонов Shopify. Подробнее об использовании Liquid.
• Чтобы редактировать шаблоны в редакторе кода квитанций, необходимо знание HTML, CSS и Liquid. Служба поддержки тем Shopify не может вносить значительные изменения в шаблоны квитанций за вас, но может помочь с небольшими корректировками бесплатных тем Shopify в рамках Политики дизайна Shopify. Для выполнения более сложных изменений подумайте о том, чтобы нанять партнера Shopify.

Ограничения настройки

• В редакторе кода нельзя предварительно просматривать квитанции для разных размеров принтеров. Чтобы выполнить предварительный просмотр с учетом размера принтера, используйте визуальный редактор.
• Описания товаров недоступны в качестве переменной в шаблонах квитанций и не могут быть добавлены в распечатанные квитанции.

Поддержка шаблонов

• Шаблоны чеков в редакторе кода больше не получают обновлений. Свойства, добавленные после 1 июня 2026 года, доступны только в визуальном редакторе.
• Сброс шаблона до значений по умолчанию больше не поддерживается. Чтобы вернуться к шаблону по умолчанию, перейдите в визуальный редактор.

Действия по переключению между редакторами немного отличаются в зависимости от того, все ли ваши места расположения POS подходят для использования редактора кода, или только некоторые из них, например, если некоторые из ваших мест расположения POS не используют POS Pro или находятся в Италии или Франции.

Шаги:

Вы можете использовать файлы (например, изображения), загруженные в панель администратора Shopify, для настройки печатных квитанций.

Прежде чем использовать файл в печатной квитанции, его необходимо загрузить в панель администратора Shopify. Подробнее о загрузке файлов.

Шаги:

1. В панели администратора Shopify перейдите в раздел Контент > Файлы.

2. Рядом с файлом, который вы хотите добавить в код печатной квитанции, нажмите значок , чтобы скопировать ссылку.

3. Переход в редактор кода.

4. Добавьте ссылку на ресурс в свой шаблон.

Сброс шаблона до значений по умолчанию не поддерживается в редакторе кода чеков. Чтобы вернуться к шаблону печатного чека по умолчанию, перейдите в визуальный редактор чеков, в котором предусмотрен шаблон по умолчанию со всеми стандартными полями.

Следующие переменные Liquid приведены для справки, чтобы помочь вам разобраться в существующих настройках чеков во время переноса. Новые настройки следует создавать в визуальном редакторе чеков.

В редакторе кода квитанций доступны следующие объекты данных:

Объекты квитанции

shop

location

order

return

gift_card

Объект заказа

id

created_at

source_identifier

change_due

balance_due

name

note

line_items

subtotal_price

total_price

total_tip_received

discounts

transactions

taxes_included

tax_lines

customer

shipping_address

shipping_groups

Объект возврата

name

created_at

is_unverified

is_exchange

exchange_type

return_discount

return_subtotal

return_total

exchange_subtotal

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.

В следующем примере фильтр преобразует налоговый код из нижнего регистра в верхний.

{{ tax_line.title | upcase }}

В приведённом блоке кода product — это объект, title — его свойство, а upcase — применённый фильтр. Фильтр upcase изменяет регистр значения tax_line.title на верхний. Например, если значение tax_line.title — Hst, то фильтр upcase изменит его на HST.

Подробную информацию об использовании фильтров Liquid см. в разделе «Фильтры» справочника по Liquid для тем Shopify.

В редакторе кода квитанций доступны следующие фильтры:

t

money

escape

barcode

qrcode

Вы можете использовать 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, для которого в качестве доступных для выбора вариантов предпросмотра отображаются только различные местоположения.

Шаги: