Ilmoitusmuuttujien viite

Kaupasta lähetetyt ilmoitukset muodostetaan käyttämällä Liquidiä. Liquid on Shopifyn yksinkertainen ja helppokäyttöinen ohjelmointikieli. Se on sama ohjelmointikieli, jolle Theme Store -kaupan teemat perustuvat.

Jos haluat muokata kaupastasi lähetettyjä ilmoituksia, voit tehdä ilmoitusmalleihin perusmukautuksia.

Jos tarvitset apua kehittyneempien muutosten tekemisessä tai jos haluat tehdä muutoksia mukautettuihin ilmoitusmalleihin, kysy neuvoa foorumiemme yhteisöltä – sieltä saat usein ystävällisiä ja hyödyllisiä neuvoja. Voit myös palkata Shopify Expert -asiantuntijan tekemään mukautukset puolestasi.

Tässä on luettelo Liquid-ilmoitusmalleista, joita voit muokata kauppasi hallinnassa:

• Hylätty ostoskori
• Ota yhteyttä asiakkaaseen
• Asiakastiliä koskeva kutsu
• Asiakastilin tervetulotoivotus
• Asiakastilin salasanan nollaus
• Tilausluonnoksen lasku
• Huolintapyyntö
• Lahjakortti on luotu
• Uusi tilaus
• Uusi tilaus (mobiili)
• Tilaus peruutettiin
• Tilausvahvistus
• POS ja mobiilikuitti
• Tilauksen maksun palautus
• Lähetysvahvistus
• Lähetyspäivitys

Kaikissa hallinnan malleissa on pääsy niitä vastaavan tilauksen ominaisuuksiin:

Tilauksen ominaisuudet

Monet tilauksen ominaisuudet ovat käytettävissä suoraan Liquidin avulla, malleissa ja ylimääräisissä komentosarjoissa.

Tilauksen ominaisuudet ovat käytettävissä seuraavissa malleissa:

• Tilausvahvistus
• Uusi tilaus
• Uusi tilaus (mobiili)
• Lähetysvahvistus
• Lähetyspäivitys
• Lisäkomentosarjat
• Huolintapyyntö

Huomautus

Toisin kuin useimmat muut Liquid-objektit, tilausobjektiin itseensä ei viitata nimellä missään sähköpostimallissa tai Muut komentosarjat -ruutuun lisätyssä koodissa. Sen sijaan, että käyttäisit koodia {{ order.shipping_method.title }} esimerkiksi Tilausvahvistus-sähköpostimallissa, voit käyttää yksinkertaisesti koodia {{ shipping_method.title }} Tekstiviesti-ilmoituksissa tilausominaisuuksiin on kuitenkin liitettävä tavanomainen order.

Tilauksen ominaisuuksien kuvaus

