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ä tavanomainenorder
.
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> |
Tilaukseen liittyvä sähköposti. | |
name |
Yleensä tämä on punnan symboli, jota seuraa 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:
|
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_price |
Toimitushinta. Esimerkki: |
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: |
referring_site |
Sisältää sen suosittelijan URL-osoitteen, joka toi asiakkaan kauppaan. Esimerkki: |
landing_site |
Sisältää asiakkaan käyttämän saapumissivun polun. Tämä on ensimmäinen sivu, jonka asiakas näki saavuttuaan kauppaan. Esimerkki: |
landing_site_ref |
Katsoo saapumissivua ja poimii siitä viiteparametrin. Viiteparametrit voivat olla:, Jos {% 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 |
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. |
|
Luettelo jaelluista rivikohdista. |
|
Luettelo vain osittain jaelluista rivikohdista. |
Tilausluonnoksen ominaisuudet
Tilausluonnoksen ominaisuudet ovat käytettävissä Tilausluonnoksen lasku -sähköpostimallissa, joka ilmoittaa asiakkaille maksamattomista laskuista.
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 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. |
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 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 |
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.
Ominaisuus | Kuvaus |
---|---|
|
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]). |
|
(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 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:
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:
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.
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. |
|
Luettelo rivikohdista, jotka tietty mukautettu jakelupalvelu jakelee. (Vain jakelupyyntö) |
|
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.
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
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.
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.
Ominaisuus | Kuvaus |
---|---|
discount_application.target_selection |
Kuvaa, miten alennus valitsee alennettavia rivikohtia ostoskoriin
|
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
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. |