Shopify POS -järjestelmän tulostetun kuitin koodieditori

Voit mukauttaa tulostettuja kuittejasi Shopifyn ohjausnäkymän koodieditorilla. Kuitit muodostavat tiedostot sisältävät Liquidia, Shopifyn mallikieltä. Koodieditorilla voit tehdä HTML:n, CSS:n ja Liquidin avulla kehittyneempiä mukautuksia kuin visuaalisella editorilla.

Voit muuttaa kuittimallia ja tulostetuissa kuiteissa käytettäviä osioiden malleja. Kuitit-mallitiedostot ovat kuittityyppejä, joita voit tulostaa kaupassasi. Osiot ovat kuittien osia, kuten ylä- tai alatunniste. Osioita voidaan käyttää uudelleen useissa kuiteissa.

Tällä sivulla

Kuittien koodieditorin käyttöön liittyviä huomioita

Ennen kuin käytät kuittien koodieditoria, tarkista seuraavat huomioon otettavat seikat:

Käyttörajoitukset

Voit käyttää koodieditoria vain Shopifyn ohjausnäkymässä tietokoneella.
Koodieditori ei ole saatavilla myyntipisteen sijainteihin Italiassa.

Missä muutokset astuvat voimaan

Tekemäsi koodimuutokset koskevat vain valittua sijaintia.
Koodieditorin mukautukset koskevat vain POS Pro -toimipaikkoja. Jos käytät koodieditoria ja sinulla on myös muita kuin POS Pro -toimipaikkoja, voit käyttää visuaalista editoria ylä- ja alatunnisteiden mukauttamiseen kyseisissä toimipaikoissa.
Voit mukauttaa tulostettuja kuitteja, joilla on malli koodieditorissa, kuten myyntikuitteja, lahjakuitteja, lahjakorttikuitteja sekä palautus- ja vaihtokuitteja.

Koodikielet

Kuittien muodostavat tiedostot sisältävät Liquidia, Shopifyn mallikieltä. Lue lisää Liquidin käytöstä.
Jotta voit muokata malleja kuitin koodieditorissa, sinun on tunnettava HTML, CSS ja Liquid. Shopify-teematuki voi auttaa pienissä muutoksissa Shopifyn suunnittelukäytännön puitteissa.

Mukauttamisen rajoitukset

Et voi esikatsella kuitteja koodieditorissa eri tulostinkokojen mukaan. Jos haluat esikatsella kuitin tulostinkoon mukaan, käytä visuaalista editoria.
Tuotekuvaukset eivät ole käytettävissä muuttujina kuittimalleissa, eikä niitä voida lisätä tulostettuihin kuitteihin.

Mallin ylläpito

Jos mukautat kuittia kuitin koodieditorilla, nykyisestä mallistasi saattaa puuttua uusia ominaisuuksia, kuten selling_plan_name. Jotta voit lisätä uusimmat saatavilla olevat ominaisuudet malliisi, sinun on palautettava kuittimallisi oletusarvoiseksi. Kuittimallien palauttaminen oletusasetuksiin poistaa kaikki niihin tekemäsi mukautukset. Ota mukautettu koodi talteen ennen palauttamista. Kun olet palauttanut mallin, sinun on otettava mukautukset uudelleen käyttöön manuaalisesti.

Koodieditorin käyttäminen

Voit muokata mallejasi koodieditorilla. Sinun on ensin vaihdettava koodieditorin käyttöön oletusarvoisesta visuaalisesta editorista, ja voit vaihtaa takaisin visuaaliseen editoriin milloin tahansa.

Editorien välillä vaihtamisen vaiheet eroavat hieman sen mukaan, ovatko kaikki myyntipisteen sijaintisi oikeutettuja koodieditoriin vai vain osa niistä (esimerkiksi jos osa myyntipisteen sijainneistasi ei käytä POS Pro ‑tilausta tai sijaitsee Italiassa tai Ranskassa).

Vaiheet:

Kaikki POS Pro -sijainnit

