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

Ispisane račune možete prilagoditi pomoću uređivača koda u administratorskom alatu za Shopify. Datoteke od kojih se sastoje računi sadrže Liquid, jezik predloška platforme Shopify. Uređivač koda omogućuje naprednije prilagodbe pomoću HTML-a, CSS-a i Liquida nego vizualni uređivač.

Možete promijeniti predložak računa i predloške odjeljaka koji se upotrebljavaju na ispisanim računima. Datoteke predloška Računi vrste su računa koje možete ispisati u trgovini. Odjeljci su dijelovi računa, poput zaglavlja ili podnožja. Više računa može ponovno upotrijebiti odjeljke.

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 ni za jednu lokaciju POS-a u Italiji.

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.
Ispisane račune koji imaju predložak u uređivaču koda možete prilagoditi, poput računa za prodaju, računa za poklon, računa za poklon kartice te računa za povrat 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.
Za uređivanje predložaka u uređivaču koda računa, morate biti upoznati s HTML-om, CSS-om i Liquidom. Podrška za teme platforme Shopify može pomoći s manjim prilagodbama u opsegu Pravila za dizajn za Shopify.

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

Ako prilagodite račun u uređivaču koda za račune, vašem bi postojećem predlošku mogle nedostajati nove značajke, poput selling_plan_name. Da biste u predložak dodali najnovije dostupne značajke, trebate ponovno postaviti predložak računa na zadano. Ponovnim postavljanjem predložaka računa na zadano uklanjaju se sve prilagodbe koje ste na njima napravili. Zabilježite svoj prilagođeni kod prije ponovnog postavljanja. Nakon što ponovno postavite predložak, trebate ručno ponovno primijeniti svoje prilagodbe.

Pristup uređivaču koda

Možete urediti predloške pomoću uređivača koda. Prvo se morate sa zadanog vizualnog uređivača prebaciti na upotrebu uređivača koda, a u bilo kojem se trenutku možete vratiti na vizualni uređivač.

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

Iz administratorskog alata za Shopify otvorite Point of Sale > Postavke.
U odjeljku Prilagodba kliknite Ispisani računi da biste otvorili uređivač za POS.
Kliknite ikonu na lijevoj bočnoj traci.
Kliknite Uredi kod.
U dijaloškom okviru Uredi kod za ispisane račune uredite kod koji želite promijeniti.
Kliknite Spremi.
Neobavezno: Da biste nastavili uređivati više stranica za Shopify POS pomoću uređivača POS-a, vratite se unatrag u prozoru preglednika.

S lokacijama pretplate Lite ili lokacijama u Italiji

Iz administratorskog alata za Shopify otvorite Point of Sale > Postavke.
U odjeljku Prilagodba kliknite Ispisani računi da biste otvorili uređivač za POS.
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

Predložak računa možete ponovno postaviti na zadanu verziju pomoću uređivača koda.

Koraci:

Sve lokacije za POS Pro

Iz administratorskog alata za Shopify otvorite Point of Sale > Postavke.
U odjeljku Prilagodba kliknite Ispisani računi da biste otvorili uređivač za POS.
Kliknite Prilagodi svoje račune.
Kliknite Uredi kod.
Kliknite datoteku koda koju želite ponovno postaviti.
Kliknite ikonu .
U dijaloškom okviru Ponovno postavi datoteku na zadano kliknite Ponovno postavi.

S lokacijama pretplate Lite ili lokacijama u Italiji

Iz administratorskog alata za Shopify otvorite Point of Sale > Postavke.
U odjeljku Prilagodba kliknite Ispisani računi da biste otvorili uređivač za POS.
Na stranici Prilagodba računa kliknite Uređivač koda.
Kliknite datoteku koda koju želite ponovno postaviti.
Kliknite ikonu .
U dijaloškom okviru Ponovno postavi datoteku na zadano kliknite Ponovno postavi.

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

Možete koristiti Liquid za prilagodbu predloška ispisanog računa i vrsta 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 se prikazuje na stranici narudžbe u administratorskom alatu za Shopify i na stranici statusa narudžbe. Na primjer, „#1001”, „EN1001” ili „1001-A”. Ta vrijednost nije jedinstvena za 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 se prikazuje na stranici narudžbe u administratorskom alatu za Shopify i na stranici statusa narudžbe. Na primjer, „#1000-R1”. Ta vrijednost nije jedinstvena za 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

Pomoću filtara za Liquid možete prilagoditi informacije u predlošcima računa. Na primjer, možete promijeniti oblikovanje valute ili velika i mala slova specifičnog teksta, poput poreznog koda.

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

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

Iz administratorskog alata za Shopify otvorite Point of Sale > Postavke.
U odjeljku Prilagodba kliknite Ispisani računi da biste otvorili uređivač za POS.
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 pretplate Lite ili lokacijama u Italiji

Iz administratorskog alata za Shopify otvorite Point of Sale > Postavke.
U odjeljku Prilagodba kliknite Ispisani računi da biste otvorili uređivač za POS.
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.