Editor kódu vytlačených potvrdení pre Shopify POS

Pred použitím editora kódu potvrdení si prečítajte nasledujúce dôležité informácie:

Obmedzenia prístupu

• Editor kódu môžete používať len v administrátorovi Shopify na pracovnej ploche.
• Editor kódu nie je dostupný pre žiadne lokality POS v Taliansku ani vo Francúzsku.
• Do editora kódu nemožno pridávať žiadne nové obchody ani lokality. Editor kódu zostáva dostupný pre obchody s existujúcimi prispôsobeniami, ktoré ešte neboli migrované.

Kde sa uplatňujú zmeny

• Vykonané zmeny kódu sa vzťahujú iba na vybratú lokalitu.
• Prispôsobenia v editore kódu sa vzťahujú len na lokality s predplatným POS Pro. Ak používate editor kódu a máte aj lokality bez POS Pro, môžete na nich prispôsobiť hlavičku a pätu pomocou vizuálneho editora.
• V editore kódu môžete prispôsobiť vytlačené účtenky, ktoré majú šablónu, ako sú potvrdenia o predaji, darčekové doklady, účtenky pre darčekové karty a účtenky pre vrátenie a výmenu.

Programovacie jazyky

• Súbory tvoriace vaše potvrdenia obsahujú Liquid, šablónový jazyk od Shopify. Získajte ďalšie informácie o používaní jazyka Liquid.
• Na úpravu šablón v editore kódu potvrdení musíte ovládať HTML, CSS a Liquid. Podpora pre témy Shopify nemôže rozsiahlo upravovať šablóny potvrdení za vás, ale môže pomôcť s menšími úpravami bezplatných tém Shopify v rozsahu Zásad dizajnu Shopify. V prípade zložitejších zmien zvážte najatie Partnera Shopify.

Obmedzenia prispôsobenia

• V editore kódu si nemôžete zobraziť ukážku potvrdení pre rôzne veľkosti tlačiarne. Na zobrazenie ukážky podľa veľkosti tlačiarne použite vizuálny editor.
• Opisy produktov nie sú dostupné ako premenná v šablónach potvrdení a nemožno ich pridať do vytlačených potvrdení.

Údržba šablón

• Šablóny účteniek v editore kódu už nebudú dostávať aktualizácie. Vlastnosti pridané po 1. júni 2026 sú dostupné len vo vizuálnom editore.
• Obnovenie šablóny na predvolenú hodnotu už nie je podporované. Ak sa chcete vrátiť k predvolenej šablóne, migrujte do vizuálneho editora.

Kroky na prepínanie medzi editormi sa mierne líšia v závislosti od toho, či majú všetky vaše lokality POS nárok na editor kódu, alebo či naň majú nárok len niektoré lokality POS, napríklad ak niektoré vaše lokality POS nevyužívajú POS Pro alebo sa nachádzajú v Taliansku alebo vo Francúzsku.

Postup:

Na prispôsobenie vytlačených potvrdení môžete použiť súbory, napríklad obrázky, ktoré nahráte do administrátora Shopify.

Súbor musí byť nahraný do administrátora Shopify predtým, ako ho bude možné použiť vo vytlačenom potvrdení. Ďalšie informácie o nahrávaní súborov.

Postup:

1. V administrátorovi Shopify prejdite na možnosť Obsah > Súbory.

2. Vedľa súboru, ktorý chcete zahrnúť do kódu vytlačeného potvrdenia, kliknite na a skopírujte odkaz.

3. Prejdite do editora kódu.

4. Pridajte odkaz na súbor do šablóny.

Obnovenie predvolenej šablóny nie je v editore kódu účteniek podporované. Ak sa chcete vrátiť k predvolenej šablóne vytlačenej účtenky, migrujte do vizuálneho editora účteniek, ktorý poskytuje predvolenú šablónu so všetkými štandardnými poľami.

Nasledujúce premenné Liquid slúžia ako referencia, ktorá vám pomôže pochopiť existujúce prispôsobenia účteniek počas migrácie. Nové prispôsobenia by sa mali vytvárať vo vizuálnom editore účteniek.

V editore kódu potvrdenia sú k dispozícii nasledujúce dátové objekty:

Objekty potvrdenia

shop

location

order

return

gift_card

Objekt objednávky

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

Objekt vrátenia

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

Objekt skupiny dopravy

destination

products

Objekt samostatnej položky

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

Objekt vrátenej samostatnej položky

Zahŕňa všetko v objekte samostatnej položky a nasledujúce vlastnosti:

return_reason

return_reason_note

Na úpravu informácií v šablónach účteniek môžete použiť filtre Liquid. Môžete napríklad zmeniť formátovanie meny alebo veľké a malé písmená v určitom texte, ako je napríklad daňový kód.

Ak chcete použiť filter, pridajte znak zvislej čiary | a potom samotný filter do bloku kódu Liquid medzi dvojité zložené zátvorky {{ }}. Filtre je možné použiť iba v blokoch kódu Liquid.

V nasledujúcom príklade filter mení daňový kód z malých písmen na veľké.

{{ tax_line.title | upcase }}

V príkladovom bloku kódu je product objekt, title je jeho vlastnosť a upcase je použitý filter. Filter upcase zmení veľkosť písmen v hodnote tax_line.title na veľké. Ak má napríklad tax_line.title hodnotu Hst, filter upcase ju zmení na HST.

Podrobnosti o používaní filtrov Liquid nájdete v časti Filtre v príručke Liquid pre témy Shopify.

V editore kódu účtenky sú dostupné nasledujúce filtre:

t

money

escape

barcode

qrcode

Pomocou jazyka Liquid môžete pridať podmienené správy. Táto funkcia je podobná ukladaniu do jednej lokality pomocou vizuálneho editora. Vaša firma napríklad začínala s jednou lokalitou a teraz máte niekoľko nových. Na tlačených účtenkách chcete zvýrazniť svoj pôvodný obchod.

Do šablóny header.liquid v priečinku Sections v editore kódu môžete pridať vlastnú správu a pomocou jazyka Liquid zabezpečiť, aby sa zobrazovala iba pre vašu vlajkovú lokalitu.

Nasledujúci kód skontroluje názov lokality, v tomto prípade vašu pôvodnú lokalitu s názvom „Domov“, a ak sa lokalita zhoduje s týmto názvom, zobrazí sa správa „Vitajte v našom pôvodnom obchode otvorenom v roku 1972.“. Namiesto toho sa na účtenkách vytlačených v iných lokalitách zobrazí správa „Vitajte v našom obchode.“.

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

Zmeny tlačených účteniek si môžete prezrieť v editore kódu POS v administrátorovi Shopify.

V závislosti od vybratého súboru Liquid okno ukážky zvýrazní dizajn alebo časť účtenky, ktorú tento súbor ovplyvňuje. V predvolenom nastavení sa v okne ukážky zobrazuje obsah vašej najnovšej objednávky v POS. Pri všetkých súboroch Liquid okrem gift-card.liquid, ktorý ako možnosti náhľadu na výber zobrazuje len rôzne lokality, si môžete vybrať konkrétnu objednávku, ktorá sa v okne ukážky použije ako obsah účtenky.

Postup: