Urejevalnik kode za natisnjena potrdila za Shopify prodajno mesto

Urejevalnik kode za potrdila vam omogoča prilagajanje tiskanih potrdil z uporabo HTML-ja, seznamov slogov (CSS) in Liquida. Urejate lahko predloge potrdil, ki so vrste potrdil, ki jih lahko natisnete v svoji trgovini, in predloge razdelkov, ki so deli potrdil za večkratno uporabo, kot sta glava in noga.

Na tej strani

Dejavniki pri uporabi urejevalnika kode za potrdila

Preden uporabite urejevalnik kode za potrdila, preglejte naslednje dejavnike:

Omejitve dostopa

Urejevalnik kode lahko uporabljate samo v skrbniku Shopify v namiznem računalniku.
Urejevalnik kode ni na voljo za nobeno prodajno mesto v Italiji ali Franciji.
V urejevalnik kode ni mogoče dodati novih trgovin ali lokacij. Urejevalnik kode ostaja na voljo za trgovine z obstoječimi prilagoditvami, ki še niso bile prenesene.

Kje se uporabijo spremembe

Spremembe kode, ki jih izvedete, veljajo samo za izbrano lokacijo.
Prilagoditve v urejevalniku kode veljajo samo za prodajna mesta s storitvijo POS Pro. Če uporabljate urejevalnik kode in imate prodajna mesta brez storitve POS Pro, lahko uporabite vizualni urejevalnik in prilagodite glavo in nogo za ta prodajna mesta.
Tiskanim potrdilom, ki imajo predlogo v urejevalniku kode, na primer potrdilom o prodaji, darilnim izpisom, potrdilom o darilni kartici ter potrdilom o vračilu in menjavi, lahko dodate prilagoditve.

Kodni jeziki

Datoteke, ki sestavljajo potrdila, vsebujejo Liquid, Shopifyjev jezik za predloge. Več informacij o uporabi jezika Liquid.
Za urejanje predlog v urejevalniku kode potrdil morate poznati HTML, sezname slogov (CSS) in Liquid. Podpora za teme Shopify ne more izvajati obsežnejših urejanj predlog potrdil namesto vas, lahko pa vam morda pomaga pri manjših prilagoditvah brezplačnih tem Shopify v obsegu Shopifyjevega pravilnika o oblikovanju. Za kompleksnejše spremembe razmislite o tem, da bi zaposlili Shopify Partnerja.

Omejitve prilagajanja

V urejevalniku kode ne morete predogledati potrdil v različnih velikostih tiskalnikov. Za predogled glede na velikost tiskalnika uporabite vizualni urejevalnik.
Opisi izdelkov niso na voljo kot spremenljivka v predlogah potrdil in jih ni mogoče dodati na natisnjena potrdila.

Vzdrževanje predlog

Predloge potrdil v urejevalniku kode ne prejemajo več posodobitev. Lastnosti, dodane po 1. juniju 2026, so na voljo samo v vizualnem urejevalniku.
Ponastavitev predloge na privzeto vrednost ni več podprta. Če se želite vrniti na privzeto predlogo, preidite v vizualni urejevalnik.

Dostop do urejevalnika kode

Koraki za preklapljanje med urejevalnikoma se nekoliko razlikujejo glede na to, ali so vsa vaša prodajna mesta upravičena do urejevalnika kode ali pa so upravičena le nekatera, na primer, nekatera vaša prodajna mesta ne uporabljajo POS Pro ali pa so v Italiji ali Franciji.

Koraki:

Vsa prodajna mesta s storitvijo POS Pro

V skrbniku Shopify odprite Prodajni kanali > Prodajno mesto.
V razdelku Prilagajanje izkušnje v trgovini kliknite Uredi pri Potrdila o nakupu.
Kliknite ikono v levi stranski vrstici.
Kliknite Uredi kodo.
V pogovornem oknu Uredi kodo za tiskana potrdila uredite kodo, ki jo želite spremeniti.
Kliknite Shrani.
Izbirno: Če želite nadaljevati urejanje več strani Shopify POS s pomočjo urejevalnika POS, se vrnite nazaj v oknu brskalnika.

Z lokacijami Lite/Italija/Francija

V skrbniku Shopify odprite Prodajni kanali > Prodajno mesto.
V razdelku Prilagajanje izkušnje v trgovini kliknite Uredi pri Potrdila o nakupu.
Na strani Prilagoditev potrdil kliknite Urejevalnik kode.

Uporaba datotek po meri v predlogi potrdila