Ominaisuus	Kuvaus
id	Järjestelmänlaajuinen yksilöllinen tilaustunnus sisäistä käyttöä varten. Käytä tätä esimerkiksi, jos haluat luoda linkin tilaukseen kaupan hallintaosiossa. Esimerkiksi Uusi tilaus -mallissa <a href="{{ shop.url }}/admin/orders/{{ id }}">View order</a>
email	Tilaukseen liittyvä sähköposti.
name	Yleensä tämä on ristikkomerkki, jota seuraa order_number-tilausnumero, esimerkiksi Tilaus #1004.
order_name	Sama kuin nimi.
order_number	Kaupan yksilöllinen tilausnumero, esim. 1004, ilman ristikkomerkkietuliitettä (#) tai mitä tahansa kaupan omistajan kaupan asetuksissa tilaustunnukseen lisäämää liitettä.
created_at	Päivämäärä ja kellonaika, jolloin asiakas loi tilauksen, esim. 2009-05-30T17:43:51+02:00. Voit muotoilla tätä päivämääräsuodattimella.
tags	Palauttaa tilauksen kaikkien tunnisteiden joukon. Tunnisteet palautetaan aakkosjärjestyksessä. Katso lisätietoja Liquid-viitedokumentaatiostamme.
transactions	Palauttaa tilauksesta joukon tapahtumia.
tax_price	Tilauksen kaikkien tuotteiden yhteenlasketut verot.
tax_lines	Verot verotustason mukaan eriteltynä: {% 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	Hinta
tax_line.rate	Veroprosentti. Palauttaa 0.175, jos se on 17,5 %.
tax_line.rate_percentage	Verokanta ihmisen luettavissa olevassa muodossa. Palauttaa arvon 17,5, jos prosentti on 0,175.
customer	Asiakasobjekti, joka sisältää asiakkaan tuotoksen ominaisuudet.
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	Laskutusosoitteen puhelinnumero.
shop.name	Kaupan nimi.
shop.phone	Kauppasi puhelinnumero.
subtotal_price	Tilauksen rivinkohtien hintojen summa sen jälkeen, kun rivialennus tai ostoskorisalennus on vähennetty. Välisumma ei sisällä veroja (elleivät verot sisälly hintoihin) tai toimituskuluja.
discounts	Luettelo alennuksista.
discounts_amount	Kaikkiin alennuksiin sovellettu alennussumma (esim. +5,00 $).
discounts_savings	Kaikkien alennuksien aiheuttamat säästöt (esim. -5,00 $).
total_price	Tilauksen kokonaissumma (välisumma + toimituskulut-toimitusalennus + vero).
financial_status	Tämänhetkinen maksun tila. Yksi seuraavista: nolla, "odottava", "valtuutettu", "maksettu", "mitätöity", "palautettu".
requires_shipping	(totuusarvo) Palauttaa arvon tosi, jos tilauksessa on vähintään yksi tuote, joka edellyttää toimitusta.
shipping_method.title	Toimituskulun nimi, esimerkiksi "Vakiotoimitus".
shipping_method.price	Toimitushinta, joka sisältää mahdollisen toimitusalennuksen. Esimerkki:{{ shipping_method.price | money }}
shipping_price	Toimitushinta. Esimerkki:{{ shipping_price | money }}
shipping_address	Toimitusosoite.
shipping_address.first_name	Etunimi toimitusosoitteessa.
shipping_address.company	Yrityksen nimi toimitusosoitteessa.
shipping_address.phone	Puhelinnumero toimitusosoitteesta.
line_items	Luettelo tilauksen kaikista rivikohdista.
item_count	Kaikkien tuotteiden määrien summa.
fulfillment_status	Huolinnan tämänhetkinen tila: huolitsematta, osittain huolittu. huolittu
note	Tilaukseen liitetty huomautus. Huomautus voidaan hankkia asiakkaalta ja/tai sitä voidaan muokata hallintakäyttöliittymän tilaustietonäytössä.
attributes	Kaikki tilaukseen liitetyt ominaisuudet . Esimerkki:{{ attributes.gift-note }}
referring_site	Sisältää sen suosittelijan URL-osoitteen, joka toi asiakkaan kauppaan. Esimerkki:https://www.google.com/?s=great+products
landing_site	Sisältää asiakkaan käyttämän saapumissivun polun. Tämä on ensimmäinen sivu, jonka asiakas näki saavuttuaan kauppaan. Esimerkki: /products/great-product?ref=my-tracking-token
landing_site_ref	Katsoo saapumissivua ja poimii siitä viiteparametrin. Viiteparametrit voivat olla:, ref source , r . Jos landing_site-saapumissivu oli /products/great-product?ref=my-tracking-token, landing_site_ref on my-tracking-token . Voit toteuttaa tietyn toiminnon, jos viite on yhtä kuin tietty arvo: {% if landing_site_ref == 'my-tracking-token' %} Toimintani... {% endif %}
cancelled	(totuusarvo) Palauttaa arvon tosi, jos tilaus on peruutettu.
cancelled_at	Aika, jolloin tilaus on peruutettu.
cancel_reason	Syy, joka on valittu tilausta peruttaessa. Yksi seuraavista: "varasto", "asiakas", "petos", "muu".
has_high_risks?	Palauttaa arvon tosi, jos tilauksessa on suuri riski
translate="no" unique_gateways	Palauttaa luettelon tilauksen yksilöllisistä maksupalvelujen tarjoajista. Jos esimerkiksi joku maksaisi Visalla, Mastercardilla ja käteisellä, palautettava luettelo olisi shopify_payments, cash .
location (POS only)	Näyttää tilauksen fyysisen sijainnin. Käytettävissä on useita sijaintiominaisuuksia, ja ne on lueteltu täällä. Voit määrittää sijainteja hallinnan Sijainnit-alueella.
order_status_url	Palauttaa linkin tilauksen tila -sivulle.
fulfilled_line_items (vanhentunut)	Luettelo huolituista rivikohdista.
unfulfilled_line_items (vanhentunut)	Luettelo vain osittain huolituista rivikohdista.

Tilausluonnoksen ominaisuudet

Tilausluonnoksen ominaisuudet ovat käytettävissä Tilausluonnoksen lasku -sähköpostimallissa, joka ilmoittaa asiakkaille maksamattomista laskuista.

Huomautus

Tilaustilausluonnoksia ei voi lähettää tekstiviestillä.

Tilausluonnoksen ominaisuuksien kuvaus

Ominaisuus	Kuvaus
id	Yksilöllinen tilausluonnoksen tunnus sisäiseen käyttöön.
invoice_url	Linkki, jota asiakas voi seurata maksaakseen laskun Shopifyn suojattua maksua käyttämällä.
reserve_inventory_until	Päivämäärä ja kellonaika, johon asti luonnoksen rivikohdat varataan, esimerkiksi 2015-05-30T17:43:51+02:00. Voit muotoilla päivämääriä Liquid -päivämääräsuodattimen avulla.
user	Viimeinen tilausluonnosta muokannut henkilöstön jäsen.
user.name	Viimeisen tilausluonnosta muokanneen henkilöstön jäsenen nimi.
user.email	Viimeisen tilausluonnosta muokanneen henkilöstön jäsenen sähköpostiosoite.
email	Tilausluonnokseen liittyvä sähköpostiosoite.
name	Tilausluonnoksen ainutlaatuinen number-numero, jota edeltää ristikkomerkki # .
number	Tilausluonnoksen yksilöivä 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ä Liquid -päivämääräsuodattimen avulla.
tags	Palauttaa tilauksen kaikkien tunnisteiden joukon. Tunnisteet palautetaan aakkosjärjestyksessä. Katso lisätietoja Liquid-viitedokumentaatiostamme.
tax_price	Tilausluonnoksen kaikkien tuotteiden yhteenlasketut verot.
tax_lines	Verot verotustason mukaan eriteltynä: {% 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 desimaalimuodossa. Esimerkiksi 17,5 %:n verokanta palauttaa arvon 0.175 .
tax_line.rate_percentage	Verokanta prosenttimuodossa. Esimerkki rate-verkokanta 0,175 palauttaa 17.5 .
customer	Asiakasobjekti, joka sisältää asiakkaan tuotoksen ominaisuudet.
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	Laskutusosoitteen puhelinnumero.
shop.name	Kauppasi nimi.
shop.phone	Kauppasi puhelinnumero.
subtotal_price	Tilausluonnoksen rivinkohtien hintojen summa sen jälkeen, kun rivialennus tai ostoskorisalennus on vähennetty. Välisumma ei sisällä veroja (elleivät verot sisälly hintoihin) tai toimituskuluja.
discounts	Luettelo alennuksista.
discounts_amount	Kaikkiin alennuksiin sovellettu alennussumma (esim. +5,00 $).
discounts_savings	Kaikkien alennuksien aiheuttamat säästöt (esim. -5,00 $).
total_price	Tilauksen kokonaishinta (välisumma + toimituskulut - toimitusalennus + vero).
requires_shipping	Palauttaa arvon true, jos tilausluonnoksessa on vähintään yksi tuote, joka edellyttää toimitusta. Palauttaa arvon false, jos tilausluonnoksessa ei ole toimitusta vaativia tuotteita.
shipping_method.title	Toimituskulun nimi, esimerkiksi Vakiotoimitus .
shipping_method.price	Toimitustavan hinta. Palauttaa samat tiedot kuin shipping_price .
shipping_price	Toimitushinta. Voit muotoilla tämän summan Liquid-rahasuodattimienavulla.
shipping_address	Toimitusosoite. Huomautus: Tilausluonnoksen toimitusosoite voi olla puutteellinen toisin kuin tavallisissa tilauksissa.
shipping_address.first_name	Etunimi toimitusosoitteessa.
shipping_address.company	Yrityksen nimi toimitusosoitteessa.
shipping_address.phone	Toimitusosoitteen puhelinnumero.
line_items	Luettelo tilausluonnoksen kaikista rivikohdista.
item_count	Tilausluonnoksen kaikkien nimikemäärien summa.
note	Tilausluonnokseen liitetty huomautus. Huomautus voidaan hankkia asiakkaalta ja sitä voidaan myös muokata Shopify adminin tilausluonnoksen tietonäytössä.
location	Tilauksen fyysinen sijainti. Käytettävissä on useita sijaintiominaisuuksia. Voit määrittää sijainteja Shopify adminin Sijainnit-sivulla.

Rivikohdan ominaisuudet

Jokainen line_items-luettelon line-rivillä on seuraavat ominaisuudet:

Rivikohdan ominaisuuksien kuvaus

Ominaisuus	Kuvaus
line.applied_discounts (Vain POS ja tilausluonnokset)	Luettelo alennuksista, joita on sovellettu tähän kohteeseen (kullakin alennuksella on ominaisuudet title, code, amount, savings ja type [nimi, koodi, määrä, säästö ja tyyppi]).
line.custom (Vain tilausluonnokset)	(totuusarvo) Palauttaa arvon tosi, jos kohta on tilausluonnoksen mukautettu rivikohta.
line.grams	Yhden tuotteen paino.
line.image	Palauttaa tähän rivikohtaan liittyvän kuvan URL-osoitteen. Voit myös käyttää img_url-suodatinta saadaksesi tiettyjä kuvakokoja, esimerkiksi {{ line.image | img_url: 'small' }}
line.line_price	Hinta kerrottuna kyseisen tuotteen määrällä.
line.price	Yksittäisen tuotteen hinta.
line.properties	Palauttaa tuotteen mukautetun tiedon joukon. Asiakas määrittää rivikohdan ominaisuudet tuotesivulla, ennen kuin tuote lisätään ostoskoriin.
line.quantity	Kyseisen tuotteen määrä.
line.requires_shipping	(totuusarvo) Palauttaa arvon tosi, jos tuoteversiolle on tuotesivulla valittu valintaruutu Tämä on fyysinen tuote.
line.variant.sku	Tuotteeseen liitetty SKU.
line.taxable	(totuusarvo) Palauttaa arvon tosi, jos "Veloita vero tästä tuotteesta" -valintaruutu on valittuna tuoteversion tuotesivulla.
line.title	Tuotteen nimi, jota seuraa viiva ja version nimi. Version nimeä ei sisällytetä, kun se on "Default Title".
line.variant.barcode	Tuotteeseen liitetty viivakoodi.
line.variant.image	Tuoteversion kuva. Palauttaa kuvan vain, jos rivikohdan versiolle on määritetty tietty kuva.
line.product.vendor	Nimikkeen myyjä.

Palautusten ominaisuudet

Nämä lisäominaisuudet ovat käytettävissä Palautukset-sähköpostimallissa. Tätä sähköpostimallia käytetään ilmoittamaan asiakkaille, että heidän tilauksiinsa on sovellettu maksun palautusta (täydellistä tai osittaista). Voit käyttää Tilaussähköposti-ilmoitusmallin mitä tahansa muuttujaa seuraavien muuttujien lisäksi:

Hyvitysten ominaisuuksien kuvaus

Ominaisuus	Kuvaus
amount	Palautettu rahamäärä.
refund_line_items	Luettelo hyvitettävistä rivikohdista, Refund_line_items.

Refund_line_item-ominaisuudet

Hyvitettävien rivikohtien (refund_line_items ) luettelon jokaisella hyvitysrivillä (refund_line) on seuraavat ominaisuudet:

Hyvitysrivikohdan ominaisuuksien kuvaus

Ominaisuus	Kuvaus
refund_line.line_item	Hyvitettävä rivikohta (line_item). Tällä on pääsy kaikkiin rivikohdan (line_item) ominaisuuksiin.
refund_line.quantity	Korvattavan rivikohdan määrä.

Huolinnan ominaisuudet

Nämä lisäominaisuudet ovat käytettävissä Lähetysvahvistus-, Lähetyspäivitys - ja Huolintapyyntö-sähköpostimalleissa.

Lähetysvahvistusta ja lähetyspäivitystä käytetään ilmoittamaan asiakkaille, että jotkut tai kaikki heidän tilauksensa tuotteet on huolittu onnistuneesti tai että niiden lähetystiedot on päivitetty.

Huolintapyyntö-sähköpostimallia käytetään kaikkiin kaupan hallinnassa määriteltyihin mukautettuihin huolintapalveluihin. Jos haluat lisätä mukautetun huolintapalvelun, siirry kohtaan Asetukset > Toimitussivut ja selaa alaspäin "Huolinta/suoratoimitus"-osaan.

Huolinnan ominaisuuksien kuvaus

Ominaisuus	Kuvaus
service_name	Mukautetun palvelun nimi sellaisena kuin se on määritelty kohdassa Asetukset > Toimitussivu. (Vain huolintapyyntö)
fulfillment.estimated_delivery_at	Arvioitu toimituspäivä, joka perustuu jonkin seuraavista kuljetusliikkeistä tarjoamaan seurantanumeroon (jos käytössä): USPS, FedEx, UPS, Canada post (vain Kanada). Tämä ominaisuus on käytettävissä vain silloin, kun kuljetusliikkeen lasketut kulut ovat käytössä.
fulfillment.fulfillment_line_items	Luettelo huolittavista Fulfillment_line_items-huolintarivikohdista.
fulfillment.item_count	Kaikkien tuotteiden määrien summa. Huolittujen tuotteiden kokonaismäärä.
fulfillment.requires_shipping	(totuusarvo) Palauttaa arvon tosi, jos huolintapyyntö vaatii toimitusta.
fulfillment.tracking_company	Seurantaa tekevä yritys.
fulfillment.tracking_numbers	Seurantanumeroiden luettelo.
fulfillment.tracking_urls	Luettelo seurannan URL-osoitteista.
items_to_fulfill (vanhentunut)	Luettelo rivikohdista, jotka tämän tietyn mukautetun huolintapalvelun on täytettävä. (Vain huolintapyyntö)
items_to_fulfill_count (vanhentunut)	Tämän pyynnön huolittavien tuotteiden kokonaismäärä. (Vain huolintapyyntö)

Fulfillment_line_item-attribuutin ominaisuudet

Jokaisella fulfillment_line_items-attribuutin fulfillment_linella on seuraavat ominaisuudet:

Huolintarivikohdan ominaisuuksien kuvaus

Ominaisuus	Kuvaus
fulfillment_line.line_item	Huolittava line_item. Tällä on pääsy kaikkiin line_item-ominaisuuksiin.
fulfillment_line.quantity	Huolittavan rivikohdan määrä.

Alennuksen ominaisuudet

Alennuksen ominaisuuksien kuvaus

Ominaisuus	Kuvaus
discounts.first.code	Koodi, jonka asiakas syöttää saadakseen alennuksen. On lisättävä silmukkaan, jos haluat sallia useita alennuskoodeja.
discounts.first.amount	Määrä, jolla kokonaistilausta on alennettu.
discounts.first.savings	Asiakkaan alennuskoodin vuoksi säästämä rahamäärä.
discounts.first.type	Alennuksen tyyppi (FixedAmountDiscount, PercentageDiscount tai ShippingDiscount [kiinteä alennus, prosentuaalinen alennus tai toimitusalennus).

Sähköposti-ilmoituksen ominaisuudet

Sähköposti-ilmoituksen ominaisuuksien kuvaus

Ominaisuus	Kuvaus
shop.email_logo_url	Hallinnan Mukauta sähköpostimallit -osassa määritetyn logon URL-osoite.
shop.email_logo_width	Logon leveys (pikseleinä), joka on määritetty hallinnan Mukauta sähköpostimallit -osassa.
shop.email_accent_color	Hallinnan Mukauta sähköpostimallit -osassa määritetyn korostusvärin HEX-koodi.