Referenca spremenljivk za obvestila

Obvestila, poslana iz vaše trgovine, so izpisana z uporabo jezika Liquid. Liquid je preprost programski jezik družbe Shopify, ki je enostaven za uporabo. Na istem programskem jeziku temeljijo teme iz tržnice Theme Store.

Če želite urediti obvestila, ki se pošiljajo iz vaše trgovine, lahko osnovno prilagodite predloge obvestil. Za dostop do celotnega seznama obvestil, ki jih lahko prilagodite, odprite stran Obvestila v skrbniku Shopify.

Za pomoč pri naprednejših spremembah ali pri spremembah predlog obvestil po meri se lahko obrnete na skupnost na naših forumih ali pa zaposlite partnerja Shopify Partner, ki bo prilagoditve opravil namesto vas. Več informacij o zaposlitvi partnerja Shopify Partner.

Lastnosti naročila

Veliko lastnosti naročila je neposredno na voljo prek jezika Liquid in v predlogah.

Opisi lastnosti jezika Liquid, ki jih lahko uporabite z objektom naročila v predlogah obvestil
LastnostOpis
id

Sistemsko enoličen ID naročila za notranjo uporabo. Naslednji primer uporabite, če želite ustvariti povezavo do naročila v skrbniškem delu trgovine. Na primer, v predlogi Novo naročilo lahko dodate naslednjo kodo:

Ogled naročila
emailE-pošta, povezana z naročilom.
name

Običajno je to znak lora (#), ki mu sledi order_number.

Primer: #1004

order_nameIsto kot ime.
order_number

Enolična številka naročila v trgovini, brez predpone z znakom lora (#) in vseh predpon ter pripon, ki jih je ID-ju naročila dodal lastnik trgovine v nastavitvah svoje trgovine.

Primer: 1004

confirmation_number

Naključno ustvarjena alfanumerična oznaka naročila, ki bo stranki morda prikazana namesto zaporednega imena naročila. Ta vrednost ni nujno enolična.

Primer: XPAV284CT

created_at

Datum in čas, ko je stranka ustvarila naročilo. To lahko oblikujete z uporabo filtra za datum.

Primer: 2009-05-30T17:43:51+02:00

payment_terms

Plačilni pogoji določajo datum, do katerega je treba plačati naročilo.

Preberite, kako lahko na račune za naročila dodate plačilne pogoje.

Za več podrobnosti si oglejte referenco Liquid za payment_terms.

destinationDestinacija, kamor je treba poslati kose.
tagsVrne polje vseh oznak naročila. Oznake so vrnjene v abecednem vrstnem redu. Oznake, ki jih aplikacije ali funkcije platforme dinamično uporabljajo, kot je na primer oznaka Shopify Collective, pri ustvarjanju e-poštnega obvestila morda ne bodo na voljo. Če želite zaznati kose na podlagi določene funkcije, raje preverite oznake na ravni izdelka pri posamezni postavki. Za več podrobnosti si oglejte referenčno dokumentacijo Liquid.
transactionsVrne polje transakcij iz naročila.
tax_priceSkupni davki vseh kosov v naročilu.
tax_lines

Davki, razdeljeni po vrsti obdavčitve:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }} %) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.titleIme davka. Na primer QST ali DDV.
tax_line.priceZnesek davka.
tax_line.rateDavčna stopnja kot decimalno število. Vrne 0.175, če je stopnja 17,5 %.
tax_line.rate_percentageDavčna stopnja v človeku berljivi obliki. Vrne 17.5, če je stopnja 0.175.
customerObjekt stranke, ki vsebuje lastnosti izpisa za stranko.
billing_addressNaslov za izdajo računa.
billing_address.first_nameIme stranke.
billing_address.last_namePriimek stranke.
billing_address.companyIme podjetja za izdajo računa.
billing_address.phoneTelefonska številka iz naslova za izdajo računa.
shop.nameIme vaše trgovine.
shop.phoneTelefonska številka vaše trgovine.
subtotal_priceVsota cen postavk naročila po odštetju morebitnih popustov na postavko ali popustov v košarici. Vmesni seštevek ne vključuje davkov (razen če so davki vključeni v ceno), stroškov pošiljanja ali napitnin.
discountsSeznam popustov.
discounts_amount

Znesek popusta, uveljavljen z vsemi popusti.

Primer: +5,00 $

discounts_savings

Znesek prihranka, ki nastane zaradi vseh popustov.

Primer: -5,00 $

total_price

Skupni znesek naročila (vmesni seštevek + stroški pošiljanja - popust pri pošiljanju + davek).

financial_statusTrenutni status plačila. Ena od naslednjih vrednosti: »nil«, pending, authorized, paid, voided, refunded.
requires_shipping(logična vrednost) Vrne »true«, če je v naročilu vsaj en kos, ki zahteva dostavo.
shipping_method.title

Ime poštnine.

V obvestilih za stranke je ime poštnine prevedeno v jezik, v katerem je stranka zaključila nakup, če se ta jezik razlikuje od privzetega jezika trgovine.

Primer: Standardna dostava
shipping_method.price

Cena dostave, vključno z morebitnimi popusti pri pošiljanju.

Primer: {{ shipping_method.price | money }}

shipping_price

Cena pošiljanja.

Primer: {{ shipping_price | money }}

shipping_addressNaslov za dostavo.
shipping_address.first_nameIme za naslov za dostavo.
shipping_address.companyIme podjetja za naslov za dostavo.
shipping_address.phoneTelefonska številka iz naslova za dostavo.
line_itemsSeznam vseh postavk v naročilu.
line_items_including_zero_quantitySeznam vseh postavk v naročilu, vključno s tistimi s količino nič. Postavke imajo količino nič, ko je zanje v celoti izvedeno vračilo denarja.
line_item_groups(Orders and POS only)Seznam vseh skupin postavk, ki vsebujejo komponente postavk v naročilu.
item_countVsota količin vseh kosov.
fulfillment_statusTrenutno stanje izpolnitve naročila. Ena od naslednjih vrednosti: unfulfilled, partial, fulfilled.
noteOpomba, ki je priložena naročilu. Opombo lahko pridobite od stranke in/ali uredite na zaslonu s podatki o naročilu v skrbniškem vmesniku.
attributes

Vsi atributi, ki so bili dodani naročilu.

Primer: {{ attributes.gift-note }}

metafields

Vsa metapolja v naročilu. Uporabite naslednjo sintakso:

metafields.NAMESPACE.KEY

referring_site

Vsebuje URL napotitvenega vira, ki je stranko pripeljal v vašo trgovino.

Primer: https://www.google.com/?s=great+products

landing_site

Vsebuje pot pristajalne strani, ki jo je uporabila stranka. To je prva stran, ki jo je stranka videla, ko je prispela v trgovino.

Primer: /products/great-product?ref=my-tracking-token

landing_site_ref

Pregleda pristajalno stran in iz nje izlušči referenčni parameter. Referenčni parametri so lahko: ref, source, r.

Če je landing_site /products/great-product?ref=my-tracking-token, je landing_site_ref enak my-tracking-token. Izvedete lahko določeno dejanje, če je vaš referenčni parameter enak določeni vrednosti:

{% if landing_site_ref == 'my-tracking-token' %} Moje dejanje … {% endif %}
cancelled(logična vrednost) Vrne »true«, če je bilo naročilo preklicano.
cancelled_atČas preklica naročila.
cancel_reasonRazlog, izbran ob preklicu naročila. Ena od naslednjih vrednosti: inventory, customer, declined, fraud ali other.
has_high_risks?(deprecated)

Vrne »true«, če je naročilo visoko tvegano

unique_gateways

Vrne seznam edinstvenih ponudnikov plačilnih storitev za naročilo. Če je nekdo na primer plačal s kartico Visa, Mastercard in gotovino, bi bil vrnjeni seznam shopify_payments, cash.

location(POS only)

Prikaže fizično lokacijo naročila. Na voljo je več lastnosti lokacije, ki so navedene tukaj. Lokacije lahko konfigurirate v razdelku »Lokacije« v skrbniški plošči.

order_status_url

Vrne povezavo do strani stanja naročila za to naročilo.

fulfilled_line_items(deprecated)Seznam postavk, ki so bile izpolnjene.
unfulfilled_line_items(deprecated)Seznam postavk, ki še niso bile v celoti izpolnjene.
b2b?

Vrne »true«, če je naročilo naročilo B2B. Uporabite to lastnost s spremenljivkami B2B za prikaz ustreznih informacij, kot so ime podjetja, lokacija podjetja in naslov v e-poštnih sporočilih. Pri naročilih B2B lahko na primer dodate glavo v predlogo z naslednjimi informacijami:

{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company

Podjetje, ki mu prodajate pri naročilu B2B.

company.name

Ime podjetja pri naročilu B2B.

company.id

ID podjetja pri naročilu B2B.

company_location

Lokacija podjetja pri naročilu B2B. Podjetje, ki kupuje pri vas, ima lahko več kot eno lokacijo.

company_location.name

Ime lokacije podjetja pri naročilu B2B.

company_location.id

Številka ID lokacije podjetja pri naročilu B2B.

company_location.shipping_address

Naslov za dostavo lokacije podjetja pri naročilu B2B.

company_location.billing_address

Naslov za izstavitev računa lokacije podjetja pri naročilu B2B.

customer_order_url

Nova stran stanja naročila za naročilo, za katero je stranka zahtevala vračilo z uporabo računov strank.

Lastnosti osnutka naročila

Opisi lastnosti za Liquid, ki jih lahko uporabite s predmetom osnutka naročila v predlogah obvestil
LastnostOpis
idEdinstven ID osnutka naročila za interno uporabo.
invoice_urlPovezava, na kateri lahko stranka plača račun s Shopifyjevo varno blagajno.
reserve_inventory_until

Datum in čas, do katerega so postavke v osnutku rezervirane, na primer 2015-05-30T17:43:51+02:00.

Datume lahko formatirate s filtrom datumov za Liquid.

userZadnji član osebja, ki je spremenil osnutek naročila.
user.nameIme zadnjega člana osebja, ki je spremenil osnutek naročila.
user.emailE-poštni naslov zadnjega člana osebja, ki je spremenil osnutek naročila.
emailE-poštni naslov, povezan z osnutkom naročila.
nameEdinstven number osnutka naročila s predpono v obliki znaka za številko #.
numberEdinstvena številka osnutka naročila brez predpone ali pripone naročila.
created_at

Datum in ura, ko je stranka ustvarila osnutek naročila, na primer 2009-05-30T17:43:51+02:00.

Datume lahko formatirate s filtrom datumov za Liquid.

tagsVrne polje vseh oznak naročila. Oznake so vrnjene v abecednem vrstnem redu. Za več podrobnosti glejte referenčno dokumentacijo Liquid.
tax_priceSkupni davki vseh kosov v osnutku naročila.
tax_lines

Davki, razdeljeni po vrsti davka:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title

Ime davka.

Primera: QST ali DDV

tax_line.priceZnesek davka.
tax_line.rateDavčna stopnja v decimalni obliki. Na primer, pri davčni stopnji 17,5 % bo vrnjeno 0.175.
tax_line.rate_percentageDavčna stopnja v odstotkih. Na primer, za rate 0,175 bo vrnjeno 17.5.
customerObjekt stranke, ki vsebuje lastnosti izpisa za stranko.
billing_addressNaslov za izdajo računa za osnutek naročila.
billing_address.first_nameIme stranke.
billing_address.last_namePriimek stranke.
billing_address.companyIme podjetja na naslovu za izdajo računa.
billing_address.phoneTelefonska številka na naslovu za izdajo računa.
shop.nameIme vaše trgovine.
shop.phoneTelefonska številka vaše trgovine.
subtotal_priceVsota cen postavk osnutka naročila po odštetju morebitnega popusta na postavko ali popusta na košarico. Vmesni seštevek ne vključuje davkov (razen če so davki že vključeni v cene) ali stroškov pošiljanja.
discountsSeznam popustov.
discounts_amount

Znesek popusta, ki se uveljavi z vsemi popusti.

Primer: +5,00 $

discounts_savings

Znesek prihranka zaradi vseh popustov.

Primer: -5,00 $

total_priceSkupna cena naročila (vmesni seštevek + stroški pošiljanja - popust pri pošiljanju + davek).
amount_due_now

Znesek, zahtevan na računu za osnutek naročila.

requires_shippingVrne true , če je v osnutku naročila vsaj en kos, ki zahteva dostavo. Vrne false , če noben kos v osnutku naročila ne zahteva dostave.
shipping_method.title

Ime poštnine.

Primer: Standardna dostava

shipping_method.priceCena načina pošiljanja. Vrne iste informacije kot shipping_price.
shipping_price

Cena pošiljanja.

Ta znesek lahko oblikujete s filtri za denar Liquid.

shipping_address

Naslov za dostavo.

Opomba: Za razliko od rednih naročil je naslov za dostavo pri osnutku naročila lahko nepopoln.

shipping_address.first_nameIme za naslov za dostavo.
shipping_address.companyIme podjetja na naslovu za dostavo.
shipping_address.phoneTelefonska številka na naslovu za dostavo.
line_itemsSeznam vseh postavk v osnutku naročila.
item_countVsota količin vseh kosov v osnutku naročila.
noteOpomba, priložena osnutku naročila. Opombo lahko pridobite od stranke ali pa jo uredite na zaslonu s podrobnostmi o osnutku naročila v skrbniku Shopify.
metafields

Katera koli metapolja na osnutku naročila. Uporabite naslednjo sintakso:

metafields.NAMESPACE.KEY

location

Fizična lokacija naročila. Na voljo je več lastnosti lokacije.

Lokacije lahko konfigurirate na strani Lokacije v skrbniku Shopify.

b2b?

Vrne »true«, če je naročilo naročilo B2B. Uporabite to lastnost s spremenljivkami B2B za prikaz ustreznih informacij, kot so ime podjetja, lokacija podjetja in naslov v e-poštnih sporočilih. Pri naročilih B2B lahko na primer dodate glavo v predlogo z naslednjimi informacijami:

{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company

Podjetje, ki mu prodajate pri naročilu B2B.

company.name

Ime podjetja pri naročilu B2B.

company.id

ID podjetja pri naročilu B2B.

company_location

Lokacija podjetja pri naročilu B2B. Podjetje, ki kupuje pri vas, ima lahko več kot eno lokacijo.

company_location.name

Ime lokacije podjetja pri naročilu B2B.

company_location.id

Številka ID lokacije podjetja pri naročilu B2B.

company_location.shipping_address

Naslov za dostavo lokacije podjetja pri naročilu B2B.

company_location.billing_address

Naslov za izstavitev računa lokacije podjetja pri naročilu B2B.

payment_methods

Seznam shranjenih načinov plačila, ki so na voljo za obdelavo skupnega zneska osnutka.

payment_method.payment_instrument

Plačilni instrument, ki vsebuje podrobnosti o shranjenem načinu plačila.

payment_method.payment_instrument.payment_type

Vrsta shranjenega načina plačila. Npr. »credit_card, apple_pay«.

payment_method.payment_instrument.credit_card_brand

Blagovna znamka kartice, ko je vrednost `payment_type` »credit_card«.

payment_method.payment_instrument.credit_card_company

Izdajatelj kartice, ko je vrednost `payment_type` »credit_card«.

payment_method.payment_instrument.credit_card_company

Zadnje 4 števke kartice, ko je vrednost `payment_type` »credit_card«.

Lastnosti načrta plačil

Opisi lastnosti Liquid, ki jih lahko uporabite z objektom načrta plačil v predlogah obvestil.
LastnostOpis
payment_schedule.amount_due

Znesek za plačilo za načrt plačil.

Zneske z valutami lahko oblikujete s filtrom za denar Liquid.

payment_schedule.due_at

Rok plačila za načrt plačil.

Datume lahko formatirate s filtrom datumov za Liquid.

payment_schedule.due_in_days

Število dni do roka plačila, če načrt plačil še ni poravnan (neplačan).

payment_schedule.due_later?

Vrne »true«, če načrt plačil ni bil plačan in je njegov rok plačila v prihodnosti.

payment_schedule.number_of_days_overdue?

Število dni od roka plačila, ko je načrt plačil v zamudi.

payment_schedule.overdue?

Vrne »true«, če načrt plačil še ni bil plačan in je rok plačila že potekel.

Lastnosti stanja plačila

Opisi lastnosti Liquid, ki jih lahko uporabite z objektom stanja plačila v predlogah obvestil.
LastnostOpis
has_pending_payment

(Logična vrednost) Vrne »true«, če ima naročilo transakcijo s plačilom na čakanju.

Več informacij o plačilih na čakanju.

buyer_action_required

(Logična vrednost) Vrne »true«, če ima naročilo transakcijo s plačilom na čakanju in je za deblokado plačila potrebno dejanje kupca. Ko ta vrednost vrne »true« in način plačila podpira navodila za plačilo, buyer_pending_payment_instructions zagotovi podrobnosti, ki jih stranka lahko uporabi za dokončanje nakupa brez povezave.

Več informacij o objektu transakcije Liquid.

Lastnosti komponente paketa

Vsaka komponenta bundle_component na seznamu line_item.bundle_components ima naslednje lastnosti. (Samo za osnutke naročil)

Opisi lastnosti Liquid, ki jih lahko uporabite z objektom komponente paketa v predlogah obvestil.
LastnostOpis
bundle_component.image_urlURL slike komponente paketa.
bundle_component.product.titleNaslov izdelka komponente paketa.
bundle_component.quantityKoličina komponente paketa.
bundle_component.variant.title

Trenutna imena vrednosti možnosti različice komponente paketa, združena z znaki /.

Primer: majhna / rdeča

Lastnosti komponente

Vsaka komponenta na seznamu line_item.components ima naslednje lastnosti. (Samo pri zapuščeni blagajni) `

Opisi lastnosti Liquid, ki jih lahko uporabite z objektom komponente v predlogah obvestil
LastnostOpis
component.image_urlURL-naslov slike komponente.
component.product.titleNaslov izdelka komponente.
component.quantityKoličina za komponento.
component.variant.title

Trenutna imena vrednosti možnosti različice komponente, povezana z znaki /.

Primer: majhna / rdeča

Lastnosti postavke

Vsak element line na seznamu line_items ali subtotal_line_items ima naslednje lastnosti.

Opisi lastnosti Liquid, ki jih lahko uporabite z objektom postavke v predlogah obvestil
LastnostOpis
line.applied_discounts(POS and draft orders only)Seznam popustov, uporabljenih za ta kos (vsak popust ima lastnosti title, code, amount, savings in type).
line.bundle_components(Draft orders only)Seznam postavk, ki so komponente paketa tega kosa. Seznam vrne le, če je ta postavka izdelek v paketu.
line.bundle_parent?(Draft orders only)(logična vrednost) Vrne vrednost »true«, če je postavka izdelek v paketu.
line.components(Abandoned checkout only)Seznam postavk, ki so komponente tega kosa.
line.parent?(Abandoned checkout only)(logična vrednost) Vrne vrednost »true«, če ima postavka komponente.
line.custom(Draft orders only)(logična vrednost) Vrne vrednost »true«, če je kos postavka po meri za osnutek naročila.
line.delivery_agreementPogodba o dostavi, povezana s to postavko.
line.gramsTeža posameznega kosa.
line.groupsSkupina postavk kosa.
line.imageVrne URL-naslov slike, povezane s to postavko. Za pridobivanje določenih velikosti slik lahko uporabite tudi filter img_url, na primer {{ line.image | img_url: 'small' }}
line.line_priceCena, pomnožena s količino za ta kos.
line.original_line_priceSkupna cena količine kosov, vključenih v postavko, pred uporabo popustov.
line.final_line_priceSkupna cena vseh kosov v postavki, vključno z vsemi zneski popustov na ravni postavke.
line.pre_tax_priceCena pred obdavčitvijo za postavke, pomnožena s kupljeno količino postavke.
line.priceCena za posamezni kos.
line.product.metafields

Katera koli metapolja na ravni izdelka. Uporabite naslednjo sintakso:

line.product.metafields.NAMESPACE.KEY

line.product.titleTrenutno ime izdelka.
line.product.vendorProdajalec kosa.
line.propertiesVrne polje informacij po meri za kos. Lastnosti postavke določi stranka na strani izdelka pred dodajanjem izdelka v košarico.
line.quantityKoličina za ta kos.
line.current_quantityTrenutna količina kosa po odstranitvah.
line.requires_shipping(logična vrednost) Vrne vrednost »true«, če ima različica za kos na strani izdelka aktivirano nastavitev Fizični izdelek.
line.selling_plan_allocationVrne objekt selling_plan_allocation, ki opisuje, kako prodajni načrt, kot je naročnina, vpliva na postavko.
line.taxable(logična vrednost) Vrne vrednost »true«, če ima različica za kos na strani izdelka obkljukano potrditveno polje »Obračunaj davek za ta izdelek«.
line.title

Ime izdelka v času prodaje, ki mu sledita pomišljaj in ime različice v času prodaje. Ime različice ni vključeno, če gre za »Privzeti naslov«.

V obvestilih za stranke sta ime izdelka in ime različice prevedena v jezik, v katerem je stranka zaključila nakup, če se ta jezik razlikuje od privzetega jezika trgovine.
line.urlRelativni URL-naslov različice postavke. Relativni URL-naslov ne vključuje korenskega URL-naslova vaše trgovine (mystore.myshopify.com).
line.variant.barcodeČrtna koda, povezana z različico izdelka.
line.variant.compare_at_pricePrimerjalna cena, povezana z različico izdelka.
line.variant.imageSlika za različico izdelka. Sliko vrne samo, če je različici v postavki dodeljena določena slika.
line.variant.metafields

Katera koli metapolja na ravni različice. Uporabite naslednjo sintakso:

line.variant.metafields.NAMESPACE.KEY

line.variant.skuSKU, povezan z različico izdelka.
line.variant.title

Trenutna imena vrednosti možnosti različice, povezana z znaki /.

Primer: majhna / rdeča

line.refunded.quantity(within refund notifications)

Količina kosa za povračilo. To lastnost lahko uporabite za dodajanje oznake kosom s povrnjenimi sredstvi v naročilu.

Na primer: {% if line.refunded_quantity > 0 %}Oznaka postavke s povrnjenimi sredstvi{% endif %}

Zaznavanje kosov Shopify Collective v predlogah obvestil

Oznaka Shopify Collective je dodana naročilu, ko je e-poštno sporočilo s potrditvijo naročila poslano, zato vrednost {% if tags contains 'Shopify Collective' %} v predlogi potrditve naročila ni nikoli true. Za zaznavanje kosov Shopify Collective namesto tega preverite oznake na ravni izdelka za vsako postavko:

{% 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 %}

Lastnosti skupine postavk

Vsaka skupina postavk (line_item_group) na seznamu line_item_groups ima naslednje lastnosti.

Opisi lastnosti Liquid, ki jih lahko uporabite z objektom skupine postavk v predlogah obvestil
LastnostOpis
line_item_group.display_titleNaslov skupine postavk.
line_item_group.componentsSeznam komponent postavke, ki pripadajo skupini.
line_item_group.imageSlika skupine postavk.
line_item_group.product_idID izdelka skupine postavk.
line_item_group.variantObjekt različice skupine postavk.
line_item_group.variant_idIdentifikator različice skupine postavk.

Lastnosti povračil

Opisi lastnosti Liquid, ki jih lahko uporabite z objektom povračila v predlogah obvestil
LastnostOpis
amountZnesek povrnjenega denarja.
refund_line_itemsSeznam postavk povračila, ki bodo povrnjene.

Lastnosti postavke povračila (refund_line_item)

Vsaka postavka povračila (refund_line) na seznamu refund_line_items ima naslednje lastnosti:

Opisi lastnosti Liquid, ki jih lahko v predlogah za obvestila uporabite z objektom postavk za povračila
LastnostOpis
refund_line.line_itemPostavka line_item, za katero se izvaja povračilo. Omogoča dostop do vseh lastnosti elementa line_item.
refund_line.quantityKoličina postavke, za katero se izvaja povračilo.

Lastnosti izpolnitve

Opisi lastnosti Liquid, ki jih lahko v predlogah za obvestila uporabite z objektom izpolnitve
LastnostOpis
service_nameIme storitve po meri, kot je določeno na strani Nastavitve > Pošiljanje in dostava. (Samo zahteva za izpolnitev)
fulfillment.estimated_delivery_atOcenjen datum dostave na podlagi številke za sledenje (če je na voljo), ki jo zagotovi eden od naslednjih prevoznikov: USPS, FedEx, UPS ali Canada Post (samo za Kanado). Ta lastnost je na voljo samo, ko so v uporabi tarife, ki jih izračuna prevoznik.
fulfillment.fulfillment_line_itemsSeznam postavk za izpolnitev, ki bodo izpolnjene.
fulfillment.item_countVsota vseh količin kosov. Skupno število kosov, ki se izpolnjujejo.
fulfillment.requires_shipping(logična vrednost) Vrne »true«, če ta zahteva za izpolnitev zahteva dostavo.
fulfillment.tracking_companyPodjetje, ki izvaja sledenje.
fulfillment.tracking_numbersSeznam številk za sledenje.
fulfillment.tracking_urlsSeznam URL-naslovov za sledenje.
items_to_fulfill(deprecated)Seznam postavk, ki jih bo izpolnila določena storitev za izpolnjevanje naročil strank po meri. (Samo za zahtevo za izpolnitev)
items_to_fulfill_count(deprecated)Skupno število kosov, ki bodo izpolnjeni s to zahtevo. (Samo za zahtevo za izpolnitev)

Lastnosti za fulfillment_line_item

Vsak fulfillment_line na seznamu fulfillment_line_items ima naslednje lastnosti.

Opisi lastnosti Liquid, ki jih lahko v predlogah za obvestila uporabite z objektom postavk za izpolnitev
LastnostOpis
fulfillment_line.line_itemPostavka line_item, ki se izpolnjuje. Omogoča dostop do vseh lastnosti elementa line_item.
fulfillment_line.quantityKoličina postavke, ki se izpolnjuje.

Lastnosti pripravljenega paketa

Pripravljen paket vključuje kose, označene kot pripravljene na prevzem.

Opisi lastnosti Liquid, ki jih lahko v predlogah za obvestila uporabite z objektom pripravljenega paketa
LastnostOpis
item_countVsota vseh količin kosov v pripravljenem paketu.
prepared_package_line_itemsSeznam postavk pripravljenega paketa.

Lastnosti za prepared_package_line_item

Vsak prepared_package_line_item na seznamu prepared_package_line_items ima naslednje lastnosti.

Opisi lastnosti Liquid, ki jih lahko v predlogah za obvestila uporabite z objektom postavk pripravljenega paketa
LastnostOpis
line_itemPovezana postavka line_item. Omogoča dostop do vseh lastnosti elementa line_item.
quantityKoličina postavke, ki je bila označena kot pripravljena na prevzem.

Lastnosti dostave

Opisi lastnosti Liquid, ki jih lahko v predlogah za obvestila uporabite z objektom dostave
LastnostOpis
delivery_agreementsSeznam vseh sporazumov o dostavi za naročilo.
delivery_instructionsInformacije o lokalni dostavi, ki jih želite deliti s stranko. Te informacije se upravljajo v polju Informacije o dostavi v nastavitvah lokalne dostave.
consolidated_estimated_delivery_timeInformacije o datumih dostave naročila, ki jih želite deliti s stranko. Te informacije se upravljajo z nastavitvijo Čas obdelave, ki jo nastavite na strani Pošiljanje in dostava. Če ima naročilo več načinov dostave, je prikazan seznam načinov in datumov dostave.
has_multiple_delivery_methods(logična vrednost) Vrne »true«, če ima naročilo več načinov dostave.

Lastnosti sporazuma o dostavi

Opisi lastnosti Liquid, ki jih lahko v predlogah za obvestila uporabite z objektom sporazuma o dostavi
LastnostOpis
delivery_agreement.delivery_method_typeVrsta načina dostave.
delivery_agreement.delivery_method_nameVrsta načina dostave, prevedena v jezik, v katerem je kupec izvedel nakup na blagajni, če se jezik razlikuje od privzetega jezika trgovine.
delivery_agreement.line_item_groupsSeznam vseh skupin postavk, ki vsebujejo komponente postavk v svežnju znotraj sporazuma o dostavi.
delivery_agreement.line_itemsSeznam vseh postavk, povezanih s tem sporazumom o dostavi.

Lastnosti popusta

Obstajata dve vrsti lastnosti za popuste.

discount_applications opisujejo, zakaj in kako je bil uporabljen popust za kos.

discount_allocations opisujejo, kako določen popust vpliva na postavko in kako zniža ceno. To lastnost morate uporabiti na ravni postavke.

Ti dve lastnosti lahko kombinirate za prikaz informacij o popustu na ravni postavke ali naročila.

Primer

Ta primer preveri, ali je bil za postavko uporabljen popust. Če popust ni bil uporabljen na ravni naročila (all), se prikažeta ime popusta in znesek.

{% 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 %}

Rezultat je lahko podoben temu:

SPRING5 (-$5.00)

Lastnosti za discount_allocation

Vsak discount_allocation na seznamu discount_allocations ima naslednje lastnosti.

Opisi lastnosti Liquid, ki jih lahko v predlogah za obvestila uporabite z objektom discount_allocation
LastnostOpis
discount_allocation.amountZnesek, ki ga stranka prihrani pri postavki. Če želite omogočiti več kod za popust, mora biti vrednost vnesena v zanko.
discount_allocation.discount_applicationUporaba popusta, ki dodeli znesek na postavko.

Lastnosti za discount_application

Vsak discount_application na seznamu discount_applications ima naslednje lastnosti.

Opisi lastnosti Liquid, ki jih lahko v predlogah za obvestila uporabite z objektom discount_application
LastnostOpis
discount_application.target_selection

Opisuje, kako popust izbere postavke v košarici, na katere se bo nanašal popust. Ena od naslednjih možnosti:

  • all: Popust velja za vse postavke.
  • entitled: Popust velja za določeno podskupino postavk, ki jo pogosto določa določen pogoj.
  • explicit: Popust velja za določeno izbrano postavko ali vrstico s stroški pošiljanja.
discount_application.target_typeVrsta kosa, za katerega velja popust (line_item ali shipping_line).
discount_application.title

Ime popusta, ki je prikazano stranki.

Primeri: Welcome10 ali CBBWQQAKYBYY

discount_application.total_allocated_amountSkupni znesek, za katerega je cena naročila znižana zaradi popusta.
discount_application.typeVrsta popusta. Lahko je: automatic, discount_code, manual ali script.
discount_application.valueVrednost popusta.
discount_application.value_typeVrsta vrednosti popusta. Lahko je: fixed_amount ali percentage.

Lastnosti naročnine

Podrobnosti pogodbe o naročnini, trenutno obračunsko obdobje in njegove postavke, način dostave in način plačila so na voljo za vse predloge e-pošte za naročnine.

Če želite urediti predloge za obvestila o naročnini, namestite aplikacijo Shopify Subscriptions in nato poiščite predlogo pod Nastavitve > Obvestila v razdelku Naročnine.

Lastnosti obračunskega cikla pogodbe o naročnini

Če želite dostopati do lastnosti pogodbe o naročnini in njenega obračunskega cikla, uporabite objekt subscription_contract_billing_cycle.

Primer

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

Rezultat:

This contract is currently paused.

Lastnosti

Opisi lastnosti jezika Liquid, ki jih lahko v predlogah obvestil uporabite z objektom obračunskega cikla pogodbe o naročnini
LastnostOpis
status Stanje pogodbe.

Lahko je active, paused, cancelled, failed, expired, stale,
delivery_method Način dostave za naročnino.

Če se naročnina nanaša na storitev ali digitalni izdelek, se vrne vrednost nil.
billing_frequencyKako pogosto se naročnina obračunava.
delivery_frequency Kako pogosto se naročnina dostavlja.
origin_order Prvotno naročilo, s katerim je bila ustvarjena naročnina.

Če naročnina ni bila ustvarjena iz naročila v storitvi Shopify, se vrne vrednost nil.
customerStranka naročnine.
line_items Postavke v obračunskem ciklu naročnine.
product_namesSeznam imen izdelkov, ki so vključeni v obračunski cikel naročnine.
update_payment_method_urlURL-naslov, ki ga lahko stranka uporabi za posodobitev načina plačila za to pogodbo.
shipping_address Naslov za dostavo za naročnino.

Če se naročnina nanaša na storitev ali digitalni izdelek, se vrne vrednost nil.
billing_addressNaslov za izdajo računa za naročnino.
subtotal_priceVmesni seštevek cene postavk naročnine.
shipping_priceCena dostave naročnine.
total_taxSkupni davek naročnine.
total_priceSkupna cena naročnine.
total_discountsSkupni popusti naročnine.
customer_self_serve_urlURL-naslov samopostrežnega portala, ki ga lahko stranka uporabi za upravljanje svojih naročnin.
billing_attempt_expected_dateDatum obračuna za ta obračunski cikel.
next_billing_dateNaslednji nepreskočeni datum obračuna po tem obračunskem ciklu.
last_attempted_billing_dateDatum zadnjega poskusa obračuna za obračunski cikel.
days_overdueŠtevilo dni zamude pri obračunu za ta obračunski cikel.
payment_instrumentPlačilno sredstvo, povezano s pogodbo o naročnini. To plačilno sredstvo se uporablja za obračunavanje stranki.

Lastnosti postavk pogodbe o naročnini

Lastnosti za vsako postavko, vključeno v obračunski cikel. Do lastnosti postavk pogodbe lahko dostopate prek nadrejene lastnosti subscription_contract_billing_cycle.line_items.

Primer

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}
Opisi lastnosti jezika Liquid, ki jih lahko v predlogah obvestil uporabite z objektom postavke pogodbe o naročnini
LastnostOpis
urlURL-naslov do strani s podrobnostmi o izdelku za različico izdelka v postavki.
requires_shippingAli postavka zahteva fizično dostavo.
unit_price_measurementMera cene na enoto postavke.
selling_plan_allocationDodelitev prodajnega načrta postavke.

Lastnosti načina dostave pogodbe o naročnini

Lastnosti za način dostave, ki se uporablja v tem obračunskem ciklu. Do lastnosti načina dostave lahko dostopate prek nadrejene lastnosti subscription_contract_billing_cycle.delivery_method.

Primer

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}
Opisi lastnosti jezika Liquid, ki jih lahko v predlogah obvestil uporabite z objektom načina dostave pogodbe o naročnini
LastnostOpis
titleNaslov možnosti dostave, povezane z načinom dostave.
type Vrsta načina dostave.

Lahko je shipping, local ali pick-up.

Lastnosti plačilnega sredstva pogodbe o naročnini

Podrobnosti o plačilnem sredstvu za pogodbo o naročnini. To plačilno sredstvo se uporablja za obračun stranki. Do lastnosti plačilnega sredstva lahko dostopate prek nadrejene lastnosti subscription_contract_billing_cycle.payment_instrument.

Primer

{% 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 }}
Opisi lastnosti jezika Liquid, ki jih lahko v predlogah obvestil uporabite z objektom plačilnega sredstva pogodbe o naročnini
LastnostOpis
payment_type Vrsta načina plačila, ki ga predstavlja plačilno sredstvo.

Za izpis URL-naslova slike ali SVG-ja uporabite filtre plačil.
credit_card_brandBlagovna znamka kreditne kartice.
credit_card_companyIme podjetja, ki je izdalo kreditno kartico.
credit_card_last_four_digitsZadnje 4 števke kreditne kartice.

Lastnosti e-poštnih obvestil

Opisi lastnosti jezika Liquid, ki jih lahko v predlogah obvestil uporabite z objektom e-poštnih obvestil
LastnostOpis
shop.email_logo_urlURL-naslov za logotip, določen v razdelku Prilagajanje predlog e-pošte v skrbniški plošči.
shop.email_logo_widthŠirina logotipa (v pikslih), določena v razdelku Prilagajanje predlog e-pošte v skrbniški plošči.
shop.email_accent_colorŠestnajstiška koda za barvo poudarkov, določena v razdelku Prilagajanje predlog e-pošte v skrbniški plošči.

Lastnosti dobroimetja za nakup

Lastnosti, ki vsebujejo podrobnosti o izdaji dobroimetja za nakup.

Opisi lastnosti jezika Liquid, ki jih lahko v predlogah obvestil uporabite z objektom izdanega dobroimetja za nakup
LastnostOpis
issued_store_credit.amount

Znesek izdanega dobroimetja za nakup.

Ta znesek lahko oblikujete s filtri za denar Liquid.

issued_store_credit.expires_at

Datum in čas poteka izdanega dobroimetja za nakup.

Ta znesek lahko oblikujete s filtri datumov za jezik Liquid.

issued_store_credit.balance_after_transaction

Stanje računa z dobroimetjem v trgovini po tem, ko je bilo dobroimetje izdano.

Ta znesek lahko oblikujete s filtri za denar Liquid.

customerObjekt stranke, ki vsebuje lastnosti izpisa za stranko.