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ä tai voit palkata Shopify Expert -asiantuntijan tekemään mukautukset puolestasi.

Tässä on luettelo Liquid-ilmoitusmalleista, joita voit muokata Shopify-ylläpitäjässä:

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

Kaikilla Shopify-ylläpitäjän malleilla on pääsy vastaavien tilauksien 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
• Jakelupyyntö

Huomaa: Toisin kuin useimmat muut Liquid-objektit, tilausobjektiin ei viitata nimellä sähköpostimalleissa. Sen sijaan, että käyttäisit tilausvahvistuksen sähköpostimallissa {{ order.shipping_method.title }} -koodia, käytä {{ shipping_method.title }} -koodia. 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. Seuraavan esimerkin avulla voit luoda tilaukselle linkin kaupan ylläpito-osiossa. Voit esimerkiksi lisätä Uusi tilaus -mallipohjaan seuraavan koodin: <a href="{{ shop.url }}/admin/orders/{{ id }}">View order</a>
email	Tilaukseen liittyvä sähköposti.
name	Yleensä tämä on punnan symboli, jota seuraa order_number. Esimerkiksi #1004
order_name	Sama kuin nimi.
order_number	Kaupan yksilöllinen tilausnumero ilman ristikkomerkkietuliitettä (#) tai mitä tahansa kaupan omistajan kaupan asetuksissa tilaustunnukseen lisäämää liitettä. Esimerkiksi 1004
created_at	Päivämäärä ja kellonaika, jolloin asiakas loi tilauksen. Voit muotoilla tätä käyttämällä päivämääräsuodatinta. Esimerkiksi 2009-05-30T17:43:51+02:00
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 eriteltyinä 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. 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), toimituskuluja tai tippejä.
discounts	Luettelo alennuksista.
discounts_amount	Kaikissa alennuksissa käytettävä alennuksen määrä. Esimerkiksi +5,00 $
discounts_savings	Alennuksien ansiosta säästetty summa. Esimerkiksi -5,00 $
total_price	Tilauksen kokonaissumma (välisumma + toimituskulut-toimitusalennus + vero).
financial_status	Tämänhetkisen maksun tila: ei mitään, odottaa, valtuutettu, maksettu, mitätöity, hyvitetty .
requires_shipping	(totuusarvo) Palauttaa arvon tosi, jos tilauksessa on vähintään yksi tuote, joka edellyttää toimitusta.
shipping_method.title	Toimituskulun nimi. Esimerkiksi Standard-toimitus
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	Tilauksen tämänhetkinen jakelun tila: ei jaeltu, osittainen, jaeltu.
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 on /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	Tilauksen peruuttamisen yhteydessä valittu syy. Valitse yksi seuraavista: varasto, asiakas, hylätty, petos tai 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 ylläpitäjän Sijainnit-alueella.
order_status_url	Palauttaa linkin tilauksen tila -sivulle.
fulfilled_line_items (vanhentunut)	Luettelo jaelluista rivikohdista.
unfulfilled_line_items (vanhentunut)	Luettelo vain osittain jaelluista 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 verotyypin mukaan eriteltyinä: {% 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	Kaikissa alennuksissa käytettävä alennuksen määrä. Esimerkiksi +5,00 $
discounts_savings	Alennuksien ansiosta säästetty summa. Esimerkiksi -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 Standard-toimitus
shipping_method.price	Toimitustavan hinta. Palauttaa samat tiedot kuin shipping_price .
shipping_price	Toimitushinta. Voit muotoilla tämän summan Liquid-rahasuodattimien avulla.
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

Luetteloiden line_items tai subtotal_line_items jokainen line omistaa seuraavat ominaisuudet.

Vihje

subtotal_line_items palauttaa rivikohdat, joita käytetään tilauksen välisumman laskemiseen. subtotal_line_items ei koske tippauksen rivikohtaa.

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, kuten {{ line.image | img_url: 'small' }}
line.line_price	Hinta kerrottuna kyseisen tuotteen määrällä.
line.original_line_price	Riviin sisältyvien tuotteiden määrän yhdistetty hinta ennen alennuksia.
line.final_line_price	Rivikohdan kaikkien tuotteiden yhdistetty hinta sisältäen kaikki alennussummat rivikohdan tasolla.
line.price	Yksittäisen tuotteen hinta.
line.product.title	Tuotteen nimi.
line.product.vendor	Tuotteen myyjä.
line.properties	Palauttaa tuotteen mukautettujen tietojen 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.selling_plan_allocation	Palauttaa selling_plan_allocation-objektin, joka kuvaa, miten tilauksen kaltainen myyntisopimus vaikuttaa rivikohtaan.
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.url	Rivikohdan version suhteellinen URL-osoite. Suhteellinen URL ei sisällä kaupan pääkansion URL-osoitetta (mystore.myshopify.com).
line.variant.barcode	Tuoteversioon liitetty viivakoodi.
line.variant.compare_at_price	Tuoteversioon liitetty vertailuhinta.
line.variant.image	Tuoteversion kuva. Palauttaa kuvan vain, jos rivikohdan versiolle on määritetty tietty kuva.
line.variant.sku	Tuoteversioon liitetty SKU-koodi.
line.variant.title	Version vaihtoehdon arvot, jotka ovat yhdistetty / merkeillä. Esimerkiksi small/punainen

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ä palautusnimikkeistä.

Refund_line_item-ominaisuudet

Jokainen refund_line_items-luettelon refund_line-rivillä 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ä.

Jakelun ominaisuudet

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

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

Jakelupyyntö-sähköpostimallia käytetään kaikkiin kaupan hallinnassa määriteltyihin mukautettuihin jakelupalveluihin. Jos haluat lisätä mukautetun jakelupalvelun, siirry kohtaan Asetukset > Toimitus ja vieritä alas kohtaan Jakelu/suoratoimitus.

Jakelun 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 jaeltavista jakelun rivikohdista.
fulfillment.item_count	Kaikkien tuotteiden määrien summa. jaeltujen tuotteiden kokonaismäärä.
fulfillment.requires_shipping	(totuusarvo) Palauttaa arvon tosi, jos jakelupyyntö 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 tietty mukautettu jakelupalvelu jakelee. (Vain jakelupyyntö)
items_to_fulfill_count (vanhentunut)	Tämän pyynnön huolittavien tuotteiden kokonaismäärä. (Vain jakelupyyntö)

Fulfillment_line_item-attribuutin ominaisuudet

Luettelon fulfillment_line_items jokainen fulfillment_line omistaa seuraavat ominaisuudet.

Jakelurivikohdan 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ä.

Toimituksen ominaisuudet

Toimituksen ominaisuuksien kuvaus

Ominaisuus	Kuvaus
delivery_instructions	Asiakkaille näytettävät paikallisen toimituksen tiedot. Näitä tietoja hallinnoidaan paikallisten toimitusasetusten Toimitustiedot-kentän kautta.

Alennuksen ominaisuudet

Alennuksen ominaisuuksia on kahdenlaisia.

discount_applications kuvaa, miksi ja miten tuote alennettiin.

discount_allocations kuvaa, miten tietty alennus vaikuttaa rivikohtaan ja miten se alentaa hintaa. Sinun pitää käyttää tätä ominaisuutta rivikohdan tasolla.

Voit yhdistää nämä ominaisuudet näyttämään alennustiedot rivikohdan tai tilauksen tasolla.

Esimerkki

Tässä esimerkissä tarkistetaan, sovelletaanko rivikohtaan alennusta. Jos alennusta ei ole sovellettu tilauksen tasolla (all), alennuksen nimi ja määrä tulevat näkyviin.

{% 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 näyttää tältä:

SPRING5 (-$5.00)

Alennuksen kohdistamisen ominaisuudet

Luettelon discount_allocations jokainen discount_allocation omistaa seuraavat ominaisuudet.

Alennuksen kohdistamisen ominaisuuksien kuvaus

Ominaisuus	Kuvaus
discount_allocation.amount	Asiakkaan rivikohdassa säästämä rahasumma. On lisättävä silmukkaan, jos haluat sallia useita alennuskoodeja.
discount_allocation.discount_application	Alennushakemus, joka kohdentaa summan rivikohtaan.

Alennushakemuksen ominaisuuksien kuvaus

Luettelon discount_applications jokainen discount_application omistaa seuraavat ominaisuudet.

Alennushakemuksen ominaisuuksien kuvaus

Ominaisuus	Kuvaus
discount_application.target_selection	Kuvaa, miten alennus valitsee alennettavia rivikohtia ostoskoriin all: Alennus koskee kaikkia rivikohtia. entitled: Alennus koskee tiettyä rivikohtien joukkoa, joka on usein määritelty ehtoa käyttämällä. explicit: Alennus koskee tiettyä valittua rivikohtaa tai toimitusta.
discount_application.target_type	Tuotetyyppi, jota alennus koskee (line_item tai shipping_line).
discount_application.title	Asiakkaalle näkyvä alennuksen nimi. Esimerkiksi Welcome10 tai CBBWQQAKYBYY
discount_application.total_allocated_amount	Kokonaissumma, joka vähennetään tilauksen hinnasta.
discount_application.type	Alennuksen tyyppi. Valitse yksi seuraavista: automaattinen, alennuskoodi, manuaalinen tai komento.
discount_application.value	Alennuksen arvo.
discount_application.value_type	Alennuksen arvotyyppi. Valitse yksi seuraavista: kiinteä_summa tai prosenttiosuus.

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.