„Shopify POS“ spausdintų kvitų kodo rengyklė

Kvitų kodo redaktorius leidžia Jums pritaikyti spausdintus kvitus naudojant HTML, CSS ir Liquid. Galite redaguoti kvitų šablonus, kurie yra kvitų, kuriuos galite atspausdinti savo parduotuvėje, tipai, ir skilčių šablonus, kurie yra pakartotinai naudojamos kvitų dalys, pvz., antraštė ir poraštė.

Šiame puslapyje

Kvitų kodo rengyklės naudojimo aspektai

Prieš pradėdami naudoti kvitų kodo rengyklę, peržiūrėkite šiuos svarbius aspektus:

Prieigos apribojimai

Kodo rengyklę galite naudoti tik savo „Shopify“ administratoriaus skydelyje staliniame kompiuteryje.
Kodo redaktorius nepasiekiamas jokioms POS pardavimo vietoms Italijoje ar Prancūzijoje.
Į kodo redaktorių negalima pridėti jokių naujų parduotuvių ar vietų. Kodo redaktorius lieka prieinamas parduotuvėms su esamais pritaikymais, kurie nebuvo migruoti.

Kur taikomi pakeitimai

Kodo pakeitimai, kuriuos atliekate, taikomi tik pasirinktai vietai.
Kodo rengyklės pritaikymai taikomi tik POS Pro vietoms. Jei naudojate kodo rengyklę ir turite vietų, kuriose nenaudojama POS Pro, tuomet toms vietoms galite naudoti vizualinę rengyklę antraštei ir poraštrei tinkinti.
Kodo redaktoriuje galite pritaikyti spausdintus kvitus, turinčius šabloną, pvz., pardavimų kvitus, dovanų kvitus, dovanų kortelių kvitus ir grąžinimo bei keitimo kvitus.

Kodo kalbos

Failuose, iš kurių sudaromi Jūsų kvitai, yra „Liquid“ – „Shopify“ šablonų kalba. Sužinokite daugiau apie tai, kaip naudoti „Liquid“.
Norint redaguoti šablonus kvitų kodo redaktoriuje, reikia išmanyti HTML, CSS ir „Liquid“. „Shopify“ temų pagalbos tarnyba negali jūsų prašymu atlikti didelių kvitų šablonų pakeitimų, bet gali padėti atlikti nedidelius nemokamų „Shopify“ temų pakeitimus, neperžengiant „Shopify“ dizaino politikos ribų. Jei reikia sudėtingesnių pakeitimų, apsvarstykite galimybę įdarbinti „Shopify“ partnerį.

Pritaikymo apribojimai

Iš kodo redagavimo priemonės negalite peržiūrėti kvitų skirtingiems spausdintuvų dydžiams. Norėdami peržiūrėti pagal spausdintuvo dydį, naudokite vaizdo redagavimo priemonę.
Gaminių aprašai nėra pasiekiami kaip kintamieji kvitų šablonuose, todėl jų negalima pridėti prie atspausdintų kvitų.

Šablonų priežiūra

Kvitų šablonai kodo redaktoriuje nebegauna atnaujinimų. Ypatybės, pridėtos po 2026 m. birželio 1 d., prieinamos tik vizualiniame redaktoriuje.
Šablono atstatymas į numatytąjį nebepalaikomas. Norėdami grįžti prie numatytojo šablono, migruokite į vizualinį redaktorių.

Kodo redaktoriaus pasiekimas

Veiksmai perjungiant redaktorius šiek tiek skiriasi, priklausomai nuo to, ar visose Jūsų pardavimo vietose galimas kodo redaktorius, ar tik kai kuriose Jūsų pardavimo vietose, pavyzdžiui, jei tam tikrose pardavimo vietose nenaudojamas „POS Pro“ arba jos yra Italijoje ar Prancūzijoje.

Veiksmai:

Visos `POS Pro` vietos

