Ilmoitusmuuttujien viiteopas

Kaupastasi lähetettävät ilmoitukset hahmonnetaan Liquid-kielellä. Liquid on Shopifyn yksinkertainen ja helppokäyttöinen ohjelmointikieli. Se on sama ohjelmointikieli, jolla Theme Storen teemat on rakennettu.

Jos haluat muokata kaupastasi lähetettäviä ilmoituksia, voit tehdä perusmukautuksia ilmoitusmalleihisi. Pääset tarkastelemaan täydellistä luetteloa muokattavissa olevista ilmoituksista siirtymällä Shopifyn ohjausnäkymän Ilmoitukset-sivulle.

Jos tarvitset apua edistyneemmissä muutoksissa tai mukautettujen ilmoitusmallien muuttamisessa, voit ottaa yhteyttä yhteisöön keskustelupalstoillamme tai voit myös palkata Shopify Partnerin tekemään mukautukset puolestasi. Lue lisää Shopify Partnerin palkkaamisesta.

Huomautus

Kaikilla Shopifyn ohjausnäkymän malleilla on pääsy niitä vastaavan tilauksen ominaisuuksiin. Kaikki muuttujat ovat käytettävissä missä tahansa ilmoitusmallissa, mutta jotkin muuttujat eivät välttämättä ole sovellettavissa, jos tiedot eivät ole vielä saatavilla ilmoitusta lähetettäessä.

Tilauksen ominaisuudet

Monet tilauksen ominaisuudet ovat saatavilla suoraan Liquid-kielen avulla ja malleissa.

Huomautus

Tilausobjektiin ei viitata nimellä sähköpostimalleissa. Esimerkiksi sen sijaan, että käyttäisit {{ order.shipping_method.title }} -muuttujaa tilausvahvistuksen sähköpostimallissa, sinun tulisi käyttää muuttujaa {{ shipping_method.title }}. Tekstiviesti-ilmoituksissa tilauksen ominaisuuksien eteen on kuitenkin lisättävä tuttuun tapaan order-etuliite.

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää tilausobjektin kanssa ilmoitusmalleissa