Za prilagajanje natisnjenih potrdil lahko uporabite datoteke, kot so slikovna sredstva, ki jih naložite v skrbnika Shopify.

Datoteko morate naložiti v skrbnika Shopify, preden jo lahko uporabite v natisnjenem potrdilu. Več informacij o nalaganju datotek.

Koraki:

V skrbniku Shopify odprite Vsebina > Datoteke.
Poleg datoteke, ki jo želite vključiti v kodo natisnjenega potrdila, kliknite , da kopirate povezavo.
Pojdite v urejevalnik kode.
Vključite povezavo do sredstva v svojo predlogo.

Ponastavitev predloge potrdila na privzeto

Ponastavitev predloge na privzeto v urejevalniku kode za potrdila ni podprta. Če se želite vrniti na privzeto predlogo za tiskano potrdilo, preidite na vizualni urejevalnik potrdil, ki omogoča uporabo privzete predloge z vsemi standardnimi polji.

Spremenljivke Liquid v urejevalniku kode potrdila

Spodnje spremenljivke Liquid so na voljo za referenco, da boste lažje razumeli svoje obstoječe prilagoditve potrdil med prenosom. Nove prilagoditve je treba ustvariti v vizualnem urejevalniku potrdil.

V urejevalniku kode potrdila so na voljo naslednji podatkovni objekti:

Objekti potrdila

Opis podatkovnih objektov potrdila
Objekt	Opis
shop	Vsebuje informacije o trgovini, kot je ime trgovine.
location	Vsebuje informacije o maloprodajni lokaciji, kot sta naslov in telefonska številka.
order	Vsebuje podatke o naročilu, vključno s postavkami, popusti, davki in informacijami o transakciji.
return	Na voljo samo v predlogi `return-and-exchange-receipt.liquid` in njenih povezanih delnih predlogah. Vsebuje podatke o vračilu in menjavi, vključno z vrnjenimi postavkami, novimi postavkami, neto skupnim zneskom in informacijami o transakciji.
gift_card	Na voljo samo v predlogi `gift-card.liquid`. Vsebuje podatke o darilni kartici, vključno s stanjem, alfanumerično kodo in vsebino QR kode, ki jo lahko skenira aplikacija POS.

Objekt naročila

Opis objekta naročila
Lastnost	Opis
id	ID naročila.
created_at	Datum in čas ustvarjanja naročila v formatu ISO 8601.
source_identifier	Edinstvena oznaka naročila POS ali zunanjega izvajalca.
change_due	Znesek vračila za naročilo.
balance_due	Dolg za to naročilo.
name	Enolična oznaka za naročilo, ki je prikazana na strani naročila v skrbniku Shopify in na strani stanja naročila. Na primer »#1001«, »EN1001« ali »1001-A«. Ta vrednost ni edinstvena v več trgovinah.
note	Vsebina opombe, povezane z naročilom.
line_items	Seznam postavk naročila.
subtotal_price	Vsota cen vseh postavk po popustih in pred vračili. Če velja `taxesIncluded`, vmesni seštevek vključuje tudi davek.
total_price	Skupna cena naročila pred vračili. To vključuje davke in popuste.
total_tip_received	Vsota vseh zneskov napitnin za naročilo.
discounts	Skupni znesek popustov.
transactions	Seznam transakcij, povezanih z naročilom.
taxes_included	Ali so davki vključeni v ceno vmesnega seštevka naročila.
tax_lines	Seznam vseh davčnih postavk, ki so uveljavljene za postavke v naročilu, pred vračili. Cene davčnih postavk predstavljajo skupno ceno za vse davčne postavke z enako stopnjo in naslovom.
customer	Stranka, ki je oddala naročilo.
shipping_address	Naslov za dostavo v naročilu.
shipping_groups	Seznam skupin za dostavo v naročilu. Vsaka skupina vsebuje postavke, ki so izpolnjene skupaj.

Objekt vračila

Opis objekta vračila
Lastnost	Opis
name	Enolična oznaka za vračilo, ki je prikazana na strani naročila v skrbniku Shopify in na strani stanja naročila. Na primer »#1000-R1«. Ta vrednost ni edinstvena v več trgovinah.
created_at	Datum in čas ustvarjanja vračila v formatu ISO 8601.
is_unverified	Boolova vrednost, ki označuje, ali je bilo vračilo ustvarjeno kot nepotrjeno vračilo.
is_exchange	Boolova vrednost, ki označuje, ali vračilo vključuje menjavo. To vključuje povračila na darilno kartico.
exchange_type	Vrsta menjave, če vračilo vključuje menjavo. Možne vrednosti so `LIKE_FOR_LIKE`, `NET_REFUNDABLE` in `NET_PAYABLE`.
return_discount	Skupni znesek popustov na naročilo, ki so bili povrnjeni.
return_subtotal	Vsota cen vseh postavk za vračilo pred popusti. Če velja `taxesIncluded`, potem vmesni seštevek vključuje tudi davek.
return_total	Skupni možen znesek povračila. To vključuje davke, popuste, dostavo in napitnine. To morda ni dejanski povrnjeni znesek.
exchange_subtotal	Vsota cen za vse nove postavke pri menjavi pred popusti. Če velja `taxesIncluded`, potem vmesni seštevek vključuje tudi davek.
exchange_total	Skupni znesek za vse nove postavke pri menjavi. To vključuje davke in popuste.
total_cash_rounding_adjustment	Prilagoditev za zaokroževanje gotovine, uporabljena pri vračilu ali menjavi.
total_adjusted_amount	Skupni znesek za vračilo ali menjavo, prilagojen s prilagoditvijo za zaokroževanje gotovine.
net_total	Dejanski skupni plačani ali povrnjeni znesek za vračilo ali menjavo in pred zaokroževanjem gotovine.
return_line_items	Vrnjene postavke.
exchange_line_items	Nove postavke pri menjavi.
return_tax_lines	Davčne postavke za vrnjene postavke.
exchange_tax_lines	Davčne postavke za nove postavke pri menjavi.
shipping_refund_amount	Znesek dostave, ki je bil povrnjen.
tip_refund_amount	Znesek napitnine, ki je bil povrnjen.
transactions	Transakcije, povezane z vračilom denarja ali menjavo.

Objekt skupine za dostavo

Opis objekta skupine za dostavo
Lastnost	Opis
destination	Destinacija izdelkov, ki se pošiljajo.
products	Seznam izdelkov, ki se pošiljajo.

Objekt postavke

Opis objekta postavke
Lastnost	Opis
id	ID postavke.
name	Ime izdelka, ki mu je izbirno dodano ime različice (če je na voljo).
variant_title	Ime različice v času ustvarjanja naročila.
price	Cena na enoto za postavko v času ustvarjanja naročila. Ta vrednost ne vključuje popustov.
is_gift_card	Ali postavka predstavlja nakup darilne kartice.
discount	Skupni popust, ki so ga aplikacije za popuste dodelile postavki, vključno s popusti za povrnjene in odstranjene količine.
total_price	Skupni znesek za to postavko.
selling_plan_name	Ime naročniškega načrta, ki je dodeljen postavki.
tax_rates	Davčne postavke za to postavko.
custom_attributes	Seznam lastnosti, ki predstavljajo funkcije po meri ali posebne zahteve.
variant_title	Ime različice.
variant_id	ID različice.
variant_metafields	Seznam polj po meri, ki jih je trgovec povezal z različico.
staff_member_description	Član osebja, pripisan postavki.
product_metafields	Seznam polj po meri, ki jih je trgovec povezal z izdelkom.

Objekt postavke vračila

Vključuje vse v objektu postavke in naslednje lastnosti:

Opis objekta postavke
Lastnost	Opis
return_reason	Razlog za vračilo postavke.
return_reason_note	Izbirna opomba, ki je priložena razlogu za vračilo.

Filtri Liquid, ki so na voljo v urejevalniku kode za potrdila o nakupu

S filtri za Liquid lahko prilagodite informacije v svojih predlogah potrdil. Spremenite lahko na primer oblikovanje valute ali uporabo velikih začetnic v določenem besedilu, kot je davčna koda.

Če želite uporabiti filter, dodajte znak navpičnice | in nato filter v bloku kode Liquid med dvojnimi zavitimi oklepaji {{ }}. Filtre je mogoče uporabiti samo za bloke kode Liquid.

V naslednjem primeru filter prilagodi davčno kodo iz malih v velike črke.

{{ tax_line.title | upcase }}

V primeru bloka kode je product objekt, title njegova lastnost, upcase pa uporabljen filter. Filter upcase spremeni vrednost tax_line.title v velike črke. Če ima na primer tax_line.title vrednost Hst, filter upcase spremeni vrednost v HST.

Za podrobnosti o tem, kako uporabljati filtre Liquid, glejte razdelek o filtrih v referenčnem priročniku za Shopify Themes Liquid.

