„Shopify POS“ spausdintų kvitų kodo rengyklė

Spausdinamus kvitus galite tinkinti naudodami kodo rengyklę savo „Shopify“ administratoriaus skydelyje. Failuose, iš kurių sudaromi Jūsų kvitai, yra Liquid – „Shopify“ šablonų kalba. Naudodami kodo rengyklę ir HTML, CSS bei „Liquid“ galite sukurti pažangesnius pritaikymus nei naudodami vizualinę rengyklę.

Galite keisti kvito šabloną ir skyrių šablonus, naudojamus spausdintuose kvituose. Šablonų failai Kvitai – tai kvitų tipai, kuriuos galite spausdinti savo parduotuvėje. Skyriai – tai kvitų dalys, pavyzdžiui, antraštė arba poraštė. Skyrius galima pakartotinai naudoti keliuose kvituose.

Š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.
Kodų redagavimo priemonė nepasiekiama jokiose pardavimo vietose Italijoje.

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.
Galite tinkinti spausdinamus kvitus, kurių šablonas yra kodo redaktoriuje, pavyzdžiui, pardavimo kvitus, dovanų kvitus, dovanų kortelių kvitus bei grąžinimo ir keitimo kvitus.

Kodo kalbos

Failuose, iš kurių sudaromi Jūsų kvitai, yra „Liquid“ – „Shopify“ šablonų kalba. Sužinokite daugiau apie tai, kaip naudoti „Liquid“.
Norėdami redaguoti šablonus kvito kodo rengyklėje, turite išmanyti HTML, CSS ir „Liquid“. „Shopify“ temų palaikymo komanda gali padėti atlikti nedidelius pakeitimus, neperžengiant „Shopify“ dizaino politikos ribų.

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

Jei tinkinate kvitą kvitų kodo redagavimo priemone, jūsų esamame šablone gali trūkti naujų ypatybių, pvz., selling_plan_name. Norėdami į šabloną įtraukti naujausias galimas ypatybes, turite atstatyti kvitų šabloną į numatytąjį. Atstačius numatytuosius kvitų šablonų nustatymus, pašalinami visi jūsų atlikti pritaikymai. Prieš atstatydami išsaugokite tinkintą kodą. Atstatę šabloną, turėsite rankiniu būdu vėl atlikti pritaikymus.

Kodo redaktoriaus pasiekimas

Savo šablonus galite redaguoti naudodami kodo rengyklę. Pirmiausia turite perjungti į kodo rengyklę iš numatytosios vizualinės rengyklės ir bet kada galite perjungti atgal į vizualinę rengyklę.

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

Savo „Shopify“ administratoriaus skydelyje eikite į Point of Sale > Nustatymai.
Skiltyje Tinkinimas spustelėkite Atspausdintus kvitus, kad atidarytumėte POS redaktorių.
Kairiojoje šoninėje juostoje spustelėkite piktogramą .
Spustelėkite Redaguoti kodą.
Dialogo lange Spausdinamų kvitų kodo redagavimas redaguokite norimą keisti kodą.
Spustelėkite Išsaugoti.
Neprivaloma: norėdami toliau redaguoti daugiau „Shopify POS“ puslapių naudodami POS redaktorių, grįžkite atgal naršyklės lange.

`Lite` arba Italijos vietų atveju

Savo „Shopify“ administratoriaus skydelyje eikite į Point of Sale > Nustatymai.
Skiltyje Tinkinimas spustelėkite Atspausdintus kvitus, kad atidarytumėte POS redaktorių.
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į

Naudodami kodo redaktorių galite atstatyti kvito šabloną į numatytąją versiją.

Veiksmai:

Visos `POS Pro` vietos

Savo „Shopify“ administratoriaus skydelyje eikite į Point of Sale > Nustatymai.
Skiltyje Tinkinimas spustelėkite Atspausdintus kvitus, kad atidarytumėte POS redaktorių.
Spustelėkite Tinkinti kvitus.
Spustelėkite Redaguoti kodą.
Spustelėkite kodo failą, kurį norite atstatyti.
Spustelėkite piktogramą .
Dialogo lange Atstatyti failo numatytuosius nustatymus spustelėkite Atstatyti.

`Lite` arba Italijos vietų atveju

Savo „Shopify“ administratoriaus skydelyje eikite į Point of Sale > Nustatymai.
Skiltyje Tinkinimas spustelėkite Atspausdintus kvitus, kad atidarytumėte POS redaktorių.
Puslapyje Kvitų pritaikymas spustelėkite Kodo redaktorius.
Spustelėkite kodo failą, kurį norite atstatyti.
Spustelėkite piktogramą .
Dialogo lange Atstatyti failo numatytuosius nustatymus spustelėkite Atstatyti.

„Liquid“ kintamieji, pasiekiami kvitų kodo redaktoriuje

Galite naudoti „Liquid“, kad pritaikytumėte spausdinamo kvito šabloną ir kvitų tipus.

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, kuris rodomas „Shopify“ administratoriaus skydelio užsakymų puslapyje ir Užsakymo būsenos puslapyje. Pavyzdžiui, „#1001“, „EN1001“ arba „1001-A“. Ši vertė nėra unikali visose 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, kuris rodomas „Shopify“ administratoriaus skydelio užsakymų puslapyje ir Užsakymo būsenos puslapyje. Pavyzdžiui, „#1000-R1“. Ši vertė nėra unikali visose 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 keisti valiutos formatavimą arba konkretaus teksto, pvz., mokesčių kodo, raidžių dydį.

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

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

Savo „Shopify“ administratoriaus skydelyje eikite į Point of Sale > Nustatymai.
Skiltyje Tinkinimas spustelėkite Atspausdintus kvitus, kad atidarytumėte POS redaktorių.
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.

`Lite` arba Italijos vietų atveju

Savo „Shopify“ administratoriaus skydelyje eikite į Point of Sale > Nustatymai.
Skiltyje Tinkinimas spustelėkite Atspausdintus kvitus, kad atidarytumėte POS redaktorių.
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.