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ö
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 kommentti. Kommentti voidaan saada asiakkaalta ja/tai sitä voidaan muokata ylläpidossa 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.

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 kommentti. Kommentti voidaan hankkia asiakkaalta ja sitä voidaan myös muokata Shopify-ylläpitäjän tilausluonnoksen tietonäytössä.
location

Tilauksen fyysinen sijainti. Käytettävissä on useita sijaintiominaisuuksia.

Voit määrittää sijainteja Shopify-ylläpitäjän Sijainnit-sivulla.

Rivikohdan ominaisuudet

Luetteloiden line_items tai subtotal_line_items jokainen line omistaa 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, 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.

Oletko valmis aloittamaan myynnin Shopifyssa?

Kokeile ilmaiseksi