Editor kódu vytlačených potvrdení pre Shopify POS
Editor kódu účteniek umožňuje prispôsobiť vytlačené účtenky pomocou HTML, CSS a Liquid. Môžete upravovať šablóny účteniek, čo sú typy účteniek, ktoré si môžete v obchode vytlačiť, a šablóny sekcií, čo sú opakovane použiteľné časti účteniek, ako sú hlavička a päta.
Na tejto stránke
- Dôležité informácie o používaní editora kódu potvrdení
- Prístup k editoru kódu
- Používanie vlastných súborov v šablóne potvrdenia
- Obnovenie predvolenej šablóny potvrdenia
- Premenné Liquid dostupné v editore kódu potvrdení
- Filtre Liquid dostupné v editore kódu potvrdení
- Príklad prispôsobenia kódu šablóny vytlačeného potvrdenia
- Náhľad zmien kódu v editore kódu
Dôležité informácie o používaní editora kódu potvrdení
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.
- Nové obchody a lokality nemôžu používať editor kódu. 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ú v šablónach potvrdení dostupné ako premenná a nemožno ich pridať do tlač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.
Prístup k editoru kódu
Editor kódu môžete otvoriť z vizuálneho editora účteniek alebo z nastavení predajného miesta. Odkaz Použiť editor kódu vo vizuálnom editore účteniek je dostupný, len ak všetky vaše lokality POS spĺňajú podmienky na používanie editora kódu. Ak pre niektoré lokality POS nemáte POS Pro, prípadne ak sa nachádzajú v Taliansku alebo vo Francúzsku, otvorte editor kódu v nastaveniach predajného miesta.
Postup:
Z vizuálneho editora účteniek
V administrátorovi Shopify prejdite na položky Predajné kanály > Miesto predaja.
V sekcii Prispôsobiť prostredie obchodu kliknite na Upraviť pri možnosti Účtenky.
Kliknite na Použiť editor kódu.
Z nastavení predajného miesta
V administrátorovi Shopify prejdite na Predajné miesto > Nastavenia.
V sekcii Prispôsobenie kliknite na Vytlačené účtenky.
V sekcii Prispôsobenie rozloženia kliknite na Editor kódu.
Používanie vlastných súborov v šablóne potvrdenia
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 pred použitím v tlačenom potvrdení nahrajte do administrátora Shopify. Ďalšie informácie o nahrávaní súborov.
Postup:
V administrátorovi Shopify prejdite na možnosť Obsah > Súbory.
Vedľa súboru, ktorý chcete zahrnúť do kódu vytlačeného potvrdenia, kliknite na
a skopírujte odkaz.
Pridajte odkaz na súbor do šablóny.
Obnovenie predvolenej šablóny potvrdenia
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.
Premenné Liquid dostupné v editore kódu potvrdenia
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
| Objekt | Popis |
|---|---|
shop | Obsahuje informácie o obchode, napríklad názov obchodu. |
location | Obsahuje informácie o maloobchodnom mieste, napríklad adresu a telefónne číslo. |
order | Obsahuje údaje o objednávke vrátane samostatných položiek, zliav, daní a informácií o transakcii. |
return |
K dispozícii iba v šablóne return-and-exchange-receipt.liquid a v jej priradených čiastočných šablónach.
Obsahuje údaje o vrátení a výmene vrátane vrátených samostatných položiek, nových samostatných položiek, čistej sumy a informácií o transakcii.
|
gift_card |
K dispozícii iba v šablóne gift-card.liquid.
Obsahuje údaje o darčekovej karte vrátane zostatku, alfanumerického kódu a obsahu QR kódu, ktorý môže naskenovať aplikácia POS.
|
Objekt objednávky
| Vlastnosť | Popis |
|---|---|
id | ID objednávky. |
created_at | Dátum a čas vytvorenia objednávky vo formáte ISO 8601. |
source_identifier | Jedinečný identifikátor objednávky POS alebo tretej strany. |
change_due | Výdavok z objednávky. |
balance_due | Dlžná suma za túto objednávku. |
name | Jedinečný identifikátor objednávky, ktorý sa zobrazuje na stránke objednávky v administrátorovi Shopify a na stránke stavu objednávky. Napríklad „#1001“, „EN1001“ alebo „1001-A“. Táto hodnota nie je jedinečná naprieč viacerými obchodmi. |
note | Obsah poznámky priradenej k objednávke. |
line_items | Zoznam samostatných položiek objednávky. |
subtotal_price |
Súčet cien za všetky samostatné položky po odpočítaní zliav a pred vrátením tovaru. Ak je hodnota taxesIncluded pravda (true), medzisúčet zahŕňa aj daň.
|
total_price | Celková cena objednávky pred vrátením. Zahŕňa dane a zľavy. |
total_tip_received | Súčet všetkých prepitných pre objednávku. |
discounts | Celková suma zliav. |
transactions | Zoznam transakcií priradených k objednávke. |
taxes_included | Určuje, či sú dane zahrnuté v cene medzisúčtu objednávky. |
tax_lines | Zoznam všetkých daňových riadkov aplikovaných na samostatné položky v objednávke pred vrátením. Ceny daňových riadkov predstavujú celkovú cenu za všetky daňové riadky s rovnakou sadzbou a názvom. |
customer | Zákazník, ktorý zadal objednávku. |
shipping_address | Dodacia adresa v objednávke. |
shipping_groups | Zoznam skupín dopravy objednávky. Každá skupina obsahuje samostatné položky, ktoré sú splnené spoločne. |
Objekt vrátenia
| Vlastnosť | Popis |
|---|---|
name | Jedinečný identifikátor pre vrátenie, ktorý sa zobrazuje na stránke objednávky v administrátorovi Shopify a na stránke stavu objednávky. Napríklad „#1000-R1“. Táto hodnota nie je jedinečná naprieč viacerými obchodmi. |
created_at | Dátum a čas vytvorenia vrátenia vo formáte ISO 8601. |
is_unverified | Logická hodnota označujúca, či ide o neoverené vrátenie. |
is_exchange | Boolovská hodnota označujúca, či vrátenie zahŕňa výmenu. Patria sem aj vrátenia peňazí na darčekovú kartu. |
exchange_type |
Typ výmeny v prípade, že vrátenie zahŕňa výmenu. Možné hodnoty sú LIKE_FOR_LIKE, NET_REFUNDABLE a NET_PAYABLE.
|
return_discount | Celková vrátená suma zliav objednávky. |
return_subtotal |
Súčet cien za všetky vrátené samostatné položky pred uplatnením zliav. Ak je hodnota taxesIncluded pravda (true), medzisúčet zahŕňa aj daň.
|
return_total | Celková možná suma na vrátenie peňazí. Zahŕňa dane, zľavy, dopravu a prepitné. Nemusí to byť skutočne vrátená suma. |
exchange_subtotal |
Súčet cien za všetky nové samostatné položky vo výmene pred uplatnením zliav. Ak je hodnota taxesIncluded pravda (true), medzisúčet zahŕňa aj daň.
|
exchange_total | Celková suma za všetky nové samostatné položky vo výmene. Zahŕňa dane a zľavy. |
total_cash_rounding_adjustment | Úprava zaokrúhľovania hotovosti aplikovaná na vrátenie alebo výmenu. |
total_adjusted_amount | Celková suma na vrátenie alebo výmenu upravená o úpravu zaokrúhľovania hotovosti. |
net_total | Skutočná celková zaplatená alebo vrátená suma za vrátenie alebo výmenu, a to pred zaokrúhlením hotovosti. |
return_line_items | Vrátené samostatné položky. |
exchange_line_items | Nové samostatné položky vo výmene. |
return_tax_lines | Daňové riadky pre vrátené samostatné položky. |
exchange_tax_lines | Daňové riadky pre nové samostatné položky vo výmene. |
shipping_refund_amount | Vrátená suma za dopravu. |
tip_refund_amount | Vrátená suma prepitného. |
transactions | Transakcie spojené s vrátením alebo výmenou. |
Objekt skupiny dopravy
| Vlastnosť | Popis |
|---|---|
destination | Destinácia prepravovaných produktov. |
products | Zoznam prepravovaných produktov. |
Objekt samostatnej položky
| Vlastnosť | Popis |
|---|---|
id | ID samostatnej položky. |
name | Názov produktu, ku ktorému môže byť pridaný názov variantu (ak je to relevantné). |
variant_title | Názov variantu v čase vytvorenia objednávky. |
price | Jednotková cena samostatnej položky v čase vytvorenia objednávky. Táto hodnota nezahŕňa zľavy. |
is_gift_card | Či samostatná položka predstavuje nákup darčekovej karty. |
discount | Celková zľava pridelená samostatnej položke na základe aplikácií zliav vrátane zliav pridelených vráteným a odstráneným množstvám. |
total_price | Celková suma pre túto samostatnú položku. |
selling_plan_name | Názov predplatného priradeného k samostatnej položke. |
tax_rates | Daňové riadky pre túto samostatnú položku. |
custom_attributes | Zoznam atribútov, ktoré predstavujú vlastné funkcie alebo špeciálne požiadavky. |
variant_title | Názov variantu. |
variant_id | ID variantu. |
variant_metafields | Zoznam vlastných polí, ktoré obchodník priradil k variantu. |
staff_member_description | Člen personálu priradený k samostatnej položke. |
product_metafields | Zoznam vlastných polí, ktoré obchodník priradil k produktu. |
Objekt vrátenej samostatnej položky
Zahŕňa všetko v objekte samostatnej položky a nasledujúce vlastnosti:
| Vlastnosť | Popis |
|---|---|
return_reason | Dôvod vrátenia samostatnej položky. |
return_reason_note | Voliteľná poznámka k dôvodu vrátenia. |
Filtre Liquid dostupné v editore kódu účtenky
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, do bloku kódu jazyka Liquid medzi dvojité zložené zátvorky {{ }} pridajte znak zvislej čiary | a zaň filter. Filtre používajte len v blokoch kódu jazyka 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:
| Vlastnosť | Popis | |
|---|---|---|
t | Preloží preddefinované štítky do jazyka priradeného k vašej lokalite. | |
money | Formátuje cenu v mene vašej lokality. | |
escape |
Konvertuje špeciálne znaky v HTML, ako sú <>, ' a &, na escape sekvencie.
| |
barcode | Generuje SVG 1D čiarového kódu. | |
qrcode | Generuje SVG 2D čiarového kódu. |
Príklad prispôsobenia kódu šablóny vytlačenej účtenky
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 %}Ukážka zmien kódu v editore kódu
Zmeny tlačených účteniek si môžete prezrieť v editore kódu POS v administrátorovi Shopify.
V okne ukážky sa podľa vybraného súboru v jazyku Liquid zvýrazní dizajn alebo časť potvrdenia, ktorú daný súbor ovplyvňuje. Predvolene sa v okne ukážky zobrazuje obsah najnovšej objednávky z POS. Pre všetky súbory v jazyku Liquid okrem súboru gift-card.liquid môžete vybrať konkrétnu objednávku, ktorej obsah sa použije v ukážke potvrdenia. Pri súbore gift-card.liquid sú ako možnosti ukážky na výber len jednotlivé lokality.
Postup:
Všetky lokality POS Pro
V administrátorovi Shopify prejdite na položky Predajné kanály > Miesto predaja.
V sekcii Prispôsobiť prostredie obchodu kliknite na Upraviť pri možnosti Účtenky.
Kliknite na Prispôsobiť potvrdenia.
Kliknite na položku Upraviť kód.
Kliknite na súbor s kódom, ktorý chcete zobraziť. Vaša účtenka sa zobrazí v okne editora úplne vpravo.
Voliteľné: Ak chcete vybrať konkrétnu objednávku, ktorá sa použije ako obsah účtenky v okne ukážky, postupujte takto:
- Kliknite na ikonu
.
- V dialógovom okne Vyberte objednávku na zobrazenie ukážky sa zobrazí predaj uskutočnený z kanála predajného miesta zo všetkých lokalít. Vyberte objednávku zo zoznamu alebo pomocou vyhľadávacieho panela vyhľadajte konkrétne objednávky a lokality.
- Kliknite na Potvrdiť.
- Kliknite na ikonu
Voliteľné: Ak si prezeráte ukážku súboru
gift-card.liquid, kliknite na ikonua vyberte lokalitu, pre ktorú chcete zobraziť ukážku šablóny.
S lokalitami Lite/Taliansko/Francúzsko
V administrátorovi Shopify prejdite na položky Predajné kanály > Miesto predaja.
V sekcii Prispôsobiť prostredie obchodu kliknite na Upraviť pri možnosti Účtenky.
Na stránke Prispôsobenie potvrdenia kliknite na možnosť Editor kódu.
Kliknite na súbor s kódom, ktorý chcete zobraziť. Vaša účtenka sa zobrazí v okne editora úplne vpravo.
Voliteľné: Ak chcete vybrať konkrétnu objednávku, ktorá sa použije ako obsah účtenky v okne ukážky, postupujte takto:
- Kliknite na ikonu
.
- V dialógovom okne Vyberte objednávku na zobrazenie ukážky sa zobrazí predaj uskutočnený z kanála predajného miesta zo všetkých lokalít. Vyberte objednávku zo zoznamu alebo pomocou vyhľadávacieho panela vyhľadajte konkrétne objednávky a lokality.
- Kliknite na Potvrdiť.
- Kliknite na ikonu
Voliteľné: Ak si prezeráte ukážku súboru
gift-card.liquid, kliknite na ikonua vyberte lokalitu, pre ktorú chcete zobraziť ukážku šablóny.