Siirry Shopifyn ohjausnäkymässä kohtaan Myyntipiste > Asetukset.
Klikkaa Mukauttaminen-osiossa kohtaa Tulostetut kuitit avataksesi POS-editorin.
Klikkaa vasemman sivupalkin -kuvaketta.
Klikkaa Muokkaa koodia.
Muokkaa haluamaasi koodia Muokkaa tulostettujen kuittien koodia -valintaikkunassa.
Klikkaa Tallenna.
Valinnainen: Jos haluat jatkaa muiden Shopify-myyntipisteen sivujen muokkaamista POS-editorilla, siirry takaisin selainikkunassa.

Lite- tai Italia-sijainnit

Siirry Shopifyn ohjausnäkymässä kohtaan Myyntipiste > Asetukset.
Klikkaa Mukauttaminen-osiossa kohtaa Tulostetut kuitit avataksesi POS-editorin.
Klikkaa Kuitin mukauttaminen -sivulla Koodieditori.

Mukautettujen tiedostojen käyttäminen kuittimallissa

Voit käyttää tulostettujen kuittien mukauttamiseen tiedostoja, kuten kuvatiedostoja, jotka lataat Shopifyn ohjausnäkymään.

Tiedosto on ladattava Shopifyn ohjausnäkymään, ennen kuin sitä voi käyttää tulostetussa kuitissa. Lue lisää tiedostojen lataamisesta.

Vaiheet:

Siirry Shopifyn ohjausnäkymässä kohtaan Sisältö > Tiedostot.
Klikkaa sen tiedoston vieressä, jonka haluat sisällyttää tulostetun kuitin koodiin, olevaa -kuvaketta kopioidaksesi linkin.
Siirry koodieditoriin.
Lisää tiedostolinkki malliisi.

Kuittimallin palauttaminen oletusasetuksiin

Voit palauttaa kuittimallin oletusversioon koodieditorilla.

Vaiheet:

Kaikki POS Pro -sijainnit

Siirry Shopifyn ohjausnäkymässä kohtaan Myyntipiste > Asetukset.
Klikkaa Mukauttaminen-osiossa kohtaa Tulostetut kuitit avataksesi POS-editorin.
Klikkaa Mukauta kuittejasi.
Klikkaa Muokkaa koodia.
Klikkaa kooditiedostoa, jonka haluat palauttaa.
Klikkaa -kuvaketta.
Klikkaa Palauta tiedosto oletusasetuksiin -valintaikkunassa Palauta.

Lite- tai Italia-sijainnit

Siirry Shopifyn ohjausnäkymässä kohtaan Myyntipiste > Asetukset.
Klikkaa Mukauttaminen-osiossa kohtaa Tulostetut kuitit avataksesi POS-editorin.
Klikkaa Kuitin mukauttaminen -sivulla Koodieditori.
Klikkaa kooditiedostoa, jonka haluat palauttaa.
Klikkaa -kuvaketta.
Klikkaa Palauta tiedosto oletusasetuksiin -valintaikkunassa Palauta.

Kuitin koodieditorissa käytettävissä olevat Liquid-muuttujat

Voit käyttää Liquidia tulostettavan kuittimallin ja kuittityyppien mukauttamiseen.

Seuraavat dataobjektit ovat käytettävissä kuitin koodieditorissa:

Kuittiobjektit

Kuittien dataobjektien kuvaus
Objekti	Kuvaus
shop	Sisältää kaupan tiedot, kuten kaupan nimen.
location	Sisältää kauppapaikan tiedot, kuten osoitteen ja puhelinnumeron.
order	Sisältää tilauksen tiedot, mukaan lukien rivikohdat, alennukset, verot ja maksutapahtumatiedot.
return	Käytettävissä vain mallissa `return-and-exchange-receipt.liquid` ja siihen liittyvissä osittaisissa malleissa. Sisältää palautus- ja vaihtotiedot, mukaan lukien palautetut rivikohdat, uudet rivikohdat, nettosumman ja maksutapahtumatiedot.
gift_card	Käytettävissä vain mallissa `gift-card.liquid`. Sisältää lahjakortin tiedot, mukaan lukien saldon, aakkosnumeerisen koodin ja QR-koodin sisällön, jonka POS-sovellus voi skannata.

Tilausobjekti

