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).

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
  1. Shopify administrēšanas panelī dodies uz Pārdošanas kanāli > Point of Sale.

  2. Sadaļā Pielāgot pieredzi veikalā noklikšķini uz Rediģēt pie Kvītis.

  3. Noklikšķini uz Use code editor (Izmantot koda redaktoru).

No Point of Sale iestatījumiem
  1. Savā Shopify administrēšanas panelī dodies uz Point of Sale > Iestatījumi.

  2. Sadaļā Pielāgošana noklikšķini uz Drukātās kvītis.

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

  1. Savā Shopify administrēšanas panelī dodies uz Saturs > Faili.

  2. Blakus failam, kuru vēlies iekļaut drukātās kvīts kodā, noklikšķini uz Copy link, lai kopētu saiti.

  3. Dodies uz koda redaktoru.

  4. 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

Kvīts datu objektu apraksts
ObjektsApraksts
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

Pasūtījuma objekta apraksts
RekvizītsApraksts
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

Atgriešanas objekta apraksts
RekvizītsApraksts
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

Piegādes grupas objekta apraksts
RekvizītsApraksts
destination
Piegādājamo produktu galamērķis.
products
Piegādājamo produktu saraksts.

Rindas vienuma objekts

Rindas vienuma objekta apraksts
RekvizītsApraksts
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:

Rindas vienuma objekta apraksts
RekvizītsApraksts
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:

Kvīšu filtru apraksts
RekvizītsApraksts
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
  1. Shopify administrēšanas panelī dodies uz Pārdošanas kanāli > Point of Sale.

  2. Sadaļā Pielāgot pieredzi veikalā noklikšķini uz Rediģēt pie Kvītis.

  3. Noklikšķini uz Pielāgot savas kvītis.

  4. Noklikšķini uz Rediģēt kodu.

  5. Noklikšķini uz koda faila, kuru vēlies priekšskatīt. Tava kvīts tiks parādīta redaktora labējā logā.

  6. Neobligāti: lai priekšskatījuma logā kā savas kvīts saturu atlasītu konkrētu pasūtījumu, veic šādas darbības:

    1. Noklikšķini uz ikonas View.
    2. 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.
    3. Noklikšķini uz Apstiprināt.
  7. Neobligāti: ja priekšskati failu gift-card.liquid, noklikšķini uz ikonas View un atlasi to atrašanās vietu, kuras veidni vēlies priekšskatīt.

Lite / Itālijas / Francijas atrašanās vietām
  1. Shopify administrēšanas panelī dodies uz Pārdošanas kanāli > Point of Sale.

  2. Sadaļā Pielāgot pieredzi veikalā noklikšķini uz Rediģēt pie Kvītis.

  3. Lapā Kvīts pielāgošana noklikšķini uz Koda redaktors.

  4. Noklikšķini uz koda faila, kuru vēlies priekšskatīt. Tava kvīts tiks parādīta redaktora labējā logā.

  5. Neobligāti: lai priekšskatījuma logā kā savas kvīts saturu atlasītu konkrētu pasūtījumu, veic šādas darbības:

    1. Noklikšķini uz ikonas View.
    2. 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.
    3. Noklikšķini uz Apstiprināt.
  6. Neobligāti: ja priekšskati failu gift-card.liquid, noklikšķini uz ikonas View un atlasi to atrašanās vietu, kuras veidni vēlies priekšskatīt.