Izdrukāto kvīšu koda redaktors tavai Shopify POS lietotnei
Kvīšu koda redaktors ļauj pielāgot izdrukātās kvītis, izmantojot HTML, CSS un Liquid. Tu vari rediģēt kvīšu veidnes (kvīšu veidi, ko vari izdrukāt savā veikalā) un sadaļu veidnes (atkārtoti izmantojamas kvīšu daļas, piemēram, galveni un kājeni).
Šajā lapā
- Apsvērumi kvīšu koda redaktora izmantošanai
- Piekļuve koda redaktoram
- Pielāgotu failu izmantošana kvīts veidnē
- Kvīts veidnes atiestatīšana uz noklusējumu
- Kvīšu koda redaktorā pieejamie Liquid mainīgie
- Kvīšu koda redaktorā pieejamie Liquid filtri
- Izdrukātās kvīts veidnes koda pielāgošanas piemērs
- Koda izmaiņu priekšskatīšana koda redaktorā
Apsvērumi kvīšu koda redaktora izmantošanai
Pirms sāc izmantot kvīšu koda redaktoru, ņem vērā šādus apsvērumus:
Piekļuves ierobežojumi
- Koda redaktoru vari izmantot tikai Shopify administrēšanas panelī darbvirsmā.
- Koda redaktors nav pieejams nevienai POS atrašanās vietai Itālijā un Francijā.
- Koda redaktoram nevar pievienot jaunus veikalus vai atrašanās vietas. Koda redaktors paliek pieejams veikaliem ar esošiem pielāgojumiem, kas vēl nav migrēti.
Kur tiek piemērotas izmaiņas
- Tevis veiktās koda izmaiņas tiek piemērotas tikai atlasītajai atrašanās vietai.
- Pielāgojumi koda redaktorā tiek piemēroti tikai POS Pro atrašanās vietām. Ja izmanto koda redaktoru un tev ir atrašanās vietas bez POS Pro, tad šīm atrašanās vietām vari izmantot vizuālo redaktoru, lai pielāgotu galveni un kājeni.
- Koda redaktorā vari pielāgot izdrukātās kvītis, kurām ir veidne, piemēram, pirkuma kvītis, dāvanas kvītis, dāvanu karšu kvītis, kā arī atgriešanas un apmaiņas kvītis.
Koda valodas
- Faili, kas veido tavas kvītis, ietver Liquid — Shopify veidņu valodu. Uzzini vairāk par Liquid izmantošanu.
- Lai rediģētu veidnes kvīšu koda redaktorā, tev jāpārzina HTML, CSS un Liquid. Shopify tēmu atbalsts nevar tavā vietā veikt apjomīgu kvīšu veidņu rediģēšanu, bet, iespējams, varēs palīdzēt ar nelieliem pielāgojumiem bezmaksas Shopify tēmām Shopify dizaina politikas ietvaros. Sarežģītākām izmaiņām apsver iespēju nolīgt Shopify partneri.
Pielāgošanas ierobežojumi
- Koda redaktorā nevari priekšskatīt kvītis dažādos printera izmēros. Lai veiktu priekšskatījumu pēc printera izmēra, izmanto vizuālo redaktoru.
- Produktu apraksti kvīšu veidnēs nav pieejami kā Liquid mainīgais, un tos nevar pievienot izdrukātajām kvītīm.
Veidņu uzturēšana
- Kvīšu veidnes koda redaktorā vairs nesaņem atjauninājumus. Rekvizīti, kas pievienoti pēc 01.06.2026., ir pieejami tikai vizuālajā redaktorā.
- Veidnes atiestatīšana uz noklusējumu vairs netiek atbalstīta. Lai atgrieztos pie noklusējuma veidnes, migrē uz vizuālo redaktoru.
Piekļuve koda redaktoram
Koda redaktoru vari atvērt no kvīšu vizuālā redaktora vai no saviem Point of Sale iestatījumiem. Saite Use code editor (Izmantot koda redaktoru) kvīšu vizuālajā redaktorā ir pieejama tikai tad, ja koda redaktors ir pieejams visām tavām POS atrašanās vietām. Ja kādā no POS atrašanās vietām nav POS Pro abonementa vai tā atrodas Itālijā vai Francijā, atver koda redaktoru no saviem Point of Sale iestatījumiem.
Darbības:
No kvīšu vizuālā redaktora
Shopify administrēšanas panelī dodies uz Pārdošanas kanāli > Point of Sale.
Sadaļā Pielāgot pieredzi veikalā noklikšķini uz Rediģēt pie Kvītis.
Noklikšķini uz Use code editor (Izmantot koda redaktoru).
No Point of Sale iestatījumiem
Savā Shopify administrēšanas panelī dodies uz Point of Sale > Iestatījumi.
Sadaļā Pielāgošana noklikšķini uz Drukātās kvītis.
Sadaļā Izkārtojuma pielāgošana noklikšķini uz Koda redaktors.
Izmanto pielāgotus failus savā kvīts veidnē
Tu vari izmantot failus, piemēram, attēlu līdzekļus, ko augšupielādē savā Shopify administrēšanas panelī, lai pielāgotu drukātās kvītis.
Pirms failu var izmantot drukātajā kvītī, tas ir jāaugšupielādē tavā Shopify administrēšanas panelī. Uzzināt vairāk par failu augšupielādi.
Darbības:
Savā Shopify administrēšanas panelī dodies uz Saturs > Faili.
Blakus failam, kuru vēlies iekļaut drukātās kvīts kodā, noklikšķini uz
, lai kopētu saiti.
Iekļauj līdzekļa saiti savā veidnē.
Atiestati kvīts veidni uz noklusējuma
Veidnes atiestatīšana uz noklusējuma netiek atbalstīta kvīts koda redaktorā. Lai atgrieztos pie noklusējuma drukātās kvīts veidnes, migrē uz kvīts vizuālo redaktoru, kas nodrošina noklusējuma veidni ar visiem standarta laukiem.
Kvīts koda redaktorā pieejamie Liquid mainīgie
Tālāk norādītie Liquid mainīgie ir sniegti uzziņai, lai palīdzētu tev saprast esošos kvīts pielāgojumus migrācijas laikā. Jauni pielāgojumi ir jāveido kvīts vizuālajā redaktorā.
Kvīts koda redaktoram ir pieejami šādi datu objekti:
Kvīts objekti
| Objekts | Apraksts |
|---|---|
shop | Satur veikala informāciju, piemēram, veikala nosaukumu. |
location | Satur mazumtirdzniecības vietas informāciju, piemēram, adresi un tālruņa numuru. |
order | Satur pasūtījuma datus, tostarp rindas vienumus, atlaides, nodokļus un informāciju par darījumu. |
return |
Pieejams tikai veidnē return-and-exchange-receipt.liquid un ar to saistītajās daļējās veidnēs.
Satur atgriešanas un apmaiņas datus, tostarp atgrieztos rindas vienumus, jaunos rindas vienumus, neto kopsummu un informāciju par darījumu.
|
gift_card |
Pieejams tikai veidnē gift-card.liquid.
Satur dāvanu kartes datus, tostarp atlikumu, burtciparu kodu un kvadrātkoda saturu, ko var skenēt ar POS lietotni.
|
Pasūtījuma objekts
| Rekvizīts | Apraksts |
|---|---|
id | Pasūtījuma ID. |
created_at | ISO 8601 formātā norādīts datums un laiks, kad pasūtījums tika izveidots. |
source_identifier | Unikāls POS vai trešās puses pasūtījuma identifikators. |
change_due | Izsniedzamais atlikums par pasūtījumu. |
balance_due | Par šo pasūtījumu maksājamā summa. |
name | Unikāls pasūtījuma identifikators, kas tiek rādīts Shopify administrēšanas paneļa pasūtījumu lapā un pasūtījuma statusa lapā. Piemēram, "#1001", "EN1001" vai "1001-A". Šī vērtība nav unikāla vairākiem veikaliem. |
note | Ar pasūtījumu saistītās piezīmes saturs. |
line_items | Pasūtījuma rindas vienumu saraksts. |
subtotal_price |
Visu rindas vienumu cenu summa pēc atlaidēm un pirms atgriešanām. Ja taxesIncluded ir patiesa, tad starpsumma ietver arī nodokli.
|
total_price | Pasūtījuma kopējā cena pirms atgriešanām. Tā ietver nodokļus un atlaides. |
total_tip_received | Visu pasūtījuma dzeramnaudas summu kopsumma. |
discounts | Kopējā atlaižu summa. |
transactions | Ar pasūtījumu saistīto darījumu saraksts. |
taxes_included | Norāda, vai nodokļi ir iekļauti pasūtījuma starpsummas cenā. |
tax_lines | Saraksts ar visām nodokļu rindām, kas piemērotas pasūtījuma rindas vienumiem pirms atgriešanām. Nodokļu rindu cenas atspoguļo visu to nodokļu rindu kopējo cenu, kurām ir viena un tā pati likme un nosaukums. |
customer | Klients, kurš veica pasūtījumu. |
shipping_address | Pasūtījuma piegādes adrese. |
shipping_groups | Pasūtījuma piegādes grupu saraksts. Katra grupa satur rindas vienumus, kas tiek izpildīti kopā. |
Atgriešanas objekts
| Rekvizīts | Apraksts |
|---|---|
name | Unikāls atgriešanas identifikators, kas tiek rādīts Shopify administrēšanas paneļa pasūtījumu lapā un pasūtījuma statusa lapā. Piemēram, "#1000-R1". Šī vērtība nav unikāla vairākiem veikaliem. |
created_at | ISO 8601 formātā norādīts datums un laiks, kad atgriešana tika izveidota. |
is_unverified | Būla vērtība, kas norāda, vai atgriešana tika izveidota kā Nepārbaudīta atgriešana. |
is_exchange | Būla vērtība, kas norāda, vai atgriešana ietver apmaiņu. Tas ietver arī atmaksājumus, kas veikti dāvanu kartē. |
exchange_type |
Apmaiņas veids, ja atgriešana ietver apmaiņu. Iespējamās vērtības ir LIKE_FOR_LIKE, NET_REFUNDABLE un NET_PAYABLE.
|
return_discount | Kopējā pasūtījuma atlaižu summa, kas ir atmaksāta. |
return_subtotal |
Visu atgriešanas rindas vienumu cenu summa pirms atlaidēm. Ja taxesIncluded ir patiesa, tad starpsumma ietver arī nodokli.
|
return_total | Kopējā iespējamā atmaksājuma summa. Tā ietver nodokļus, atlaides, piegādes maksu un dzeramnaudas. Tā var nebūt faktiskā atmaksātā summa. |
exchange_subtotal |
Visu apmaiņā iekļauto jauno rindas vienumu cenu summa pirms atlaidēm. Ja taxesIncluded ir patiesa, tad starpsumma ietver arī nodokli.
|
exchange_total | Kopējā summa par visiem jaunajiem rindas vienumiem apmaiņā. Tā ietver nodokļus un atlaides. |
total_cash_rounding_adjustment | Skaidras naudas noapaļošanas korekcija, kas piemērota atgriešanai vai apmaiņai. |
total_adjusted_amount | Kopējā summa atgriešanai vai apmaiņai, kas koriģēta ar skaidras naudas noapaļošanas korekciju. |
net_total | Faktiskā kopējā summa, kas samaksāta vai atmaksāta par atgriešanu vai apmaiņu, pirms skaidras naudas noapaļošanas. |
return_line_items | Atgrieztie rindas vienumi. |
exchange_line_items | Jaunie rindas vienumi apmaiņā. |
return_tax_lines | Nodokļu rindas atgrieztajiem rindas vienumiem. |
exchange_tax_lines | Nodokļu rindas apmaiņas jaunajiem rindas vienumiem. |
shipping_refund_amount | Atmaksātā piegādes summa. |
tip_refund_amount | Atmaksātā dzeramnaudas summa. |
transactions | Darījumi, kas saistīti ar atgriešanu vai apmaiņu. |
Piegādes grupas objekts
| Rekvizīts | Apraksts |
|---|---|
destination | Piegādājamo produktu galamērķis. |
products | Piegādājamo produktu saraksts. |
Rindas vienuma objekts
| Rekvizīts | Apraksts |
|---|---|
id | Rindas vienuma ID. |
name | Produkta nosaukums, kam pēc izvēles pievienots varianta nosaukums (ja piemērojams). |
variant_title | Varianta nosaukums pasūtījuma izveides brīdī. |
price | Rindas vienuma vienības cena pasūtījuma izveides brīdī. Šajā vērtībā nav iekļautas atlaides. |
is_gift_card | Norāda, vai rindas vienums ir dāvanu kartes pirkums. |
discount | Kopējā atlaide, kas piešķirta rindas vienumam, piemērojot atlaidi (tostarp atlaides, kas piešķirtas atmaksātajiem un noņemtajiem daudzumiem). |
total_price | Šī rindas vienuma kopsumma. |
selling_plan_name | Rindas vienumam piešķirtā abonēšanas plāna nosaukums. |
tax_rates | Šī rindas vienuma nodokļu rindas. |
custom_attributes | Atribūtu saraksts, kas atspoguļo pielāgotas funkcijas vai īpašus pieprasījumus. |
variant_title | Varianta nosaukums. |
variant_id | Varianta ID. |
variant_metafields | Pielāgoto lauku saraksts, ko tirgotājs piesaistījis variantam. |
staff_member_description | Rindas vienumam piesaistītais darbinieks. |
product_metafields | Pielāgoto lauku saraksts, ko tirgotājs piesaistījis produktam. |
Atgriešanas rindas vienuma objekts
Ietver visu no rindas vienuma objekta un šādus rekvizītus:
| Rekvizīts | Apraksts |
|---|---|
return_reason | Rindas vienuma atgriešanas iemesls. |
return_reason_note | Neobligāta piezīme, ko pievienot atgriešanas iemeslam. |
Kvīšu koda redaktorā pieejamie Liquid filtri
Tu vari izmantot Liquid filtrus, lai pielāgotu informāciju savās kvīšu veidnēs. Piemēram, tu vari mainīt valūtas formatējumu vai konkrēta teksta, piemēram, nodokļa koda, reģistru.
Lai lietotu filtru, pievieno vertikālās svītras rakstzīmi | un pēc tam pašu filtru Liquid koda blokā starp dubultajām figūriekavām {{ }}. Filtrus var lietot tikai Liquid koda blokiem.
Tālāk sniegtajā piemērā filtrs pielāgo nodokļa kodu, mainot to no mazajiem burtiem uz lielajiem.
{{ tax_line.title | upcase }}Koda bloka piemērā product ir objekts, title ir tā rekvizīts, un upcase ir lietotais filtrs. Filtrs upcase maina vērtības tax_line.title burtu reģistru uz lielajiem burtiem. Piemēram, ja vērtība tax_line.title ir Hst, tad filtrs upcase nomaina tās vērtību uz HST.
Detalizētāku informāciju par Liquid filtru izmantošanu skati Shopify tēmu Liquid uzziņu materiāla sadaļā Filtri.
Kvīšu koda redaktorā ir pieejami šādi filtri:
| Rekvizīts | Apraksts | |
|---|---|---|
t | Pārtulko iepriekš definētas etiķetes valodā, kas piešķirta tavai atrašanās vietai. | |
money | Formatē cenu tavas atrašanās vietas valūtā. | |
escape |
Pārveido tādas HTML īpašās rakstzīmes kā <>, ' un & par atsoļu secībām.
| |
barcode | Izveido 1D svītrkoda SVG. | |
qrcode | Izveido 2D svītrkoda SVG. |
Drukātas kvīts veidnes koda pielāgošanas piemērs
Tu vari izmantot Liquid, lai pievienotu nosacījumu ziņojumus. Šī funkcionalitāte ir līdzīga saglabāšanai vienā atrašanās vietā, izmantojot vizuālo redaktoru. Piemēram, tavs uzņēmums sāka darbu ar vienu atrašanās vietu, un tagad tev ir vairākas jaunas atrašanās vietas. Tu vēlies izcelt savu sākotnējo veikalu drukātajās kvītīs.
Tu vari pievienot pielāgotu ziņojumu header.liquid veidnei koda redaktora mapē Sections un izmantot Liquid, lai parādītu ziņojumu tikai tavai galvenajai atrašanās vietai.
Tālāk norādītais kods pārbauda atrašanās vietas nosaukumu (šajā gadījumā tavas sākotnējās atrašanās vietas nosaukumu “Sākums”), un, ja nosaukumi sakrīt, parāda ziņojumu “Welcome to our original store, opened in 1972.”. Tā vietā kvītīs, kas drukātas no tavām citām atrašanās vietām, tiks rādīts ziņojums “Welcome to our store.”.
{% if location.name == 'Home' %}
Welcome to our original store, opened in 1972.
{% else %}
Welcome to our store.
{% endif %}Priekšskati savas koda izmaiņas koda redaktorā
Tu vari priekšskatīt drukāto kvīšu izmaiņas Shopify administrēšanas paneļa POS koda redaktorā.
Atkarībā no atlasītā Liquid faila priekšskatījuma logā tiek izcelts kvīts noformējums vai sadaļa, ko ietekmē šis fails. Pēc noklusējuma priekšskatījuma logā tiek rādīts tava pēdējā POS pasūtījuma saturs. Visiem Liquid failiem, izņemot failu gift-card.liquid, vari atlasīt konkrētu pasūtījumu, kura saturu izmantot kvīts priekšskatījumā. Failam gift-card.liquid kā atlasāmas priekšskatījuma iespējas tiek rādītas tikai dažādas atrašanās vietas.
Darbības:
Visas POS Pro atrašanās vietas
Shopify administrēšanas panelī dodies uz Pārdošanas kanāli > Point of Sale.
Sadaļā Pielāgot pieredzi veikalā noklikšķini uz Rediģēt pie Kvītis.
Noklikšķini uz Pielāgot savas kvītis.
Noklikšķini uz Rediģēt kodu.
Noklikšķini uz koda faila, kuru vēlies priekšskatīt. Tava kvīts tiks parādīta redaktora labējā logā.
Neobligāti: lai priekšskatījuma logā kā savas kvīts saturu atlasītu konkrētu pasūtījumu, veic šādas darbības:
- Noklikšķini uz ikonas
.
- Pārdošanas darījumi, kas veikti Point of Sale kanālā visās atrašanās vietās, tiek rādīti dialoglodziņā Izvēlēties pasūtījumu priekšskatīšanai. Izvēlies pasūtījumu no saraksta vai izmanto meklēšanas joslu, lai atrastu konkrētus pasūtījumus un atrašanās vietas.
- Noklikšķini uz Apstiprināt.
- Noklikšķini uz ikonas
Neobligāti: ja priekšskati failu
gift-card.liquid, noklikšķini uz ikonasun atlasi to atrašanās vietu, kuras veidni vēlies priekšskatīt.
Lite / Itālijas / Francijas atrašanās vietām
Shopify administrēšanas panelī dodies uz Pārdošanas kanāli > Point of Sale.
Sadaļā Pielāgot pieredzi veikalā noklikšķini uz Rediģēt pie Kvītis.
Lapā Kvīts pielāgošana noklikšķini uz Koda redaktors.
Noklikšķini uz koda faila, kuru vēlies priekšskatīt. Tava kvīts tiks parādīta redaktora labējā logā.
Neobligāti: lai priekšskatījuma logā kā savas kvīts saturu atlasītu konkrētu pasūtījumu, veic šādas darbības:
- Noklikšķini uz ikonas
.
- Pārdošanas darījumi, kas veikti Point of Sale kanālā visās atrašanās vietās, tiek rādīti dialoglodziņā Izvēlēties pasūtījumu priekšskatīšanai. Izvēlies pasūtījumu no saraksta vai izmanto meklēšanas joslu, lai atrastu konkrētus pasūtījumus un atrašanās vietas.
- Noklikšķini uz Apstiprināt.
- Noklikšķini uz ikonas
Neobligāti: ja priekšskati failu
gift-card.liquid, noklikšķini uz ikonasun atlasi to atrašanās vietu, kuras veidni vēlies priekšskatīt.