Редактор на код за отпечатани разписки за Вашия 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 или се намират в Италия или Франция).

Стъпки:

Всички местоположения с POS Pro
  1. От Вашия администраторски панел на Shopify отидете на Точка на продажба > Настройки.

  2. В раздела Персонализиране кликнете върху Отпечатани разписки, за да отворите редактора на POS.

  3. Кликнете върху иконата Секции в лявата странична лента.

  4. Кликнете върху Редактиране на код.

  5. В диалоговия прозорец Редактиране на код за отпечатани разписки редактирайте кода, който искате да промените.

  6. Кликнете върху Запазване.

  7. По желание: За да продължите да редактирате още страници на Shopify POS с помощта на редактора на POS, върнете се назад в прозореца на браузъра си.

С местоположения Lite или в Италия
  1. От Вашия администраторски панел на Shopify отидете на Точка на продажба > Настройки.

  2. В раздела Персонализиране кликнете върху Отпечатани разписки, за да отворите редактора на POS.

  3. На страницата Персонализиране на разписка кликнете върху Редактор на код.

Използване на персонализирани файлове във Вашия шаблон за разписка

Можете да използвате файлове, като например файлове с изображения, които качвате във Вашия администраторски панел на Shopify, за да персонализирате отпечатаните си разписки.

Преди даден файл да може да бъде използван в отпечатана разписка, той трябва да бъде качен във Вашия администраторски панел на Shopify. Научете повече за качването на файлове.

Стъпки:

  1. От Вашия администраторски панел на Shopify отидете на Съдържание > Файлове.

  2. До файла, който искате да включите в кода на отпечатаната си разписка, кликнете върху Копиране на връзка, за да копирате връзката.

  3. Навигиране до редактора на код.

  4. Включете връзката към ресурса във Вашия шаблон.

Нулиране на шаблона за разписка до настройките по подразбиране

Можете да нулирате шаблон за разписка до версията по подразбиране с помощта на редактора на код.

Стъпки:

Всички местоположения с POS Pro
  1. От Вашия администраторски панел на Shopify отидете на Точка на продажба > Настройки.

  2. В раздела Персонализиране кликнете върху Отпечатани разписки, за да отворите редактора на POS.

  3. Кликнете върху Персонализиране на Вашите разписки.

  4. Кликнете върху Редактиране на код.

  5. Кликнете върху файла с код, който искате да нулирате.

  6. Кликнете върху иконата Нулиране до настройки по подразбиране.

  7. В диалоговия прозорец Нулиране на файла до настройки по подразбиране кликнете върху Нулиране.

С местоположения Lite или в Италия
  1. От Вашия администраторски панел на Shopify отидете на Точка на продажба > Настройки.

  2. В раздела Персонализиране кликнете върху Отпечатани разписки, за да отворите редактора на POS.

  3. На страницата Персонализиране на разписка кликнете върху Редактор на код.

  4. Кликнете върху файла с код, който искате да нулирате.

  5. Кликнете върху иконата Нулиране до настройки по подразбиране.

  6. В диалоговия прозорец Нулиране на файла до настройки по подразбиране кликнете върху Нулиране.

Променливи на 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 на Shopify Themes за подробности относно това как да използвате филтрите на Liquid.

В редактора на код на разписка са налични следните филтри:

Описание на филтрите за разписка
СвойствоОписание
t
Превежда предварително дефинирани етикети на езика, зададен за Вашето местоположение.
money
Форматира цената във валутата на Вашето местоположение.
escape
Екранира специални знаци в HTML, като <>, ' и &, и конвертира знаците в екраниращи последователности.
barcode
Генерира 1D SVG баркод.
qrcode
Генерира 2D 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.
{% end %}

Преглед на промените в кода в редактора на код

Можете да прегледате промените в печатните си разписки в редактора на код на POS в администраторския панел на Shopify.

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

Стъпки:

Всички местоположения с POS Pro
  1. От Вашия администраторски панел на Shopify отидете на Точка на продажба > Настройки.

  2. В раздела Персонализиране кликнете върху Отпечатани разписки, за да отворите редактора на POS.

  3. Кликнете върху Персонализиране на Вашите разписки.

  4. Кликнете върху Редактиране на код.

  5. Кликнете върху кодовия файл, който искате да прегледате. Вашата разписка се показва в най-десния прозорец на редактора.

  6. По избор: За да изберете конкретна поръчка, която да се използва като съдържание на разписката в прозореца за преглед, изпълнете следните действия:

    1. Кликнете върху иконата Преглед.
    2. Продажбите, направени от канала Point of Sale от всички местоположения, се показват в диалоговия прозорец Избор на поръчка за преглед. Изберете поръчка от списъка или търсете конкретни поръчки и местоположения, като използвате лентата за търсене.
    3. Кликнете върху Потвърждаване.
  7. По избор: Ако преглеждате файла gift-card.liquid, кликнете върху иконата Преглед и изберете местоположението, за което искате да прегледате шаблона.

С местоположения Lite или в Италия
  1. От Вашия администраторски панел на Shopify отидете на Точка на продажба > Настройки.

  2. В раздела Персонализиране кликнете върху Отпечатани разписки, за да отворите редактора на POS.

  3. На страницата Персонализиране на разписка кликнете върху Редактор на код.

  4. Кликнете върху кодовия файл, който искате да прегледате. Вашата разписка се показва в най-десния прозорец на редактора.

  5. По избор: За да изберете конкретна поръчка, която да се използва като съдържание на разписката в прозореца за преглед, изпълнете следните действия:

    1. Кликнете върху иконата Преглед.
    2. Продажбите, направени от канала Point of Sale от всички местоположения, се показват в диалоговия прозорец Избор на поръчка за преглед. Изберете поръчка от списъка или търсете конкретни поръчки и местоположения, като използвате лентата за търсене.
    3. Кликнете върху Потвърждаване.
  6. По избор: Ако преглеждате файла gift-card.liquid, кликнете върху иконата Преглед и изберете местоположението, за което искате да прегледате шаблона.