Tilausobjektin kuvaus
Ominaisuus	Kuvaus
id	Tilauksen tunnus.
created_at	Tilauksen luontipäivämäärä ja -aika ISO 8601 -muodossa.
source_identifier	Yksilöllinen POS- tai kolmannen osapuolen tilauksen tunniste.
change_due	Tilauksen vaihtoraha.
balance_due	Tästä tilauksesta velkaa oleva summa.
name	Tilauksen yksilöllinen tunniste, joka näkyy Shopifyn ohjausnäkymän tilaussivulla ja Tilauksen tila -sivulla. Esimerkiksi ”#1001”, ”EN1001” tai ”1001-A”. Tämä arvo ei ole yksilöllinen eri kauppojen välillä.
note	Tilaukseen liitetyn huomautuksen sisältö.
line_items	Luettelo tilauksen rivikohdista.
subtotal_price	Kaikkien rivikohtien hintojen summa alennusten jälkeen ja ennen palautuksia. Jos `taxesIncluded`-arvo on tosi, välisumma sisältää myös veron.
total_price	Tilauksen kokonaishinta ennen palautuksia. Tämä sisältää verot ja alennukset.
total_tip_received	Tilauksen kaikkien juorahojen summa.
discounts	Alennusten kokonaissumma.
transactions	Luettelo tilaukseen liittyvistä maksutapahtumista.
taxes_included	Ilmaisee, sisältyvätkö verot tilauksen välisummaan.
tax_lines	Luettelo kaikista veroriveistä, joita on sovellettu tilauksen rivikohtiin ennen palautuksia. Verorivien hinnat edustavat kaikkien samalla verokannalla ja nimikkeellä olevien verorivien kokonaishintaa.
customer	Tilauksen tehnyt asiakas.
shipping_address	Tilauksen toimitusosoite.
shipping_groups	Tilauksen toimitusryhmien luettelo. Kukin ryhmä sisältää rivikohdat, jotka toimitetaan yhdessä.

Palautus-objekti

Palautus-objektin kuvaus
Ominaisuus	Kuvaus
name	Palautuksen yksilöllinen tunniste, joka näkyy Shopifyn ohjausnäkymän tilaussivulla ja Tilauksen tila -sivulla. Esimerkiksi ”#1000-R1”. Tämä arvo ei ole yksilöllinen eri kauppojen välillä.
created_at	ISO 8601 -muotoiltu päivämäärä ja aika, jolloin palautus luotiin.
is_unverified	Boolen arvo, joka ilmaisee, onko palautus luotu vahvistamattomana palautuksena.
is_exchange	Boolen arvo, joka ilmaisee, sisältääkö palautus vaihdon. Tämä sisältää lahjakortille tehdyt hyvitykset.
exchange_type	Vaihdon tyyppi, jos palautus sisältää vaihdon. Mahdollisia arvoja ovat `LIKE_FOR_LIKE`, `NET_REFUNDABLE` ja `NET_PAYABLE`.
return_discount	Hyvitettyjen tilauksen alennusten kokonaismäärä.
return_subtotal	Kaikkien palautuksen rivikohtien hintojen summa ennen alennuksia. Jos `taxesIncluded`-arvo on tosi, välisumma sisältää myös veron.
return_total	Mahdollinen palautussumma yhteensä. Tämä sisältää verot, alennukset, toimituksen ja tipit. Se ei välttämättä ole todellinen palautettu summa.
exchange_subtotal	Kaikkien vaihdon uusien rivikohtien hintojen summa ennen alennuksia. Jos `taxesIncluded`-arvo on tosi, välisumma sisältää myös veron.
exchange_total	Kaikkien vaihdon uusien rivikohtien kokonaissumma. Tämä sisältää verot ja alennukset.
total_cash_rounding_adjustment	Palautukseen tai vaihtoon sovellettu käteismaksujen pyöristyksen oikaisu.
total_adjusted_amount	Palautuksen tai vaihdon kokonaissumma, jota on oikaistu käteismaksujen pyöristyksellä.
net_total	Todellinen maksettu tai hyvitetty kokonaissumma palautuksesta tai vaihdosta ennen käteismaksujen pyöristystä.
return_line_items	Palautetut rivikohdat.
exchange_line_items	Vaihdon uudet rivikohdat.
return_tax_lines	Palautettujen rivikohtien verorivit.
exchange_tax_lines	Vaihdon uusien rivikohtien verorivit.
shipping_refund_amount	Hyvitetty toimituskulujen määrä.
tip_refund_amount	Hyvitetty juomarahan määrä.
transactions	Palautukseen tai vaihtoon liittyvät maksutapahtumat.