Iš savo „Shopify“ administratoriaus eikite į Pardavimo kanalai > Point of Sale.
Skiltyje Tinkinti patirtį parduotuvėje prie Kvitai spustelėkite Redaguoti.
Kairiojoje šoninėje juostoje spustelėkite piktogramą .
Spustelėkite Redaguoti kodą.
Dialogo lange Redaguoti spausdintų kvitų kodą redaguokite kodą, kurį norite pakeisti.
Spustelėkite Išsaugoti.
Neprivaloma: norėdami toliau redaguoti daugiau „Shopify POS“ puslapių naudodami POS redaktorių, grįžkite atgal savo naršyklės lange.

Su „Lite“ / Italijos / Prancūzijos vietomis

Iš savo „Shopify“ administratoriaus eikite į Pardavimo kanalai > Point of Sale.
Skiltyje Tinkinti patirtį parduotuvėje prie Kvitai spustelėkite Redaguoti.
Puslapyje Kvitų pritaikymas spustelėkite Kodo redaktorius.

Pasirinktinių failų naudojimas kvito šablone

Galite naudoti failus, pavyzdžiui, vaizdų išteklius, kuriuos įkeliate į „Shopify“ administratoriaus skydelį, kad pritaikytumėte spausdinamus kvitus.

Kad failą būtų galima naudoti spausdinamame kvite, jis turi būti įkeltas į Jūsų „Shopify“ administratoriaus skydelį. Sužinokite daugiau apie failų įkėlimą.

Veiksmai:

Savo „Shopify“ administratoriaus skydelyje eikite į Turinys > Failai.
Prie failo, kurį norite įtraukti į spausdinamo kvito kodą, spustelėkite piktogramą , kad nukopijuotumėte nuorodą.
Pereikite į kodo rengyklę.
Įtraukite ištekliaus nuorodą į savo šabloną.

Kvito šablono atstatymas į numatytąjį

Šablono atstatymas į numatytąjį nepalaikomas kvito kodo redaktoriuje. Norėdami grįžti prie numatytojo spausdinto kvito šablono, migruokite į vizualinį kvito redaktorių, kuris pateikia numatytąjį šabloną su visais standartiniais laukeliais.

„Liquid“ kintamieji, pasiekiami kvitų kodo redaktoriuje

Šie „Liquid“ kintamieji pateikiami kaip nuoroda, padėsianti Jums suprasti savo esamus kvitų pritaikymus migracijos metu. Nauji pritaikymai turėtų būti kuriami vizualiniame kvito redaktoriuje.

Kvitų kodo redaktoriuje pasiekiami šie duomenų objektai:

Kvitų objektai

Kvitų duomenų objektų aprašas
Objektas	Aprašas
shop	Pateikiama parduotuvės informacija, pavyzdžiui, parduotuvės pavadinimas.
location	Pateikiama mažmeninės prekybos vietos informacija, pavyzdžiui, adresas ir telefono numeris.
order	Pateikiami užsakymo duomenys, įskaitant prekių pozicijas, nuolaidas, mokesčius ir operacijų informaciją.
return	Pasiekiamas tik šablone `return-and-exchange-receipt.liquid` ir susijusiuose daliniuose šablonuose. Pateikiami grąžinimo ir keitimo duomenys, įskaitant grąžintas prekių pozicijas, naujas prekių pozicijas, grynąją sumą ir operacijų informaciją.
gift_card	Pasiekiamas tik šablone `gift-card.liquid`. Pateikiami dovanų kortelės duomenys, įskaitant likutį, raidinį ir skaitmeninį kodą bei QR kodo turinį, kurį galima nuskaityti POS programėle.

Užsakymo objektas

