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

Vytlačené potvrdenia si môžete prispôsobiť pomocou editora kódu v administrátorovi Shopify. Súbory, z ktorých pozostávajú vaše potvrdenia, obsahujú šablónový jazyk Shopify – Liquid. V editore kódu môžete pomocou jazykov HTML, CSS a Liquid vytvárať pokročilejšie prispôsobenia ako vo vizuálnom editore.

Môžete zmeniť šablónu potvrdenia aj šablóny sekcií, ktoré sa používajú vo vytlačených potvrdeniach. Súbory šablón Potvrdenia predstavujú typy potvrdení, ktoré môžete vo svojom obchode vytlačiť. Sekcie sú časti potvrdení, napríklad hlavička alebo päta. Sekcie sa dajú opakovane použiť vo viacerých potvrdeniach.

Na tejto stránke

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.

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.
Vo vytlačených potvrdeniach, ktoré majú šablónu v editore kódu, môžete upravovať napríklad potvrdenia o predaji, darčekové doklady, potvrdenia k darčekovým kartám a potvrdenia o vrátení a výmene.

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.
Ak chcete upravovať šablóny v editore kódu potvrdení, musíte ovládať jazyky HTML, CSS a Liquid. Podpora pre témy Shopify vám môže pomôcť s drobnými úpravami v rámci zásad dizajnu 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

Ak prispôsobíte potvrdenie v editore kódu potvrdení, v existujúcej šablóne môžu chýbať nové vlastnosti, ako napríklad selling_plan_name. Ak chcete do šablóny pridať najnovšie dostupné vlastnosti, musíte resetovať šablónu potvrdenia na predvolenú. Resetovaním šablón potvrdení na predvolené sa odstránia všetky vaše prispôsobenia. Pred resetovaním si prispôsobený kód poznačte. Po resetovaní šablóny musíte prispôsobenia manuálne aplikovať znova.

Prístup k editoru kódu

Šablóny môžete upravovať pomocou editora kódu. Najprv musíte z predvoleného vizuálneho editora prejsť na používanie editora kódu. Kedykoľvek sa však môžete vrátiť 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:

Všetky lokality POS Pro

V administrátorovi Shopify prejdite na možnosť Miesto predaja > Nastavenia.
V sekcii Prispôsobenie kliknutím na Tlačené potvrdenky otvorte editor POS.
Kliknite na ikonu na ľavom bočnom paneli.
Kliknite na položku Upraviť kód.
V dialógovom okne Upraviť kód vytlačených potvrdení upravte kód, ktorý chcete zmeniť.
Kliknite na Uložiť.
Voliteľné: Ak chcete pokračovať v úprave ďalších stránok Shopify POS pomocou editora POS, prejdite späť v okne prehliadača.

Lokality s plánom Lite alebo v Taliansku

V administrátorovi Shopify prejdite na možnosť Miesto predaja > Nastavenia.
V sekcii Prispôsobenie kliknutím na Tlačené potvrdenky otvorte editor POS.
Na stránke Prispôsobenie potvrdenia kliknite na možnosť 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 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:

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.
Prejdite do editora kódu.
Pridajte odkaz na súbor do šablóny.

Obnovenie predvolenej šablóny potvrdenia

Šablónu potvrdenia môžete obnoviť na predvolenú verziu pomocou editora kódu.

Postup:

Všetky lokality POS Pro

V administrátorovi Shopify prejdite na možnosť Miesto predaja > Nastavenia.
V sekcii Prispôsobenie kliknutím na Tlačené potvrdenky otvorte editor POS.
Kliknite na Prispôsobiť potvrdenia.
Kliknite na položku Upraviť kód.
Kliknite na súbor kódu, ktorý chcete obnoviť.
Kliknite na ikonu .
V dialógovom okne Obnoviť súbor na predvolený kliknite na Obnoviť.

Lokality s plánom Lite alebo v Taliansku

V administrátorovi Shopify prejdite na možnosť Miesto predaja > Nastavenia.
V sekcii Prispôsobenie kliknutím na Tlačené potvrdenky otvorte editor POS.
Na stránke Prispôsobenie potvrdenia kliknite na možnosť Editor kódu.
Kliknite na súbor kódu, ktorý chcete obnoviť.
Kliknite na ikonu .
V dialógovom okne Obnoviť súbor na predvolený kliknite na Obnoviť.

Premenné Liquid dostupné v editore kódu potvrdenia

Na prispôsobenie šablóny vytlačeného potvrdenia a typov potvrdení môžete použiť Liquid.

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

Objekty potvrdenia

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

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 u administrátora Shopify a na stránke stavu objednávky. Napríklad „#1001“, „EN1001“ alebo „1001-A“. Táto hodnota nie je jedinečná vo viacerých obchodoch.
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 vrátenia, ktorý sa zobrazuje na stránke objednávky u administrátora Shopify a na stránke stavu objednávky. Napríklad „#1000-R1“. Táto hodnota nie je jedinečná vo viacerých obchodoch.
created_at	Dátum a čas vytvorenia vrátenia vo formáte ISO 8601.
is_unverified	Boolovská hodnota označujúca, či bolo vrátenie vytvorené ako 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

Pomocou filtrov Liquid môžete upravovať informácie v šablónach účteniek. 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:

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.
{% end %}

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

Všetky lokality POS Pro

V administrátorovi Shopify prejdite na možnosť Miesto predaja > Nastavenia.
V sekcii Prispôsobenie kliknutím na Tlačené potvrdenky otvorte editor POS.
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:
1. Kliknite na ikonu .
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ť.
Voliteľné: Ak si prezeráte ukážku súboru gift-card.liquid, kliknite na ikonu a vyberte lokalitu, pre ktorú chcete zobraziť ukážku šablóny.

Lokality s plánom Lite alebo v Taliansku

V administrátorovi Shopify prejdite na možnosť Miesto predaja > Nastavenia.
V sekcii Prispôsobenie kliknutím na Tlačené potvrdenky otvorte editor POS.
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:
1. Kliknite na ikonu .
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ť.
Voliteľné: Ak si prezeráte ukážku súboru gift-card.liquid, kliknite na ikonu a vyberte lokalitu, pre ktorú chcete zobraziť ukážku šablóny.