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

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

Вы можете изменять шаблон чека и шаблоны разделов, используемые в печатных чеках. Файлы шаблонов «Чеки» — это типы чеков, которые можно печатать в магазине. «Разделы» — это части чеков, например шапка или футер. Разделы можно использовать повторно в нескольких чеках.

Особенности использования редактора кода для чеков

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

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

• Редактором кода можно пользоваться только в панели администратора Shopify на компьютере.
• Редактор кода недоступен для любых мест расположения POS в Италии.

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

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

Языки кода

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

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

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

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

• Если вы настраиваете квитанцию с помощью редактора кода, в вашем существующем шаблоне могут отсутствовать новые свойства, такие как selling_plan_name. Чтобы добавить в шаблон последние доступные свойства, необходимо вернуть шаблон квитанции к настройкам по умолчанию. При сбросе шаблонов квитанций до значений по умолчанию удаляются все внесенные вами изменения. Сохраните копию вашего измененного кода перед сбросом. После сброса шаблона вам потребуется вручную применить ваши изменения заново.

Доступ к редактору кода

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

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

Шаги:

Использование пользовательских файлов в шаблоне квитанции

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

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

Шаги:

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

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

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

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

Сброс шаблона квитанции до настроек по умолчанию

С помощью редактора кода вы можете сбросить шаблон квитанции до версии по умолчанию.

Шаги:

Переменные Liquid, доступные в редакторе кода квитанций

Вы можете использовать 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 между двойными фигурными скобками {{ }}. Фильтры можно применять только к блокам кода 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.
{% end %}

Предварительный просмотр изменений кода в редакторе

Вы можете просмотреть изменения печатных чеков в редакторе кода POS в панели администратора Shopify.

В зависимости от выбранного файла Liquid в окне предпросмотра подсвечивается дизайн или раздел квитанции, на который влияет этот файл. По умолчанию в окне предпросмотра отображается содержимое для вашего последнего заказа из POS. Можно выбрать конкретный заказ, который будет использоваться для предпросмотра квитанции. Это правило действует для всех файлов Liquid, кроме gift-card.liquid, для которого в качестве доступных для выбора вариантов предпросмотра отображаются только различные местоположения.

Шаги: