Uređivač koda za ispisane račune za Shopify POS

Alat za uređivanje koda računa omogućuje vam da prilagodite svoje ispisane račune s pomoću HTML-a, CSS-a i jezika Liquid. Možete uređivati predloške računa, odnosno vrste računa koje možete ispisati u svojoj trgovini, te predloške odjeljaka, koji su višekratno upotrebljivi dijelovi računa, poput zaglavlja i podnožja.

Na ovoj stranici

Napomene o upotrebi uređivača koda računa

Prije nego što upotrijebite uređivač koda računa, pregledajte sljedeće napomene:

Ograničenja pristupa

Uređivač koda možete upotrebljavati samo iz administratorskog alata za Shopify na stolnom računalu.
Uređivač koda nije dostupan za lokacije POS-a u Italiji ili Francuskoj.
Alatu za uređivanje koda nije moguće dodati nove trgovine ili lokacije. Alat za uređivanje koda ostaje dostupan za trgovine s postojećim prilagodbama koje nisu migrirane.

Gdje se promjene primjenjuju

Promjene koda koje napravite primjenjuju se samo na odabranu lokaciju.
Prilagodbe u uređivaču koda primjenjuju se samo na lokacije za POS Pro. Ako upotrebljavate uređivač koda i imate lokacije koje nisu POS Pro, možete upotrijebiti vizualni uređivač za prilagodbu zaglavlja i podnožja za te lokacije.
Možete prilagoditi ispisane račune koji imaju predložak u alatu za uređivanje koda, kao što su računi za prodaju, računi za poklon, računi za poklon kartice te računi za povrate i zamjene.

Jezici koda

Datoteke od kojih se sastoje vaši računi sadrže Liquid, jezik predloška platforme Shopify. Saznajte više o upotrebi Liquida.
Da biste uredili predloške u uređivaču koda za račune, trebate poznavati HTML, CSS i Liquid. Podrška za teme platforme Shopify ne može u velikoj mjeri uređivati predloške računa umjesto vas, no možda vam može pomoći s manjim prilagodbama besplatnih tema za Shopify u okviru Pravila dizajna za Shopify. Za složenije promjene razmislite o tome da zaposlite partnera sa statusom Shopify Partner.

Ograničenja prilagodbe

U uređivaču koda ne možete pregledavati račune za različite veličine pisača. Za pregled prema veličini pisača upotrijebite vizualni uređivač.
Opisi proizvoda nisu dostupni kao varijabla u predlošcima računa i ne mogu se dodati na ispisane račune.

Održavanje predloška

Predlošci računa u alatu za uređivanje koda više ne primaju ažuriranja. Svojstva dodana nakon 1. lipnja 2026. dostupna su samo u vizualnom alatu za uređivanje.
Vraćanje predloška na zadane postavke više nije podržano. Da biste se vratili na zadani predložak, migrirajte na vizualni alat za uređivanje.

Pristup uređivaču koda

Koraci za prebacivanje između uređivača neznatno se razlikuju ovisno o tome ispunjavaju li sve lokacije POS-a uvjete za upotrebu uređivača koda ili samo neke, primjerice, ako na nekima od njih ne upotrebljavate pretplatu POS Pro ili se nalaze u Italiji ili Francuskoj.

Koraci:

Sve lokacije za POS Pro

U administratorskom alatu za Shopify idite na Prodajni kanali > Prodajno mjesto.
U odjeljku Prilagođavanje iskustva u trgovini kliknite na Uredi uz opciju Računi.
Kliknite ikonu na lijevoj bočnoj traci.
Kliknite Uredi kod.
U dijaloškom okviru Uređivanje koda za ispisane račune uredite kod koji želite promijeniti.
Kliknite Spremi.
Izborno: Da biste nastavili s uređivanjem više stranica u aplikaciji Shopify POS s pomoću POS alata za uređivanje, vratite se unatrag u prozoru preglednika.

S lokacijama na planu Lite/u Italiji/Francuskoj

U administratorskom alatu za Shopify idite na Prodajni kanali > Prodajno mjesto.
U odjeljku Prilagođavanje iskustva u trgovini kliknite na Uredi uz opciju Računi.
Na stranici Prilagodba računa kliknite Uređivač koda.

Upotreba prilagođenih datoteka u predlošku računa

Za prilagodbu ispisanih računa možete upotrijebiti datoteke, kao što su slikovni materijali, koje prenosite u administratorski alat za Shopify.

Prije nego što se datoteka može upotrijebiti na ispisanom računu, potrebno ju je prenijeti u administratorski alat za Shopify. Saznajte više o prijenosu datoteka.

Koraci:

Iz administratorskog alata za Shopify otvorite Sadržaj > Datoteke.
Pored datoteke koju želite uključiti u kod ispisanog računa kliknite da biste kopirali poveznicu.
Idite u uređivač koda.
Uključite poveznicu na resurs u svoj predložak.

Ponovno postavljanje predloška računa na zadano

Vraćanje predloška na zadane postavke nije podržano u alatu za uređivanje koda računa. Da biste se vratili na zadani predložak ispisanog računa, migrirajte u vizualni alat za uređivanje računa, koji pruža zadani predložak sa svim standardnim poljima.

Varijable Liquid dostupne u uređivaču koda računa

Sljedeće varijable Liquid navedene su kao referenca kako bi vam pomogle u razumijevanju postojećih prilagodbi računa tijekom migracije. Nove bi prilagodbe trebalo izraditi u vizualnom alatu za uređivanje računa.

Sljedeći podatkovni objekti dostupni su u uređivaču koda računa:

Objekti računa

Opis podatkovnih objekata računa
Objekt	Opis
shop	Sadrži podatke o trgovini, kao što je naziv trgovine.
location	Sadrži podatke o maloprodajnoj lokaciji, kao što su adresa i broj telefona.
order	Sadrži podatke o narudžbi, uključujući linije artikala, popuste, poreze i podatke o transakciji.
return	Dostupno samo unutar predloška `return-and-exchange-receipt.liquid` i s njim povezanih djelomičnih predložaka. Sadrži podatke o povratu i zamjeni, uključujući vraćene linije artikala, nove linije artikala, neto ukupan iznos i podatke o transakciji.
gift_card	Dostupno samo unutar predloška `gift-card.liquid`. Sadrži podatke o poklon kartici, uključujući saldo, alfanumerički kod i sadržaj QR koda koji se može skenirati pomoću POS aplikacije.

Objekt narudžbe

Opis objekta narudžbe
Svojstvo	Opis
id	ID narudžbe.
created_at	Datum i vrijeme u formatu ISO 8601 kada je narudžba izrađena.
source_identifier	Jedinstveni identifikator narudžbe POS-a ili treće strane.
change_due	Ostatak novca za povrat kupcu po narudžbi.
balance_due	Dugovani iznos za ovu narudžbu.
name	Jedinstveni identifikator narudžbe koji je prikazan na stranici narudžbe u administratorskom alatu za Shopify te na stranici statusa narudžbe. Na primjer, „#1001”, „EN1001” ili „1001-A”. Ta vrijednost nije jedinstvena u više trgovina.
note	Sadržaj bilješke povezane s narudžbom.
line_items	Popis linija artikala narudžbe.
subtotal_price	Zbroj cijena svih linija artikala nakon popusta i prije povrata. Ako je parametar `taxesIncluded` postavljen na true, tada međuzbroj uključuje i porez.
total_price	Ukupna cijena narudžbe prije povrata. To uključuje poreze i popuste.
total_tip_received	Zbroj svih iznosa napojnica za narudžbu.
discounts	Ukupan iznos popusta.
transactions	Popis transakcija povezanih s narudžbom.
taxes_included	Jesu li porezi uključeni u cijenu međuzbroja narudžbe.
tax_lines	Popis svih poreznih stavki primijenjenih na linije artikala u narudžbi, prije povrata. Cijene poreznih stavki predstavljaju ukupnu cijenu za sve porezne stavke s istom stopom i nazivom.
customer	Korisnik koji je napravio narudžbu.
shipping_address	Adresa za dostavu navedena u narudžbi.
shipping_groups	Popis grupa za dostavu narudžbe. Svaka grupa sadrži linije artikala koje se ispunjavaju zajedno.

Objekt povrata

Opis objekta povrata
Svojstvo	Opis
name	Jedinstveni identifikator povrata koji je prikazan na stranici narudžbe u administratorskom alatu za Shopify te na stranici statusa narudžbe. Na primjer, „#1000-R1”. Ta vrijednost nije jedinstvena u više trgovina.
created_at	Datum i vrijeme u formatu ISO 8601 kada je povrat izrađen.
is_unverified	Booleova vrijednost koja pokazuje je li povrat izrađen kao Nepotvrđeni povrat.
is_exchange	Booleova vrijednost koja pokazuje uključuje li povrat i zamjenu. To uključuje povrate novca izvršene na poklon karticu.
exchange_type	Vrsta zamjene, ako povrat uključuje zamjenu. Moguće vrijednosti su `LIKE_FOR_LIKE`, `NET_REFUNDABLE` i `NET_PAYABLE`.
return_discount	Ukupan iznos popusta na narudžbu za koje je izvršen povrat novca.
return_subtotal	Zbroj cijena svih vraćenih linija artikala prije popusta. Ako je parametar `taxesIncluded` postavljen na true, tada međuzbroj uključuje i porez.
return_total	Ukupan mogući iznos povrata novca. To uključuje poreze, popuste, dostavu i napojnice. To ne mora biti stvarni iznos vraćenog novca.
exchange_subtotal	Zbroj cijena svih novih linija artikala u zamjeni prije popusta. Ako je parametar `taxesIncluded` postavljen na true, tada međuzbroj uključuje i porez.
exchange_total	Ukupan iznos za sve nove linije artikala u zamjeni. To uključuje poreze i popuste.
total_cash_rounding_adjustment	Prilagodba na temelju zaokruživanja gotovine primijenjena na povrat ili zamjenu.
total_adjusted_amount	Ukupan iznos za povrat ili zamjenu izmijenjen prilagodbom na temelju zaokruživanja gotovine.
net_total	Stvarni ukupan iznos plaćen ili vraćen za povrat ili zamjenu prije zaokruživanja gotovine.
return_line_items	Vraćene linije artikala.
exchange_line_items	Nove linije artikala u zamjeni.
return_tax_lines	Porezne stavke za vraćene linije artikala.
exchange_tax_lines	Porezne stavke za nove linije artikala u zamjeni.
shipping_refund_amount	Iznos dostave za koji je izvršen povrat novca.
tip_refund_amount	Iznos napojnice za koji je izvršen povrat novca.
transactions	Transakcije povezane s povratom ili zamjenom.

Objekt grupe dostave

Opis objekta grupe dostave
Svojstvo	Opis
destination	Odredište proizvoda koji se dostavljaju.
products	Popis proizvoda koji se dostavljaju.

Objekt linije artikla

Opis objekta linije artikla
Svojstvo	Opis
id	ID linije artikla.
name	Naziv proizvoda kojemu je opcionalno dodan naziv varijante (ako je primjenjivo).
variant_title	Naziv varijante u trenutku kreiranja narudžbe.
price	Jedinična cijena linije artikla u trenutku kreiranja narudžbe. Ta vrijednost ne uključuje popuste.
is_gift_card	Prikazuje predstavlja li linija artikla kupnju poklon kartice.
discount	Ukupan popust koji je primjenom popusta dodijeljen liniji artikla, uključujući popuste dodijeljene vraćenim i uklonjenim količinama.
total_price	Ukupni iznos za tu liniju artikla.
selling_plan_name	Naziv plana pretplate dodijeljenog liniji artikla.
tax_rates	Porezne linije za ovu liniju artikla.
custom_attributes	Popis atributa koji predstavljaju prilagođene značajke ili posebne zahtjeve.
variant_title	Naziv varijante.
variant_id	ID varijante.
variant_metafields	Popis prilagođenih polja koja je trgovac povezao s varijantom.
staff_member_description	Član osoblja dodijeljen liniji artikla.
product_metafields	Popis prilagođenih polja koja je trgovac povezao s proizvodom.

Objekt linije artikla povrata

Uključuje sve što se nalazi u objektu linije artikla, kao i sljedeća svojstva:

Opis objekta linije artikla
Svojstvo	Opis
return_reason	Razlog povrata za liniju artikla.
return_reason_note	Opcionalna napomena uz razlog povrata.

Filtri za Liquid dostupni u alatu za uređivanje koda računa

Filterima Liquid možete se poslužiti za unošenje prilagodbi u informacije na svojim predlošcima računa. Na primjer, možete promijeniti oblikovanje valute ili pisanje velikih i malih slova određenog teksta, kao što je porezni kod.

Za primjenu filtra, dodajte znak okomite crte |, a zatim filtar unutar bloka koda za Liquid između dvostrukih vitičastih zagrada {{ }}. Filtri se mogu primijeniti samo na blokove koda za Liquid.

U sljedećem primjeru filtar mijenja porezni kod iz malih u velika slova.

{{ tax_line.title | upcase }}

U bloku koda primjera product je objekt, title je njegovo svojstvo, a upcase primijenjeni filtar. Filtar upcase mijenja vrijednost koda tax_line.title u velika slova. Na primjer, ako je vrijednost koda tax_line.title Hst, filtar upcase će promijeniti tu vrijednost u HST.

Više detalja o upotrebi filtara za Liquid potražite u odjeljku Filtri u priručniku Shopify Themes Liquid.

Sljedeći su filtri dostupni u alatu za uređivanje koda računa:

Opis filtara na računima
Svojstvo	Opis
t	Prevodi unaprijed definirane oznake na jezik dodijeljen vašoj lokaciji.
money	Formatira cijenu u valuti vaše lokacije.
escape	Izostavlja posebne znakove u HTML-u, kao što su `<>`, `'` i `&` te pretvara znakove u izlazne (escape) sekvence.
barcode	Generira 1D crtični kod u SVG formatu.
qrcode	Generira 2D crtični kod u SVG formatu.

Primjer prilagodbe koda za predložak ispisanog računa

Liquid možete upotrebljavati za dodavanje uvjetnih poruka. Ova je funkcionalnost slična spremanju na jednoj lokaciji pomoću vizualnog uređivača. Na primjer, ako ste poslovanje započeli s jednom lokacijom, a sada imate nekoliko novih lokacija. Možda ćete htjeti istaknuti svoju originalnu trgovinu na ispisanim računima.

Prilagođenu poruku možete dodati u predložak header.liquid u mapi Odjeljci (Sections) u alatu za uređivanje koda i upotrijebiti Liquid za prikaz poruke samo za vašu glavnu lokaciju.

Sljedeći kod provjerava naziv lokacije, u ovom slučaju vašu originalnu lokaciju pod nazivom „Home” (Početna) te prikazuje poruku „Welcome to our original store, opened in 1972.” (Dobro došli u našu originalnu trgovinu, otvorenu 1972.) ako lokacija odgovara nazivu. Računi ispisani na drugim lokacijama umjesto toga prikazuju poruku „Welcome to our store.” (Dobro došli u našu trgovinu).

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

Pregledajte izmjene koda u alatu za uređivanje koda

Izmjene svojih ispisanih računa možete pregledati u alatu za uređivanje POS koda u administratorskom alatu za Shopify.

Ovisno o tome koja je datoteka Liquid odabrana, prozor za pregled ističe dizajn ili odjeljak računa na koji datoteka utječe. Prema zadanim postavkama, u prozoru za pregled prikazuje se sadržaj za vašu najnoviju POS narudžbu. Možete odabrati specifičnu narudžbu koja će se upotrebljavati kao sadržaj računa u prozoru za pregled za sve Liquid datoteke, osim za datoteku gift-card.liquid, koja kao mogućnosti pregleda za odabir prikazuje samo različite lokacije.

Koraci:

Sve lokacije za POS Pro

U administratorskom alatu za Shopify idite na Prodajni kanali > Prodajno mjesto.
U odjeljku Prilagođavanje iskustva u trgovini kliknite na Uredi uz opciju Računi.
Kliknite Prilagodi svoje račune.
Kliknite Uredi kod.
Kliknite datoteku koda koju želite pregledati. Vaš se račun prikazuje u krajnjem desnom prozoru uređivača.
Opcionalno: Da biste odabrali određenu narudžbu koja će se upotrebljavati kao sadržaj računa u prozoru za pregled, učinite sljedeće:
1. Kliknite ikonu .
2. Prodaje ostvarene putem kanala Prodajno mjesto za sve lokacije prikazuju se u dijaloškom okviru Odaberite narudžbu za pregled (Choose order to preview). Odaberite narudžbu na popisu ili potražite specifične narudžbe i lokacije pomoću trake za pretraživanje.
3. Kliknite Potvrdi.
Opcionalno: Ako pregledavate datoteku gift-card.liquid, kliknite ikonu i odaberite lokaciju za koju želite pregledati predložak.

S lokacijama na planu Lite/u Italiji/Francuskoj

U administratorskom alatu za Shopify idite na Prodajni kanali > Prodajno mjesto.
U odjeljku Prilagođavanje iskustva u trgovini kliknite na Uredi uz opciju Računi.
Na stranici Prilagodba računa kliknite Uređivač koda.
Kliknite datoteku koda koju želite pregledati. Vaš se račun prikazuje u krajnjem desnom prozoru uređivača.
Opcionalno: Da biste odabrali određenu narudžbu koja će se upotrebljavati kao sadržaj računa u prozoru za pregled, učinite sljedeće:
1. Kliknite ikonu .
2. Prodaje ostvarene putem kanala Prodajno mjesto za sve lokacije prikazuju se u dijaloškom okviru Odaberite narudžbu za pregled (Choose order to preview). Odaberite narudžbu na popisu ili potražite specifične narudžbe i lokacije pomoću trake za pretraživanje.
3. Kliknite Potvrdi.
Opcionalno: Ako pregledavate datoteku gift-card.liquid, kliknite ikonu i odaberite lokaciju za koju želite pregledati predložak.