Toimitusryhmä-objekti

Toimitusryhmä-objektin kuvaus
Ominaisuus	Kuvaus
destination	Toimitettavien tuotteiden määränpää.
products	Luettelo toimitettavista tuotteista.

Rivikohta-objekti

Rivikohta-objektin kuvaus
Ominaisuus	Kuvaus
id	Rivikohdan tunnus.
name	Tuotteen nimi, johon on valinnaisesti liitetty version nimi (jos sovellettavissa).
variant_title	Version nimi tilauksen luontihetkellä.
price	Rivikohdan yksikköhinta tilausta luotaessa. Tämä arvo ei sisällä alennuksia.
is_gift_card	Ilmaisee, edustaako rivikohta lahjakortin ostoa.
discount	Alennuksen kokonaismäärä, joka on kohdistettu rivikohdalle alennussovellusten avulla, mukaan lukien hyvitetyille ja poistetuille määrille kohdistetut alennukset.
total_price	Tämän rivikohdan kokonaissumma.
selling_plan_name	Rivikohdalle määritetyn toistuvan tilauksen sopimuksen nimi.
tax_rates	Tämän rivikohdan verorivit.
custom_attributes	Luettelo attribuuteista, jotka edustavat mukautettuja ominaisuuksia tai erityistoiveita.
variant_title	Version nimi.
variant_id	Version tunnus.
variant_metafields	Luettelo mukautetuista kentistä, jotka kauppias on liittänyt versioon.
staff_member_description	Rivikohtaan liitetty henkilöstön jäsen.
product_metafields	Luettelo mukautetuista kentistä, jotka kauppias on liittänyt tuotteeseen.

Palautuksen rivikohta -objekti

Sisältää kaiken rivikohta-objektissa olevan sekä seuraavat ominaisuudet:

Rivikohta-objektin kuvaus
Ominaisuus	Kuvaus
return_reason	Rivikohdan palautuksen syy.
return_reason_note	Valinnainen huomautus, joka liittyy palautuksen syyhyn.

Kuitin koodieditorissa käytettävissä olevat Liquid-suodattimet

Voit käyttää Liquid-suodattimia tehdäksesi muutoksia kuittimalliesi tietoihin. Voit esimerkiksi muuttaa valuutan muotoilua tai tietyn tekstin, kuten verokoodin, isojen ja pienten kirjainten käyttöä.

Ota suodatin käyttöön lisäämällä pystyviiva | ja sitten suodatin kaksinkertaisten aaltosulkeiden {{ }} välissä olevaan Liquid-koodilohkoon. Suodattimia voidaan soveltaa vain Liquid-koodilohkoihin.

Seuraavassa esimerkissä suodatin muuttaa verokoodin pienistä kirjaimista isoiksi kirjaimiksi.

{{ tax_line.title | upcase }}

Esimerkkikoodilohkossa product on objekti, title on sen ominaisuus ja upcase on käytetty suodatin. upcase-suodatin muuttaa tax_line.title-arvon kirjainkoon isoiksi kirjaimiksi. Jos esimerkiksi tax_line.title-arvo on Hst, upcase-suodatin muuttaa sen muotoon HST.

Katso Shopify-teemojen Liquid-viiteoppaan Suodattimet-osiosta lisätietoja Liquid-suodattimien käytöstä.

Seuraavat suodattimet ovat käytettävissä kuitin koodieditorissa:

Kuittisuodattimien kuvaus
Ominaisuus	Kuvaus
t	Kääntää ennalta määritetyt merkinnät toimipaikallesi määritetylle kielelle.
money	Muotoilee hinnan toimipaikkasi valuutan mukaiseksi.
escape	Ohittaa HTML-koodin erikoismerkit, kuten `<>`, `'` ja `&`, ja muuntaa merkit ohjausjaksoiksi.
barcode	Luo 1D-viivakoodin SVG-muodossa.
qrcode	Luo 2D-viivakoodin SVG-muodossa.