Užsakymo objekto aprašas
Ypatybė	Aprašas
id	Užsakymo ID.
created_at	ISO 8601 formato data ir laikas, kada buvo sukurtas užsakymas.
source_identifier	Unikalus `POS` arba trečiosios šalies užsakymo identifikatorius.
change_due	Grąža, mokėtina už užsakymą.
balance_due	Mokėtina suma už šį užsakymą.
name	Unikalus užsakymo identifikatorius, rodomas užsakymo puslapyje „Shopify“ administratoriaus skydelyje ir Užsakymo būsenos puslapyje. Pavyzdžiui, „#1001“, „EN1001“ arba „1001-A“. Ši reikšmė nėra unikali keliose parduotuvėse.
note	Su užsakymu susietos pastabos turinys.
line_items	Užsakymo prekių pozicijų sąrašas.
subtotal_price	Visų prekių pozicijų kainų suma pritaikius nuolaidas ir prieš grąžinimus. Jei `taxesIncluded` reikšmė yra „true“, į tarpinę sumą taip pat įtraukiami mokesčiai.
total_price	Bendra užsakymo kaina prieš grąžinimus. Į ją įeina mokesčiai ir nuolaidos.
total_tip_received	Bendra visų užsakymo arbatpinigių suma.
discounts	Bendra nuolaidų suma.
transactions	Su užsakymu susijusių operacijų sąrašas.
taxes_included	Nurodo, ar mokesčiai įtraukti į tarpinę užsakymo kainą.
tax_lines	Visų mokesčių eilučių, pritaikytų užsakymo prekių pozicijoms prieš grąžinimus, sąrašas. Mokesčių eilučių kainos nurodo bendrą visų mokesčių eilučių, kurių tarifas ir pavadinimas yra vienodi, kainą.
customer	Klientas, kuris pateikė užsakymą.
shipping_address	Užsakyme nurodytas pristatymo adresas.
shipping_groups	Užsakymo pristatymo grupių sąrašas. Kiekvienoje grupėje yra prekių pozicijų, kurios įvykdomos kartu.

Grąžinimo objektas

Grąžinimo objekto aprašas
Ypatybė	Aprašas
name	Unikalus grąžinimo identifikatorius, rodomas užsakymo puslapyje „Shopify“ administratoriaus skydelyje ir Užsakymo būsenos puslapyje. Pavyzdžiui, „#1000-R1“. Ši reikšmė nėra unikali keliose parduotuvėse.
created_at	ISO 8601 formatu pateikta data ir laikas, kada buvo sukurtas grąžinimas.
is_unverified	Loginė reikšmė, nurodanti, ar grąžinimas buvo sukurtas kaip nepatvirtintas grąžinimas.
is_exchange	Loginė reikšmė, nurodanti, ar į grąžinimą įtrauktas keitimas. Tai apima pinigų grąžinimą į dovanų kortelę.
exchange_type	Keitimo tipas, jei į grąžinimą įtrauktas keitimas. Galimos reikšmės: `LIKE_FOR_LIKE`, `NET_REFUNDABLE` ir `NET_PAYABLE`.
return_discount	Bendra grąžintų užsakymo nuolaidų suma.
return_subtotal	Visų grąžinamų prekių pozicijų kainų suma prieš pritaikant nuolaidas. Jei `taxesIncluded` reikšmė yra „true“, į tarpinę sumą taip pat įtraukiami mokesčiai.
return_total	Bendra galima grąžinti suma. Į ją įtraukiami mokesčiai, nuolaidos, pristatymas ir arbatpinigiai. Tai gali būti ne faktinė grąžinta suma.
exchange_subtotal	Visų naujų keičiamų prekių pozicijų kainų suma prieš pritaikant nuolaidas. Jei `taxesIncluded` reikšmė yra „true“, į tarpinę sumą taip pat įtraukiami mokesčiai.
exchange_total	Bendra visų naujų keičiamų prekių pozicijų suma. Į ją įeina mokesčiai ir nuolaidos.
total_cash_rounding_adjustment	Grynųjų pinigų apvalinimo koregavimas, pritaikytas grąžinimui arba keitimui.
total_adjusted_amount	Bendra grąžinimo arba keitimo suma, pakoreguota pagal grynųjų pinigų apvalinimo koregavimą.
net_total	Faktinė bendra sumokėta arba grąžinta suma už grąžinimą arba keitimą, prieš grynųjų pinigų apvalinimą.
return_line_items	Grąžintos prekių pozicijos.
exchange_line_items	Naujos prekių pozicijos keitime.
return_tax_lines	Grąžintų prekių pozicijų mokesčių eilutės.
exchange_tax_lines	Naujų keičiamų prekių pozicijų mokesčių eilutės.
shipping_refund_amount	Grąžinta pristatymo išlaidų suma.
tip_refund_amount	Grąžintų arbatpinigių suma.
transactions	Su grąžinimu arba keitimu susijusios operacijos.