V urejevalniku kode za potrdila o nakupu so na voljo naslednji filtri:

Opis filtrov potrdil
Lastnost	Opis
t	Prevede vnaprej določene oznake v jezik, ki je dodeljen vaši lokaciji.
money	Oblikuje ceno v valuti vaše lokacije.
escape	Ubeži posebne znake v HTML-ju, kot so `<>`, `'` in `&`, ter jih pretvori v ubežna zaporedja.
barcode	Ustvari SVG s črtno kodo 1D.
qrcode	Ustvari SVG s črtno kodo 2D.

Primer prilagajanja kode predloge tiskanega potrdila o nakupu

Liquid lahko uporabite za dodajanje pogojnega sporočanja. Ta funkcija je podobna shranjevanju na eno lokacijo z vizualnim urejevalnikom. Vaše podjetje je na primer začelo na eni lokaciji, zdaj pa imate več novih lokacij. Na natisnjenih potrdilih želite poudariti svojo prvotno trgovino.

V predlogo header.liquid v mapi urejevalnika kode Sections lahko dodate sporočilo po meri in uporabite Liquid za prikaz sporočila samo za glavno lokacijo.

Naslednja koda preveri ime lokacije, v tem primeru vašo prvotno lokacijo »Home«, in prikaže sporočilo »Welcome to our original store, opened in 1972.« (Dobrodošli v naši prvotni trgovini, odprti leta 1972), če se lokacija ujema z imenom. Na potrdilih, natisnjenih z drugih lokacij, se namesto tega prikaže sporočilo »Welcome to our store.« (Dobrodošli v naši trgovini).

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

Predogled sprememb kode v urejevalniku kode

Predogled sprememb natisnjenih potrdil o nakupu si lahko ogledate v urejevalniku kode POS v skrbniku Shopify.

Odvisno od tega, katera datoteka Liquid je izbrana, okno za predogled označi obliko ali razdelek potrdila, na katerega vpliva datoteka. Okno za predogled privzeto prikazuje vsebino vašega najnovejšega naročila POS. Za vse datoteke Liquid razen datoteke gift-card.liquid lahko v oknu za predogled izberete določeno naročilo, ki ga želite uporabiti kot vsebino potrdila, medtem ko ta datoteka kot možnosti predogleda prikaže le različne lokacije.

Koraki:

Vsa prodajna mesta s storitvijo POS Pro

V skrbniku Shopify odprite Prodajni kanali > Prodajno mesto.
V razdelku Prilagajanje izkušnje v trgovini kliknite Uredi pri Potrdila o nakupu.
Kliknite Prilagodi potrdila.
Kliknite Uredi kodo.
Kliknite datoteko kode, ki si jo želite predogledati. Vaše potrdilo se prikaže v skrajno desnem oknu urejevalnika.
Izbirno: Če želite v oknu za predogled izbrati določeno naročilo, ki ga želite uporabiti kot vsebino potrdila, izvedite naslednja dejanja:
1. Kliknite ikono .
2. Prodaje, opravljene prek kanala Prodajno mesto na vseh lokacijah, se prikažejo v pogovornem oknu Izberite naročilo za predogled. Izberite naročilo s seznama ali pa z iskalno vrstico poiščite določena naročila in lokacije.
3. Kliknite Potrdi.
Izbirno: Če si ogledujete predogled datoteke gift-card.liquid, kliknite ikono in izberite lokacijo, za katero želite prikazati predogled predloge.

Z lokacijami Lite/Italija/Francija

V skrbniku Shopify odprite Prodajni kanali > Prodajno mesto.
V razdelku Prilagajanje izkušnje v trgovini kliknite Uredi pri Potrdila o nakupu.
Na strani Prilagoditev potrdil kliknite Urejevalnik kode.
Kliknite datoteko kode, ki si jo želite predogledati. Vaše potrdilo se prikaže v skrajno desnem oknu urejevalnika.
Izbirno: Če želite v oknu za predogled izbrati določeno naročilo, ki ga želite uporabiti kot vsebino potrdila, izvedite naslednja dejanja:
1. Kliknite ikono .
2. Prodaje, opravljene prek kanala Prodajno mesto na vseh lokacijah, se prikažejo v pogovornem oknu Izberite naročilo za predogled. Izberite naročilo s seznama ali pa z iskalno vrstico poiščite določena naročila in lokacije.
3. Kliknite Potrdi.
Izbirno: Če si ogledujete predogled datoteke gift-card.liquid, kliknite ikono in izberite lokacijo, za katero želite prikazati predogled predloge.