Ominaisuus	Kuvaus
id	Tilauksen järjestelmänlaajuinen yksilöllinen tunnus sisäiseen käyttöön. Luo seuraavan esimerkin avulla linkki tilaukseen kauppasi ohjausnäkymässä. Voit esimerkiksi lisätä Uusi tilaus -malliin seuraavan koodin: Näytä tilaus
email	Tilaukseen liitetty sähköpostiosoite.
name	Tyypillisesti tämä on ristikkomerkki, jota seuraa order_numbertilausnumero. Esimerkki: #1004
order_name	Sama kuin name.
order_number	Kaupan yksilöllinen tilausnumero ilman #-etuliitettä. Tähän ei sisälly kaupan omistajan kaupan asetuksissa tilaustunnukseen lisäämiä etu- tai jälkiliitteitä. Esimerkki: 1004
confirmation_number	Satunnaisesti luotu aakkosnumeerinen tunniste tilaukselle, joka voidaan näyttää asiakkaalle peräkkäisen tilauksen nimen sijaan. Tämän arvon ei taata olevan yksilöllinen. Esimerkki: XPAV284CT
created_at	Päivämäärä ja kellonaika, jolloin asiakas loi tilauksen. Voit muotoilla tätä päivämääräsuodattimella. Esimerkki: 2009-05-30T17:43:51+02:00
payment_terms	Maksuehdot määrittävät päivämäärän, jolloin tilauksen maksu erääntyy. Lue, miten voit lisätä maksuehtoja tilauslaskuihin. Lisätietoja saat Liquidin viiteasiakirjojen kohdasta payment_terms.
destination	Määränpää, johon tuotteet tulee lähettää.
tags	Palauttaa taulukon kaikista tilauksen tunnisteista. Tunnisteet palautetaan aakkosjärjestyksessä. Sovellusten tai alustan ominaisuuksien dynaamisesti lisäämät tunnisteet, kuten Shopify Collective -tunniste, eivät välttämättä ole käytettävissä, kun ilmoitussähköpostia luodaan. Jos haluat tunnistaa tietyn ominaisuuden tuotteet, tarkista sen sijaan kunkin rivikohdan tuotetason tunnisteet. Katso lisätietoja Liquidin viitedokumentaatiosta.
transactions	Palauttaa taulukon tilauksen tapahtumista.
tax_price	Kaikkien tilauksen tuotteiden yhteenlasketut verot.
tax_lines	Verot eriteltyinä verotustyypin mukaan: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title	Veron nimi. Esimerkiksi QST tai ALV.
tax_line.price	Veron määrä.
tax_line.rate	Verokanta desimaalilukuna. Se palauttaa arvon 0,175, jos verokanta on 17,5 %.
tax_line.rate_percentage	Verokanta ihmisluettavassa muodossa. Se palauttaa arvon 17,5, jos verokanta on 0,175.
customer	Asiakasobjekti, joka sisältää asiakkaan attribuutit.
billing_address	Laskutusosoite.
billing_address.first_name	Asiakkaan etunimi.
billing_address.last_name	Asiakkaan sukunimi.
billing_address.company	Yrityksen nimi laskutusta varten.
billing_address.phone	Puhelinnumero laskutusosoitteesta.
shop.name	Kauppasi nimi.
shop.phone	Kauppasi puhelinnumero.
subtotal_price	Tilauksen rivikohtien hintojen summa sen jälkeen, kun mahdolliset rivikohtaiset alennukset tai ostoskorin alennukset on vähennetty. Välisumma ei sisällä veroja (ellei veroja ole sisällytetty hintoihin), toimituskuluja tai tippejä.
discounts	Luettelo alennuksista.
discounts_amount	Kaikkien sovellettujen alennusten summa. Esimerkki: +5,00 $
discounts_savings	Kaikkien alennusten aikaansaama säästö. Esimerkki: -5,00 $
total_price	Tilauksen loppusumma (välisumma + toimituskulut - toimitusalennus + vero).
financial_status	Nykyinen maksun tila. Yksi seuraavista: nil, pending, authorized, paid, voided tai refunded.
requires_shipping	(boolean) Palauttaa arvon ”tosi”, jos tilauksessa on vähintään yksi toimitusta vaativa tuote.
shipping_method.title	Toimitushinnan nimi. Asiakkaalle näkyvissä ilmoituksissa toimitushinnan nimi käännetään kielelle, jota asiakas käytti kassalla, jos kieli on eri kuin kaupan oletuskieli. Esimerkki: Vakiotoimitus
shipping_method.price	Toimitushinta, joka sisältää mahdolliset toimitusalennukset. Esimerkki: {{ shipping_method.price | money }}
shipping_price	Toimitushinta. Esimerkki: {{ shipping_price | money }}
shipping_address	Toimitusosoite.
shipping_address.first_name	Toimitusosoitteen etunimi.
shipping_address.company	Toimitusosoitteen yritysnimi.
shipping_address.phone	Puhelinnumero toimitusosoitteesta.
line_items	Luettelo kaikista tilauksen rivikohdista.
line_items_including_zero_quantity	Luettelo kaikista tilauksen rivikohdista, mukaan lukien ne, joiden määrä on nolla. Rivikohtien määrä on nolla, kun ne on hyvitetty kokonaan.
line_item_groups(Orders and POS only)	Luettelo kaikista tilauksen rivikohtaryhmistä, jotka sisältävät rivikohtien tuoteosia.
item_count	Kaikkien tuotteiden määrien summa.
fulfillment_status	Tilauksen nykyinen täyttämisen tila. Yksi seuraavista: unfulfilled, partial tai fulfilled.
note	Tilaukseen liitetty huomautus. Huomautus voidaan saada asiakkaalta ja/tai sitä voidaan muokata tilauksen tietonäkymässä ohjausnäkymässäsi.
attributes	Kaikki tilaukseen liitetyt attribuutit. Esimerkki: {{ attributes.gift-note }}
metafields	Kaikki tilauksen metakentät. Käytä seuraavaa syntaksia: metafields.NAMESPACE.KEY
referring_site	Sisältää sen viittauslähteen URL-osoitteen, joka toi asiakkaan kauppaasi. Esimerkki: https://www.google.com/?s=great+products
landing_site	Sisältää asiakkaan käyttämän laskeutumissivuston polun. Tämä on ensimmäinen sivu, jonka asiakas näki saapuessaan kauppaan. Esimerkki: /products/great-product?ref=my-tracking-token
landing_site_ref	Tarkastelee laskeutumissivuston ja poimii siitä viiteparametrin. Viiteparametreja voivat olla ref, source ja r. Jos landing_site on /products/great-product?ref=my-tracking-token, niin landing_site_ref on my-tracking-token. Voit suorittaa tietyn toiminnon, jos viitteesi on yhtä suuri kuin tietty arvo: {% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}
cancelled	(boolean) Palauttaa arvon ”tosi”, jos tilaus on peruutettu.
cancelled_at	Aika, jolloin tilaus peruutettiin.
cancel_reason	Tilausta peruutettaessa valittu syy. Yksi seuraavista: inventory, customer, declined, fraud tai other.
has_high_risks?(deprecated)	Palauttaa arvon ”tosi”, jos tilaukseen liittyy suuri riski
unique_gateways	Palauttaa luettelon tilauksen yksilöllisistä maksupalveluntarjoajista. Jos joku on esimerkiksi maksanut Visalla, Mastercardilla ja käteisellä, palautettava luettelo on shopify_payments, cashtilausnumero.
location(POS only)	Näyttää tilauksen fyysisen sijainnin. Saatavilla on useita sijainnin ominaisuuksia, jotka on lueteltu täällä. Voit määrittää sijainteja ohjausnäkymän Sijainnit-alueella.
order_status_url	Palauttaa linkin tämän tilauksen tila -sivulle.
fulfilled_line_items(deprecated)	Luettelo toimitetuista rivikohdista.
unfulfilled_line_items(deprecated)	Luettelo rivikohdista, joita ei ole toimitettu kokonaan.
b2b?	Palauttaa arvon ”true”, jos tilaus on B2B-tilaus. Käytä ominaisuutta B2B-muuttujien kanssa, jotta voit näyttää sähköposteissa olennaisia tietoja, kuten yrityksen nimen, yrityksen sijainnin ja osoitteen. Voit esimerkiksi lisätä B2B-tilauksissa malliin ylätunnisteen, jossa on seuraavat tiedot: {% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company	Yritys, jolle B2B-tilauksessa myydään.
company.name	Yrityksen nimi B2B-tilauksessa.
company.id	Yrityksen tunnus B2B-tilauksessa.
company_location	Yrityksen sijainti B2B-tilauksessa. Yrityksellä, joka ostaa sinulta, voi olla useampi kuin yksi sijainti.
company_location.name	Yrityksen sijainnin nimi B2B-tilauksessa.
company_location.id	Yrityksen sijainnin tunnusnumero B2B-tilauksessa.
company_location.shipping_address	Yrityksen sijainnin toimitusosoite B2B-tilauksessa.
company_location.billing_address	Yrityksen sijainnin laskutusosoite B2B-tilauksessa.
customer_order_url	Sen tilauksen uusi tilauksen tila -sivu, johon asiakas on pyytänyt palautusta asiakastilien kautta.

Tilausluonnoksen ominaisuudet

Huomautus

Tilausluonnosilmoituksia ei voi lähettää tekstiviestillä.

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää tilausluonnos-objektin kanssa ilmoitusmalleissa

Ominaisuus	Kuvaus
id	Tilausluonnoksen yksilöllinen tunnus sisäiseen käyttöön.
invoice_url	Linkki, jonka kautta asiakas voi maksaa laskun Shopifyn suojatulla kassalla.
reserve_inventory_until	Päivämäärä ja kellonaika, johon asti luonnoksen rivikohdat on varattu, esimerkiksi 2015-05-30T17:43:51+02:00. Voit muotoilla päivämääriä Liquidin päivämääräsuodattimella.
user	Viimeisin henkilöstön jäsen, joka muokkasi tilausluonnosta.
user.name	Tilausluonnosta viimeksi muokanneen henkilöstön jäsenen nimi.
user.email	Tilausluonnosta viimeksi muokanneen henkilöstön jäsenen sähköpostiosoite.
email	Tilausluonnokseen liitetty sähköpostiosoite.
name	Tilausluonnoksen yksilöllinen number , jonka etuliitteenä on ristikkomerkki #.
number	Tilausluonnoksen yksilöllinen numero ilman tilauksen etu- tai jälkiliitettä.
created_at	Päivämäärä ja kellonaika, jolloin asiakas loi tilausluonnoksen, esimerkiksi 2009-05-30T17:43:51+02:00. Voit muotoilla päivämääriä Liquidin päivämääräsuodattimella.
tags	Palauttaa taulukon, jossa on kaikki tilauksen tunnisteet. Tunnisteet palautetaan aakkosjärjestyksessä. Katso lisätietoja Liquidin viiteasiakirjoista.
tax_price	Tilausluonnoksen kaikkien tuotteiden verot yhteensä.
tax_lines	Verot eriteltynä verotyypin mukaan: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title	Veron nimi. Esimerkkejä: QST tai ALV
tax_line.price	Veron määrä.
tax_line.rate	Verokanta desimaalimuodossa. Esimerkiksi 17,5 %:n verokanta palauttaa arvon 0,175.
tax_line.rate_percentage	Verokanta prosenttimuodossa. Esimerkiksi rate-arvo 0,175 palauttaa arvon 17,5.
customer	Asiakasobjekti, joka sisältää asiakkaan attribuutit.
billing_address	Tilausluonnoksen laskutusosoite.
billing_address.first_name	Asiakkaan etunimi.
billing_address.last_name	Asiakkaan sukunimi.
billing_address.company	Yrityksen nimi laskutusosoitteessa.
billing_address.phone	Puhelinnumero laskutusosoitteessa.
shop.name	Kauppasi nimi.
shop.phone	Kauppasi puhelinnumero.
subtotal_price	Tilausluonnoksen rivikohtaisten hintojen summa sen jälkeen, kun mahdolliset rivikohtaiset alennukset tai ostoskorin alennukset on vähennetty. Välisumma ei sisällä veroja (ellei veroja sisällytetä hintoihin) eikä toimituskuluja.
discounts	Luettelo alennuksista.
discounts_amount	Kaikkien alennusten yhteismäärä. Esimerkki: +5,00 $
discounts_savings	Kaikkien alennusten aiheuttama säästö. Esimerkki: -5,00 $
total_price	Tilauksen kokonaishinta (välisumma + toimituskulut - toimitusalennus + vero).
amount_due_now	Tilausluonnoksen laskussa vaadittu summa.
requires_shipping	Palauttaa arvon true jos tilausluonnoksessa on vähintään yksi toimitusta vaativa tuote. Palauttaa arvon false jos mikään tilausluonnoksen tuotteista ei vaadi toimitusta.
shipping_method.title	Toimitushinnan nimi. Esimerkki: Vakiotoimitus
shipping_method.price	Toimitustavan hinta. Palauttaa saman tiedon kuin shipping_pricetilausnumero.
shipping_price	Toimitushinta. Voit muotoilla tämän summan Liquidin rahasuodattimilla.
shipping_address	Toimitusosoite. Huomautus: Toisin kuin tavallisissa tilauksissa, tilausluonnoksen toimitusosoite voi olla puutteellinen.
shipping_address.first_name	Toimitusosoitteen etunimi.
shipping_address.company	Yrityksen nimi toimitusosoitteessa.
shipping_address.phone	Puhelinnumero toimitusosoitteessa.
line_items	Luettelo kaikista tilausluonnoksen rivikohdista.
item_count	Tilausluonnoksen kaikkien tuotteiden määrien summa.
note	Tilausluonnokseen liitetty huomautus. Huomautuksen voi saada asiakkaalta, ja sitä voi myös muokata Shopifyn ohjausnäkymän tilausluonnoksen tietonäkymässä.
metafields	Kaikki tilausluonnoksen metakentät. Käytä seuraavaa syntaksia: metafields.NAMESPACE.KEY
location	Tilauksen fyysinen sijainti. Saatavilla on useita sijainnin ominaisuuksia. Voit määrittää sijainteja Shopifyn ohjausnäkymän Sijainnit-sivulla.
b2b?	Palauttaa arvon ”true”, jos tilaus on B2B-tilaus. Käytä ominaisuutta B2B-muuttujien kanssa, jotta voit näyttää sähköposteissa olennaisia tietoja, kuten yrityksen nimen, yrityksen sijainnin ja osoitteen. Voit esimerkiksi lisätä B2B-tilauksissa malliin ylätunnisteen, jossa on seuraavat tiedot: {% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company	Yritys, jolle B2B-tilauksessa myydään.
company.name	Yrityksen nimi B2B-tilauksessa.
company.id	Yrityksen tunnus B2B-tilauksessa.
company_location	Yrityksen sijainti B2B-tilauksessa. Yrityksellä, joka ostaa sinulta, voi olla useampi kuin yksi sijainti.
company_location.name	Yrityksen sijainnin nimi B2B-tilauksessa.
company_location.id	Yrityksen sijainnin tunnusnumero B2B-tilauksessa.
company_location.shipping_address	Yrityksen sijainnin toimitusosoite B2B-tilauksessa.
company_location.billing_address	Yrityksen sijainnin laskutusosoite B2B-tilauksessa.
payment_methods	Luettelo tallennetuista maksutavoista, jotka ovat käytettävissä luonnoksen loppusumman käsittelyyn.
payment_method.payment_instrument	Maksuväline, joka sisältää tietoja tallennetusta maksutavasta.
payment_method.payment_instrument.payment_type	Tallennetun maksutavan tyyppi. Esim. ”credit_card, apple_pay”
payment_method.payment_instrument.credit_card_brand	Kortin brändi, kun `payment_type` on ”credit_card”.
payment_method.payment_instrument.credit_card_company	Korttiyhtiö, kun `payment_type` on ”credit_card”.
payment_method.payment_instrument.credit_card_company	Kortin 4 viimeistä numeroa, kun `payment_type` on ”credit_card”.

Maksuaikataulun ominaisuudet

Huomautus

Et voi lähettää maksumuistutusilmoituksia SMS-viesteillä.

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää maksuaikatauluobjektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
payment_schedule.amount_due	Maksuaikataulun maksettava summa. Voit muotoilla rahasummia valuuttoineen Liquidin rahasuodattimella.
payment_schedule.due_at	Maksuaikataulun eräpäivä. Voit muotoilla päivämääriä Liquidin päivämääräsuodattimella.
payment_schedule.due_in_days	Päivien määrä eräpäivään, jos maksuaikataulu on vielä maksamatta.
payment_schedule.due_later?	Palauttaa arvon tosi, jos maksuaikataulua ei ole maksettu ja sen eräpäivä on tulevaisuudessa.
payment_schedule.number_of_days_overdue?	Eräpäivästä kuluneiden päivien määrä, kun maksuaikataulu on erääntynyt.
payment_schedule.overdue?	Palauttaa arvon tosi, jos maksuaikataulua ei ole maksettu ja sen eräpäivä on mennyt.

Maksun tilan ominaisuudet

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää maksun tila -objektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
has_pending_payment	(boolean) Palauttaa arvon tosi, jos tilaukseen liittyy maksutapahtuma, jossa on odottava maksu. Lue lisää odottavista maksuista.
buyer_action_required	(boolean) Palauttaa arvon tosi, jos tilauksella on maksutapahtuma, jossa on odottava maksu, ja maksun eteneminen vaatii ostajalta toimenpiteitä. Kun tämä arvo on tosi ja maksutapa tukee maksuohjeita, buyer_pending_payment_instructions antaa tiedot, joiden avulla asiakas voi suorittaa ostoksensa loppuun offline-tilassa. Lue lisää Liquidin maksutapahtumaobjektista.

Tuotepaketin osan ominaisuudet

Jokaisella line_item.bundle_components-luettelon bundle_component-osalla on seuraavat ominaisuudet. (Vain tilausluonnoksissa)

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää tuotepaketin osan objektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
bundle_component.image_url	Tuotepaketin osan kuvan URL-osoite.
bundle_component.product.title	Tuotepaketin osana olevan tuotteen nimi.
bundle_component.quantity	Tuotepaketin osan määrä.
bundle_component.variant.title	Tuotepaketin osan version vaihtoehtojen arvojen nykyiset nimet erotettuna /-merkeillä. Esimerkki: pieni / punainen

Tuoteosan ominaisuudet

Jokaisella line_item.components-luettelon component-osalla on seuraavat ominaisuudet. (Vain hylätyissä kassoissa) `

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää tuoteosan objektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
component.image_url	Tuoteosan kuvan URL-osoite.
component.product.title	Tuoteosan tuotteen nimi.
component.quantity	Tuoteosan määrä.
component.variant.title	Tuoteosan version vaihtoehtojen arvojen nykyiset nimet erotettuna /-merkeillä. Esimerkki: pieni / punainen

Rivikohdan ominaisuudet

Jokaisella line_items- tai subtotal_line_items-luettelon line-rivillä on seuraavat ominaisuudet.

Vinkki

subtotal_line_items palauttaa ne rivikohdat, joita käytetään tilauksen subtotal_price-hinnan laskemiseen. subtotal_line_items ei sisällä juomaraharivikohtia.

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää rivikohtaobjektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
line.applied_discounts(POS and draft orders only)	Luettelo tähän rivikohtaan sovelletuista alennuksista (jokaisella alennuksella on ominaisuudet title, code, amount, savings ja type).
line.bundle_components(Draft orders only)	Tämän rivikohdan tuotepaketin osina olevien rivikohtien luettelo. Palauttaa luettelon vain, jos tämä rivikohta on tuotepaketti.
line.bundle_parent?(Draft orders only)	(boolean) Palauttaa arvon tosi, jos rivikohta on tuotepaketti.
line.components(Abandoned checkout only)	Tämän rivikohdan tuoteosina olevien rivikohtien luettelo.
line.parent?(Abandoned checkout only)	(boolean) Palauttaa arvon tosi, jos rivikohdalla on tuoteosia.
line.custom(Draft orders only)	(boolean) Palauttaa arvon tosi, jos rivikohta on tilausluonnoksen mukautettu rivikohta.
line.delivery_agreement	Tähän rivikohtaan liittyvä toimitussopimus.
line.grams	Yksittäisen tuotteen paino.
line.groups	Rivikohdan rivikohtaryhmä.
line.image	Palauttaa tähän rivikohtaan liittyvän kuvan URL-osoitteen. Voit myös käyttää img_url-suodatinta tiettyjen kuvakokojen saamiseksi, esimerkiksi {{ line.image | img_url: 'small' }}.
line.line_price	Tuotteen hinta kerrottuna sen määrällä.
line.original_line_price	Rivikohdan tuotteiden yhteishinta ennen alennusten soveltamista.
line.final_line_price	Rivikohdan kaikkien tuotteiden yhteishinta, mukaan lukien kaikki rivitason alennussummat.
line.pre_tax_price	Rivikohdan tuotteiden veroton hinta kerrottuna niiden määrällä.
line.price	Yksittäisen tuotteen hinta.
line.product.metafields	Kaikki tuotetason metakentät. Käytä seuraavaa syntaksia: line.product.metafields.NAMESPACE.KEY
line.product.title	Tuotteen nykyinen nimi.
line.product.vendor	Tuotteen myyjä.
line.properties	Palauttaa taulukon, joka sisältää tuotteen mukautettuja tietoja. Asiakas määrittää rivikohdan ominaisuudet tuotesivulla ennen tuotteen lisäämistä ostoskoriin.
line.quantity	Kyseisen tuotteen määrä.
line.current_quantity	Tuotteen nykyinen määrä poistojen jälkeen.
line.requires_shipping	(boolean) Palauttaa arvon tosi, jos tuotteen versiolla on tuotesivulla Fyysinen tuote -asetus käytössä.
line.selling_plan_allocation	Palauttaa selling_plan_allocation -objektin, joka kuvaa, miten myyntimalli, kuten tilaus, vaikuttaa rivikohtaan.
line.taxable	(boolean) Palauttaa arvon tosi, jos tuotteen versiolla on tuotesivulla valittuna ”Peri verot tästä tuotteesta” -valintaruutu.
line.title	Tuotteen nimi myyntihetkellä, jonka perässä on väliviiva ja version nimi myyntihetkellä. Version nimeä ei sisällytetä mukaan, jos se on ”Oletusotsikko”. Asiakkaille lähetettävissä ilmoituksissa tuotteen ja version nimi käännetään sille kielelle, jota asiakas käytti kassalla, jos kieli on eri kuin kaupan oletuskieli.
line.url	Rivikohdan version suhteellinen URL-osoite. Suhteellinen URL-osoite ei sisällä kauppasi juuri-URL-osoitetta (mystore.myshopify.com).
line.variant.barcode	Tuoteversioon liittyvä viivakoodi.
line.variant.compare_at_price	Tuoteversioon liittyvä vertailuhinta.
line.variant.image	Tuoteversion kuva. Palauttaa kuvan vain, jos versiolle on määritetty tietty kuva rivikohdassa.
line.variant.metafields	Kaikki versiotason metakentät. Käytä seuraavaa syntaksia: line.variant.metafields.NAMESPACE.KEY
line.variant.sku	Tuoteversioon liittyvä SKU-koodi.
line.variant.title	Version vaihtoehtojen arvojen nykyiset nimet /-merkeillä yhdistettynä. Esimerkki: pieni / punainen
line.refunded.quantity(within refund notifications)	Palautettavan tuotteen määrä. Voit käyttää tätä ominaisuutta lisätäksesi tunnisteen tilauksen palautetuille tuotteille. Esimerkiksi: {% if line.refunded_quantity > 0 %}Palautetun rivin tunniste{% endif %}

Shopify Collective -tuotteiden tunnistaminen ilmoitusmalleissa

Shopify Collective -tunniste lisätään tilaukseen tilausvahvistussähköpostin lähettämisen jälkeen, joten {% if tags contains 'Shopify Collective' %} ei ole koskaan true tilausvahvistusmallissa. Jos haluat tunnistaa Shopify Collective -tuotteet, tarkista sen sijaan kunkin rivikohdan tuotetason tunnisteet:

{% assign has_collective_item = false %}
{% for line in line_items %}
  {% if line.product.tags contains 'Shopify Collective' %}
    {% assign has_collective_item = true %}
  {% endif %}
{% endfor %}

{% if has_collective_item %}
  <!-- Collective-specific content -->
{% endif %}

Rivikohtaryhmän ominaisuudet

Jokaisella line_item_group-kohteella line_item_groups-luettelossa on seuraavat ominaisuudet.

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää rivikohtaryhmäobjektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
line_item_group.display_title	Rivikohtaryhmän otsikko.
line_item_group.components	Luettelo ryhmään kuuluvista tuoteosista.
line_item_group.image	Rivikohtaryhmän kuva.
line_item_group.product_id	Rivikohtaryhmän tuotetunnus.
line_item_group.variant	Rivikohtaryhmän versio-objekti.
line_item_group.variant_id	Rivikohtaryhmän versiotunnus.

Maksunpalautusten ominaisuudet

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää maksunpalautusobjektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
amount	Palautetun rahan määrä.
refund_line_items	Luettelo palautettavista maksunpalautuksen rivikohdista.

Maksunpalautuksen rivikohdan ominaisuudet

Jokaisella refund_line-kohteella refund_line_items-luettelossa on seuraavat ominaisuudet:

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää maksunpalautuksen rivikohteet -objektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
refund_line.line_item	Rivikohta, josta tehdään maksunpalautus. Tällä on pääsy kaikkiin rivikohdan ominaisuuksiin.
refund_line.quantity	Palautettavan rivikohdan määrä.

Tilauksen täyttämisen ominaisuudet

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää tilauksen täyttämisen objektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
service_name	Mukautetun palvelun nimi sellaisena kuin se on määritetty sivulla Asetukset > Toimitus ja jakelu. (Vain jakelupyyntö)
fulfillment.estimated_delivery_at	Arvioitu toimituspäivä, joka perustuu jonkin seuraavan kuljetusyhtiön (jos saatavilla) antamaan seurantenumeroon: USPS, FedEx, UPS, Canada Post (vain Kanada). Tämä ominaisuus on käytettävissä vain, kun kuljetusyhtiön laskemat hinnat ovat käytössä.
fulfillment.fulfillment_line_items	Luettelo täytettävistä tilauksentäyttämisen rivikohdista.
fulfillment.item_count	Kaikkien tuotteiden määrien summa. Täytettävien tuotteiden kokonaismäärä.
fulfillment.requires_shipping	(totuusarvo) Palauttaa arvon tosi, jos tämä tilauksen täyttöpyyntö vaatii toimituksen.
fulfillment.tracking_company	Seurannan suorittava yritys.
fulfillment.tracking_numbers	Luettelo seurantenumeroista.
fulfillment.tracking_urls	Luettelo seurannan URL-osoitteista.
items_to_fulfill(deprecated)	Luettelo rivikohdista, jotka tämä tietty mukautettu tilauksen täyttämisen palvelu täyttää. (Vain tilauksen täyttöpyyntö)
items_to_fulfill_count(deprecated)	Tällä pyynnöllä täytettävien tuotteiden kokonaismäärä. (Vain tilauksen täyttöpyyntö)

Tilauksentäyttämisen rivikohdan ominaisuudet

Jokaisella fulfillment_line-kohteella fulfillment_line_items-luettelossa on seuraavat ominaisuudet.

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää tilauksentäyttämisen rivikohteet -objektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
fulfillment_line.line_item	Täytettävä rivikohta. Tällä on pääsy kaikkiin rivikohdan ominaisuuksiin.
fulfillment_line.quantity	Täytettävän rivikohdan määrä.

Valmiin paketin ominaisuudet

Valmis paketti sisältää tuotteet, jotka on merkitty noudettaviksi.

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää valmis paketti -objektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
item_count	Valmiin paketin kaikkien tuotemäärien summa.
prepared_package_line_items	Luettelo valmiin paketin rivikohdista.

Valmiin paketin rivikohdan ominaisuudet

Jokaisella prepared_package_line_item-kohteella prepared_package_line_items-luettelossa on seuraavat ominaisuudet.

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää valmiin paketin rivikohta -objektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
line_item	Siihen liittyvä rivikohta. Tällä on pääsy kaikkiin rivikohdan ominaisuuksiin.
quantity	Noudettavaksi merkityn rivikohdan määrä.

Toimituksen ominaisuudet

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää toimitusobjektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
delivery_agreements	Luettelo kaikista tilauksen toimitussopimuksista.
delivery_instructions	Asiakkaan kanssa jaettavat paikallisen toimituksen tiedot. Näitä tietoja hallitaan paikallisen toimituksen asetustesi Toimitustiedot-kentällä.
consolidated_estimated_delivery_time	Asiakkaan kanssa jaettavat tilauksen toimituspäivätiedot. Näitä tietoja hallitaan Käsittelyaika-asetuksella, jonka olet määrittänyt Toimitus ja jakelu -sivulla. Kun tilauksella on useita toimitustapoja, näytetään luettelo toimitustavoista ja -päivistä.
has_multiple_delivery_methods	(totuusarvo) Palauttaa arvon tosi, jos tilauksella on useita toimitustapoja.

Toimitussopimuksen ominaisuudet

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää toimitussopimusobjektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
delivery_agreement.delivery_method_type	Toimitustavan tyyppi.
delivery_agreement.delivery_method_name	Toimitustavan tyyppi käännettynä kielelle, jolla ostaja teki ostoksen kassalla, kun kieli on eri kuin kaupan oletuskieli.
delivery_agreement.line_item_groups	Luettelo kaikista toimitussopimuksen rivikohtaryhmistä, jotka sisältävät niputettuja rivikohdan tuoteosia.
delivery_agreement.line_items	Luettelo kaikista tähän toimitussopimukseen liittyvistä rivikohdista.

Alennuksen ominaisuudet

Alennusominaisuuksia on kahta tyyppiä.

discount_applications kuvaavat, miksi ja miten tuotteelle on annettu alennus.

discount_allocations kuvaavat, miten tietty alennus vaikuttaa rivikohtaan ja miten se alentaa hintaa. Tätä ominaisuutta tulee käyttää rivikohtatasolla.

Voit yhdistää näitä ominaisuuksia ja näyttää alennustietoja rivikohta- tai tilaustasolla.

Esimerkki

Tässä esimerkissä tarkistetaan, onko rivikohtaan sovellettu alennusta. Jos alennusta ei sovellettu tilaustasolla (all), alennuksen nimi ja summa näytetään.

{% if line.discount_allocations %}
	{% for discount_allocation in line.discount_allocations %}
    	{% if discount_allocation.discount_application.target_selection != 'all' %}
        	{{ discount_allocation.discount_application.title | upcase }}
        	(-{{ discount_allocation.amount | money }})
    	{% endif %}
	{% endfor %}
{% endif %}

Tulos voi olla seuraavanlainen:

SPRING5 (-$5.00)

Discount_allocation-ominaisuudet

Jokaisella discount_allocation-kohteella discount_allocations-luettelossa on seuraavat ominaisuudet.

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää discount_allocation-objektin kanssa ilmoitusmalleissa

Ominaisuus	Kuvaus
discount_allocation.amount	Summa, jonka asiakas säästää rivikohdassa. On lisättävä silmukkaan, jos haluat sallia useita alennuskoodeja.
discount_allocation.discount_application	Alennuksen soveltaminen, joka kohdentaa summan rivikohtaan.

Discount_application-ominaisuudet

Jokaisella discount_application-kohteella discount_applications-luettelossa on seuraavat ominaisuudet.

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää discount_application-objektin kanssa ilmoitusmalleissa

Ominaisuus	Kuvaus
discount_application.target_selection	Kuvaa, miten alennus valitsee ostoskorista alennettavat rivikohdat. Yksi seuraavista: all: Alennus koskee kaikkia rivikohtia. entitled: Alennus koskee tiettyä rivikohtien alajoukkoa, joka määritellään usein ehdolla. explicit: Alennus koskee erikseen valittua rivikohtaa tai toimitusriviä.
discount_application.target_type	Nimiketyyppi, jota alennus koskee (line_item tai shipping_line).
discount_application.title	Alennuksen asiakkaalle näkyvä nimi. Esimerkkejä: Tervetuloa10 tai CBBWQQAKYBYY
discount_application.total_allocated_amount	Kokonaisumma, jolla alennus pienentää tilauksen hintaa.
discount_application.type	Alennuksen tyyppi. Yksi seuraavista: automatic, discount_code, manual tai script.
discount_application.value	Alennuksen arvo.
discount_application.value_type	Alennuksen arvotyyppi. Yksi seuraavista: fixed_amount tai percentage.

Toistuvien tilausten ominaisuudet

Tilaussopimuksen, nykyisen laskutusjakson ja sen rivikohtien, toimitustavan ja maksutavan tiedot ovat saatavilla kaikissa toistuvien tilausten sähköpostimalleissa.

Jos haluat muokata toistuvien tilausten ilmoitusmalleja, asenna Shopify Subscriptions -sovellus ja etsi sitten malli kohdasta Asetukset > Ilmoitukset osiosta Subscriptions.

Tilaussopimuksen laskutusjakson ominaisuudet

Voit käyttää tilaussopimuksen ja sen laskutusjakson ominaisuuksia subscription_contract_billing_cycle-objektin avulla.

Esimerkki

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

Tulos:

This contract is currently paused.

Ominaisuudet

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää subscription_contract_billing_cycle-objektin kanssa ilmoitusmalleissa

Ominaisuus	Kuvaus
status	Sopimuksen tila. Yksi seuraavista: active, paused, cancelled, failed, expired, stale,
delivery_method	Toistuvan tilauksen toimitustapa. Jos toistuva tilaus koskee palvelua tai digitaalista tuotetta, palautetaan nil.
billing_frequency	Kuinka usein toistuva tilaus laskutetaan.
delivery_frequency	Kuinka usein toistuva tilaus toimitetaan.
origin_order	Alkuperäinen tilaus, josta toistuva tilaus luotiin. Jos toistuvaa tilausta ei luotu Shopify-tilauksesta, palautetaan nil.
customer	Toistuvan tilauksen asiakas.
line_items	Toistuvan tilauksen laskutusjakson rivikohdat.
product_names	Luettelo toistuvan tilauksen laskutusjaksoon sisältyvien tuotteiden nimistä.
update_payment_method_url	URL-osoite, jonka avulla asiakas voi päivittää tämän sopimuksen maksutavan.
shipping_address	Toistuvan tilauksen toimitusosoite. Jos toistuva tilaus koskee palvelua tai digitaalista tuotetta, palautetaan nil.
billing_address	Toistuvan tilauksen laskutusosoite.
subtotal_price	Toistuvan tilauksen rivikohtien välisumma.
shipping_price	Toistuvan tilauksen toimituskulut.
total_tax	Toistuvan tilauksen verojen loppusumma.
total_price	Toistuvan tilauksen kokonaishinta.
total_discounts	Toistuvan tilauksen alennusten kokonaissumma.
customer_self_serve_url	Asiakkaan itsepalvelu-URL-osoite, jota käyttämällä hän voi hallita toistuvia tilauksiaan.
billing_attempt_expected_date	Tämän laskutusjakson laskutuspäivä.
next_billing_date	Seuraava ohittamaton laskutuspäivä tämän laskutusjakson jälkeen.
last_attempted_billing_date	Laskutusjakson viimeisin yritetty laskutuspäivä.
days_overdue	Päivien määrä, jotka tämän laskutusjakson laskutus on myöhässä.
payment_instrument	Maksuväline, joka liittyy tilaussopimukseen. Tätä maksuvälinettä käytetään asiakkaan laskuttamiseen.

Tilaussopimuksen rivikohdan ominaisuudet

Kunkin laskutusjaksoon sisältyvän rivikohdan ominaisuudet. Pääset sopimuksen rivikohtien ominaisuuksiin ylätason subscription_contract_billing_cycle.line_items-ominaisuuden kautta.

Esimerkki

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}

Huomautus

Sopimuksen rivikohtien ominaisuuksien lisäksi saatavilla ovat kaikki tavalliset rivikohdan ominaisuudet.

Kuvaukset Liquid-ominaisuuksista, joita voit käyttää tilaussopimuksen rivikohta-objektin kanssa ilmoitusmalleissa

Ominaisuus	Kuvaus
url	URL-osoite rivikohdan tuoteversion tuotetietosivulle.
requires_shipping	Edellyttääkö rivikohta fyysistä toimitusta.
unit_price_measurement	Rivikohdan yksikköhinnan mittaus.
selling_plan_allocation	Rivikohdan myyntisopimuksen kohdennus.

Tilaussopimuksen toimitustavan ominaisuudet

Tämän laskutusjakson aikana käytettävän toimitustavan ominaisuudet. Voit käyttää toimitustavan ominaisuuksia pääominaisuuden subscription_contract_billing_cycle.delivery_method kautta.

Esimerkki

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}

Kuvaus Liquid-ominaisuuksista, joita voit käyttää tilaussopimuksen toimitustapaobjektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
title	Toimitustapaan liittyvän toimitusvaihtoehdon otsikko.
type	Toimitustavan tyyppi. Jokin seuraavista: shipping, local tai pick-up.

Tilaussopimuksen maksuvälineen ominaisuudet

Tilaussopimuksen maksuvälineen tiedot. Tätä maksuvälinettä käytetään asiakkaan laskuttamiseen. Voit käyttää maksuvälineen ominaisuuksia pääominaisuuden subscription_contract_billing_cycle.payment_instrument kautta.

Esimerkki

{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}

<img src="{{ instrument.payment_type | payment_type_img_url }} "  alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}

Kuvaus Liquid-ominaisuuksista, joita voit käyttää tilaussopimuksen maksuvälineobjektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
payment_type	Maksuvälineen edustaman maksutavan tyyppi. Käytä maksusuodattimia kuvan URL-osoitteen tai SVG:n tulostamiseen.
credit_card_brand	Luottokortin merkki.
credit_card_company	Luottokorttiyhtiön nimi.
credit_card_last_four_digits	Luottokortin neljä viimeistä numeroa.

Sähköposti-ilmoituksen ominaisuudet

Kuvaus Liquid-ominaisuuksista, joita voit käyttää sähköposti-ilmoitusobjektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
shop.email_logo_url	Ohjausnäkymän Mukauta sähköpostimalleja -osiossa määritetyn logon URL-osoite.
shop.email_logo_width	Ohjausnäkymän Mukauta sähköpostimalleja -osiossa määritetty logon leveys (pikseleinä).
shop.email_accent_color	Ohjausnäkymän Mukauta sähköpostimalleja -osiossa määritetyn korostusvärin HEX-koodi.

Kauppakrediitin ominaisuudet

Ominaisuudet, jotka sisältävät tietoja kauppakrediitin myöntämisestä.

Kuvaus Liquid-ominaisuuksista, joita voit käyttää myönnetyn kauppakrediitin objektin kanssa ilmoitusmalleissa.

Ominaisuus	Kuvaus
issued_store_credit.amount	Myönnetyn kauppakrediitin määrä. Voit muotoilla tämän summan Liquidin rahasuodattimilla.
issued_store_credit.expires_at	Päivämäärä ja kellonaika, jolloin myönnetty kauppakrediitti vanhenee. Voit muotoilla tämän arvon Liquidin päivämääräsuodattimilla.
issued_store_credit.balance_after_transaction	Kauppakrediittitilin saldo krediitin myöntämisen jälkeen. Voit muotoilla tämän summan Liquidin rahasuodattimilla.
customer	Asiakasobjekti, joka sisältää asiakkaan attribuutit.