Pristatymo grupės objektas

Pristatymo grupės objekto aprašas
Ypatybė	Aprašas
destination	Pristatomų produktų paskirties vieta.
products	Pristatomų produktų sąrašas.

Prekės pozicijos objektas

Prekės pozicijos objekto aprašas
Ypatybė	Aprašas
id	Prekės pozicijos ID.
name	Produkto pavadinimas, pasirinktinai papildytas varianto pavadinimu (jei taikoma).
variant_title	Varianto pavadinimas užsakymo sukūrimo metu.
price	Prekės pozicijos vieneto kaina užsakymo sukūrimo metu. Į šią vertę nuolaidos neįtrauktos.
is_gift_card	Nurodo, ar prekės pozicija reiškia dovanų kortelės pirkimą.
discount	Bendra nuolaida, priskirta prekės pozicijai nuolaidų programėlių, įskaitant nuolaidas, priskirtas grąžintiems ir pašalintiems kiekiams.
total_price	Bendra šios prekės pozicijos suma.
selling_plan_name	Prekės pozicijai priskirto prenumeratos plano pavadinimas.
tax_rates	Šios prekės pozicijos mokesčių eilutės.
custom_attributes	Atributų, kurie nurodo pasirinktines ypatybes arba specialias užklausas, sąrašas.
variant_title	Varianto pavadinimas.
variant_id	Varianto ID.
variant_metafields	Pasirinktinių laukų, kuriuos prekybininkas susiejo su variantu, sąrašas.
staff_member_description	Prekės pozicijai priskirtas personalo narys.
product_metafields	Pasirinktinių laukų, kuriuos prekybininkas susiejo su produktu, sąrašas.

Grąžinamos prekės pozicijos objektas

Apima viską, kas yra prekių pozicijos objekte, ir šias ypatybes:

Prekės pozicijos objekto aprašas
Ypatybė	Aprašas
return_reason	Prekių pozicijos grąžinimo priežastis.
return_reason_note	Pasirinktinė pastaba, pateikiama kartu su grąžinimo priežastimi.

„Liquid“ filtrai, pasiekiami kvito kodo rengyklėje

Galite naudoti „Liquid“ filtrus norėdami koreguoti informaciją savo kvitų šablonuose. Pavyzdžiui, galite pakeisti valiutos formatavimą ar konkretaus teksto, pvz., mokesčių kodo, didžiąsias ir mažąsias raides.

Norėdami pritaikyti filtrą, pridėkite vertikalios linijos simbolį |, o tada filtrą „Liquid“ kodo bloke tarp dvejų riestinių skliaustų {{ }}. Filtrus galima taikyti tik „Liquid“ kodo blokams.

Toliau pateiktame pavyzdyje filtras pakeičia mokesčių kodo raides iš mažųjų į didžiąsias.

{{ tax_line.title | upcase }}

Pavyzdiniame kodo bloke `product` yra objektas, `title` – jo atributas, o `upcase` – pritaikytas filtras. Filtras `upcase` pakeičia `tax_line.title` reikšmės raidžių dydį į didžiąsias. Pavyzdžiui, jei `tax_line.title` reikšmė yra `Hst`, filtras `upcase` pakeis ją į `HST`.

Informacijos, kaip naudoti Liquid filtrus, ieškokite „Shopify“ temų Liquid žinyno filtrų skiltyje.

Kvito kodo rengyklėje galimi šie filtrai:

Kvitų filtrų aprašas
Ypatybė	Aprašas
t	Išverčia iš anksto nustatytas etiketes į kalbą, priskirtą Jūsų vietai.
money	Formatuoja kainą Jūsų vietos valiuta.
escape	Pakeičia specialiuosius HTML simbolius, pvz., `<>`, `'` ir `&`, ir konvertuoja juos į „escape“ sekas.
barcode	Sugeneruoja 1D brūkšninio kodo SVG.
qrcode	Sugeneruoja 2D brūkšninio kodo SVG.

Spausdinamo kvito šablono kodo tinkinimo pavyzdys

Galite naudoti „Liquid“, kad pridėtumėte sąlyginius pranešimus. Ši funkcija panaši į išsaugojimą vienoje vietoje naudojant vizualinę rengyklę. Pavyzdžiui, Jūsų verslas prasidėjo vienoje vietoje, o dabar turite kelias naujas vietas. Spausdintuose kvituose norite pabrėžti savo pradinę parduotuvę.

Galite pridėti pasirinktinį pranešimą į kodo rengyklės aplanko Sections šabloną header.liquid ir naudoti „Liquid“, kad pranešimas būtų rodomas tik Jūsų pagrindinėje vietoje.

Toliau pateiktas kodas patikrina vietos pavadinimą (šiuo atveju – Jūsų pirmosios vietos, pavadintos „Home“) ir, jei pavadinimas atitinka, parodo pranešimą „Sveiki atvykę į mūsų pirmąją parduotuvę, atidarytą 1972 m.“. Iš kitų Jūsų vietų spausdinamuose kvituose bus rodomas pranešimas „Sveiki atvykę į mūsų parduotuvę.“.

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

Peržiūrėkite savo kodo pakeitimus kodo rengyklėje

Pakeitimus spausdintiniuose kvituose galite peržiūrėti POS kodo redaktoriuje „Shopify“ administratoriuje.

Atsižvelgiant į tai, kuris „Liquid“ failas pasirinktas, peržiūros lange paryškinamas kvito dizainas arba skyrius, kurį veikia failas. Pagal numatytuosius nustatymus peržiūros lange rodomas naujausio POS užsakymo turinys. Galite pasirinkti konkretų užsakymą, kurio turinys bus naudojamas kvito peržiūrai, visiems „Liquid“ failams, išskyrus failą `gift-card.liquid`, kuriame kaip pasirenkamos peržiūros parinktys rodomos tik skirtingos vietos.

Veiksmai:

Visos `POS Pro` vietos

Iš savo „Shopify“ administratoriaus eikite į Pardavimo kanalai > Point of Sale.
Skiltyje Tinkinti patirtį parduotuvėje prie Kvitai spustelėkite Redaguoti.
Spustelėkite Tinkinti kvitus.
Spustelėkite Redaguoti kodą.
Spustelėkite kodo failą, kurį norite peržiūrėti. Jūsų kvitas bus parodytas dešiniausiame rengyklės lange.
Nebūtina: norėdami pasirinkti konkretų užsakymą, kurio turinys bus naudojamas kvito peržiūroje, atlikite šiuos veiksmus:
1. Spustelėkite piktogramą.
2. Dialogo lange Pasirinkite užsakymą peržiūrai rodomi pardavimai iš visų vietų, atlikti per „Point of Sale“ kanalą. Pasirinkite užsakymą iš sąrašo arba ieškokite konkrečių užsakymų ir vietų naudodamiesi paieškos juosta.
3. Spustelėkite Patvirtinti.
Nebūtina: jei peržiūrite failą `gift-card.liquid`, spustelėkite piktogramą ir pasirinkite vietą, kurios šabloną norite peržiūrėti.

Su „Lite“ / Italijos / Prancūzijos vietomis

Iš savo „Shopify“ administratoriaus eikite į Pardavimo kanalai > Point of Sale.
Skiltyje Tinkinti patirtį parduotuvėje prie Kvitai spustelėkite Redaguoti.
Puslapyje Kvitų pritaikymas spustelėkite Kodo redaktorius.
Spustelėkite kodo failą, kurį norite peržiūrėti. Jūsų kvitas bus parodytas dešiniausiame rengyklės lange.
Nebūtina: norėdami pasirinkti konkretų užsakymą, kurio turinys bus naudojamas kvito peržiūroje, atlikite šiuos veiksmus:
1. Spustelėkite piktogramą.
2. Dialogo lange Pasirinkite užsakymą peržiūrai rodomi pardavimai iš visų vietų, atlikti per „Point of Sale“ kanalą. Pasirinkite užsakymą iš sąrašo arba ieškokite konkrečių užsakymų ir vietų naudodamiesi paieškos juosta.
3. Spustelėkite Patvirtinti.
Nebūtina: jei peržiūrite failą `gift-card.liquid`, spustelėkite piktogramą ir pasirinkite vietą, kurios šabloną norite peržiūrėti.