Esimerkki tulostetun kuittimallin koodin mukauttamisesta

Voit lisätä ehdollisia viestejä Liquidin avulla. Tämä toiminnallisuus on samanlainen kuin tallennus yhteen toimipaikkaan visuaalisella editorilla. Jos esimerkiksi yrityksesi aloitti toimintansa yhdessä toimipaikassa ja sinulla on nyt useita uusia toimipaikkoja, voit korostaa alkuperäistä kauppaasi tulostetuissa kuiteissa.

Voit lisätä mukautetun viestin koodieditorin Sections-kansion header.liquid-malliin ja käyttää Liquidia viestin näyttämiseen vain lippulaivasijainnissasi.

Seuraava koodi tarkistaa sijainnin nimen, tässä tapauksessa alkuperäisen sijaintisi nimen ”Home”, ja näyttää viestin ”Welcome to our original store, opened in 1972.”, jos sijainnin nimi täsmää. Muista sijainneistasi tulostetuissa kuiteissa näytetään sen sijaan viesti ”Welcome to our store.”.

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

Koodimuutosten esikatselu koodieditorissa

Voit esikatsella tulostettuihin kuitteihin tehtyjä muutoksia Shopifyn ohjausnäkymän POS-koodieditorissa.

Valitusta Liquid-tiedostosta riippuen esikatseluikkuna korostaa kuitin sitä mallia tai osaa, johon tiedosto vaikuttaa. Oletusarvoisesti esikatseluikkunassa näytetään viimeisimmän POS-tilauksesi sisältö. Voit valita tietyn tilauksen käytettäväksi kuitin sisältönä esikatseluikkunassa kaikille Liquid-tiedostoille paitsi gift-card.liquid-tiedostolle, joka näyttää esikatseluvaihtoehtoina vain eri sijainnit.

Vaiheet:

Kaikki POS Pro -sijainnit

Siirry Shopifyn ohjausnäkymässä kohtaan Myyntipiste > Asetukset.
Klikkaa Mukauttaminen-osiossa kohtaa Tulostetut kuitit avataksesi POS-editorin.
Klikkaa Mukauta kuittejasi.
Klikkaa Muokkaa koodia.
Klikkaa kooditiedostoa, jota haluat esikatsella. Kuittisi näkyy editorin oikeanpuoleisessa ruudussa.
Valinnainen: Jos haluat valita tietyn tilauksen käytettäväksi kuitin sisältönä esikatseluikkunassa, tee seuraavat toimet:
1. Klikkaa -kuvaketta.
2. Kaikista sijainneista Point of Sale -kanavan kautta tehdyt myynnit näytetään Valitse esikatseltava tilaus -valintaikkunassa. Valitse tilaus luettelosta tai etsi tiettyjä tilauksia ja sijainteja hakupalkin avulla.
3. Klikkaa Vahvista.
Valinnainen: Jos esikatseltavanasi on gift-card.liquid-tiedosto, klikkaa -kuvaketta ja valitse sijainti, jolle haluat esikatsella mallia.

Lite- tai Italia-sijainnit

Siirry Shopifyn ohjausnäkymässä kohtaan Myyntipiste > Asetukset.
Klikkaa Mukauttaminen-osiossa kohtaa Tulostetut kuitit avataksesi POS-editorin.
Klikkaa Kuitin mukauttaminen -sivulla Koodieditori.
Klikkaa kooditiedostoa, jota haluat esikatsella. Kuittisi näkyy editorin oikeanpuoleisessa ruudussa.
Valinnainen: Jos haluat valita tietyn tilauksen käytettäväksi kuitin sisältönä esikatseluikkunassa, tee seuraavat toimet:
1. Klikkaa -kuvaketta.
2. Kaikista sijainneista Point of Sale -kanavan kautta tehdyt myynnit näytetään Valitse esikatseltava tilaus -valintaikkunassa. Valitse tilaus luettelosta tai etsi tiettyjä tilauksia ja sijainteja hakupalkin avulla.
3. Klikkaa Vahvista.
Valinnainen: Jos esikatseltavanasi on gift-card.liquid-tiedosto, klikkaa -kuvaketta ja valitse sijainti, jolle haluat esikatsella mallia.