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.

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
  1. V administrátorovi Shopify prejdite na položky Predajné kanály > Miesto predaja.

  2. V sekcii Prispôsobiť prostredie obchodu kliknite na Upraviť pri možnosti Účtenky.

  3. Kliknite na Použiť editor kódu.

Z nastavení predajného miesta
  1. V administrátorovi Shopify prejdite na Predajné miesto > Nastavenia.

  2. V sekcii Prispôsobenie kliknite na Vytlačené účtenky.

  3. 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:

  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 Kopírovať odkaz a skopírujte odkaz.

  3. Prejdite do editora kódu.

  4. 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

Popis dátových objektov potvrdenia
ObjektPopis
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

Popis objektu 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

Popis objektu 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

Popis objektu skupiny dopravy
VlastnosťPopis
destination
Destinácia prepravovaných produktov.
products
Zoznam prepravovaných produktov.

Objekt samostatnej položky

Popis objektu 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:

Popis objektu samostatnej položky
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:

Popis filtrov pre účtenky
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
  1. V administrátorovi Shopify prejdite na položky Predajné kanály > Miesto predaja.

  2. V sekcii Prispôsobiť prostredie obchodu kliknite na Upraviť pri možnosti Účtenky.

  3. Kliknite na Prispôsobiť potvrdenia.

  4. Kliknite na položku Upraviť kód.

  5. Kliknite na súbor s kódom, ktorý chcete zobraziť. Vaša účtenka sa zobrazí v okne editora úplne vpravo.

  6. Voliteľné: Ak chcete vybrať konkrétnu objednávku, ktorá sa použije ako obsah účtenky v okne ukážky, postupujte takto:

    1. Kliknite na ikonu Zobraziť.
    2. 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.
    3. Kliknite na Potvrdiť.
  7. Voliteľné: Ak si prezeráte ukážku súboru gift-card.liquid, kliknite na ikonu Zobraziť a vyberte lokalitu, pre ktorú chcete zobraziť ukážku šablóny.

S lokalitami Lite/Taliansko/Francúzsko
  1. V administrátorovi Shopify prejdite na položky Predajné kanály > Miesto predaja.

  2. V sekcii Prispôsobiť prostredie obchodu kliknite na Upraviť pri možnosti Účtenky.

  3. Na stránke Prispôsobenie potvrdenia kliknite na možnosť Editor kódu.

  4. Kliknite na súbor s kódom, ktorý chcete zobraziť. Vaša účtenka sa zobrazí v okne editora úplne vpravo.

  5. Voliteľné: Ak chcete vybrať konkrétnu objednávku, ktorá sa použije ako obsah účtenky v okne ukážky, postupujte takto:

    1. Kliknite na ikonu Zobraziť.
    2. 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.
    3. Kliknite na Potvrdiť.
  6. Voliteľné: Ak si prezeráte ukážku súboru gift-card.liquid, kliknite na ikonu Zobraziť a vyberte lokalitu, pre ktorú chcete zobraziť ukážku šablóny.