Értesítési változók referenciája

Az üzletéből küldött értesítések renderelése Liquid használatával történik. A Liquid a Shopify egyszerű, könnyen használható programozási nyelve. Ugyanaz a programozási nyelv, amelyre a Témaáruházból származó témák is épülnek.

Az üzletéből küldött értesítések szerkesztéséhez alapvető testreszabásokat végezhet az értesítési sablonokon. Az összes testreszabható értesítés teljes listájának eléréséhez lépjen a Értesítések oldalra a Shopify adminisztrációs felületén.

A bonyolultabb módosításokkal kapcsolatos segítségért vagy az egyéni értesítési sablonok módosításához forduljon a közösséghez a fórumainkon, vagy felbérelhet egy Shopify Partnert is, hogy elvégezze Önnek a testreszabásokat. További információk a Shopify Partnerek felbérléséről.

Rendelés tulajdonságai

A rendelés számos tulajdonsága közvetlenül elérhető a Liquid használatával és a sablonokban.

Az értesítési sablonokban a rendelés objektummal használható Liquid tulajdonságok leírása
TulajdonságLeírás
id

A rendelés rendszerszintű egyedi azonosítója belső használatra. Az alábbi példa segítségével hivatkozást hozhat létre a rendelésre az üzlet adminisztrációs felületén. Például az Új rendelés sablonban hozzáadhatja a következő kódot:

Rendelés megtekintése
emailA rendeléshez társított e-mail-cím.
name

Általában ez egy kettőskereszt, amelyet a order_numberkövet.

Példa: #1004

order_nameUgyanaz, mint a name.
order_number

A rendelés üzleten belüli egyedi száma, a # előtag nélkül, vagy bármilyen, a bolttulajdonos által az üzlet beállításaiban a rendelési azonosítóhoz adott elő- vagy utótag nélkül.

Példa: 1004

confirmation_number

A rendelés véletlenszerűen generált alfanumerikus azonosítója, amely a sorszámozott rendelésazonosító helyett jelenhet meg a vásárlónak. Ez az érték nem garantáltan egyedi.

Példa: XPAV284CT

created_at

A rendelés létrehozásának dátuma és időpontja. Ezt a dátumszűrővel formázhatja.

Példa: 2009-05-30T17:43:51+02:00

payment_terms

A fizetési feltételek határozzák meg azt a dátumot, amikor a rendelés kifizetése esedékes.

Ismerje meg, hogyan adhat hozzá fizetési feltételeket a rendelési számlákhoz.

További részletekért lásd a Liquid payment_terms referenciáját.

destinationA rendeltetési hely, ahová a tételeket küldeni kell.
tagsVisszaadja a rendelés összes címkéjét tartalmazó tömböt. A címkék betűrendben jelennek meg. Előfordulhat, hogy az alkalmazások vagy platformfunkciók – például a Shopify Collective címke – által dinamikusan alkalmazott címkék nem állnak rendelkezésre az értesítő e-mail generálásakor. Egy adott funkcióból származó tételek észleléséhez ehelyett a termékszintű címkéket ellenőrizze minden egyes sorelemen. További részletekért tekintse meg a Liquid referenciadokumentációt.
transactionsA rendelés tranzakcióinak tömbjét adja vissza.
tax_priceA rendelésben szereplő összes tétel összesített adója.
tax_lines

Az adók adózási típus szerint lebontva:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.titleAz adó neve. Például QST vagy áfa.
tax_line.priceAz adó összege.
tax_line.rateAz adókulcs tizedes tört formában. 0,175 értéket ad vissza, ha az adókulcs 17,5%.
tax_line.rate_percentageAz adókulcs ember által olvasható formában. 17,5 értéket ad vissza, ha a kulcs 0,175.
customerVásárló objektum, amely a vásárlói kimenet jellemzőit tartalmazza.
billing_addressA számlázási cím.
billing_address.first_nameA vásárló keresztneve.
billing_address.last_nameA vásárló vezetékneve.
billing_address.companySzámlázási cégnév.
billing_address.phoneA számlázási címhez tartozó telefonszám.
shop.nameAz üzlet neve.
shop.phoneAz üzlet telefonszáma.
subtotal_priceA rendelés sorelemei árainak összege a sorelemre vonatkozó vagy a kosárra érvényes kedvezmények levonása után. A részösszeg nem tartalmazza az adókat (kivéve, ha az árak tartalmazzák az adókat), a szállítási költséget és a borravalót.
discountsA kedvezmények listája.
discounts_amount

Az összes érvényesített kedvezmény összege.

Példa: +5,00 $

discounts_savings

Az összes kedvezményből származó megtakarítás összege.

Példa: -5,00 $

total_price

A rendelés végösszege (részösszeg + szállítási költség - szállítási kedvezmény + adó).

financial_statusAz aktuális fizetési állapot. Az alábbiak egyike: nil, függőben, jóváhagyva, fizetve, érvénytelenítve, visszatérítve.
requires_shipping(logikai) Igaz értéket ad vissza, ha a rendelésben van legalább egy tétel, amely szállítást igényel.
shipping_method.title

A szállítási díj neve.

A vásárlóknak szóló értesítésekben a szállítási díj neve lefordítódik arra a nyelvre, amelyet a vásárló a fizetés során használt, ha ez a nyelv eltér az üzlet alapértelmezett nyelvétől.

Példa: Normál szállítás
shipping_method.price

A szállítás ára, beleértve az esetleges szállítási kedvezményeket.

Példa: {{ shipping_method.price | money }}

shipping_price

A szállítás díja.

Példa: {{ shipping_price | money }}

shipping_addressA szállítási cím.
shipping_address.first_nameA szállítási címhez tartozó keresztnév.
shipping_address.companyA szállítási címhez tartozó cégnév.
shipping_address.phoneA szállítási címhez tartozó telefonszám.
line_itemsA rendelés összes sorelemének listája.
line_items_including_zero_quantityA rendelés összes sorelemének listája, beleértve a nulla mennyiségűeket is. A sorelemek mennyisége akkor nulla, ha teljes egészében visszatérítették őket.
line_item_groups(Orders and POS only)A rendelésben lévő, sorelem-komponenseket tartalmazó összes sorelemcsoport listája.
item_countAz összes tétel mennyiségének összege.
fulfillment_statusA rendelés aktuális teljesítési állapota. Az alábbiak egyike: nem teljesített, részleges, teljesített.
noteA rendeléshez csatolt megjegyzés. A megjegyzést a vásárló is megadhatja, illetve az adminisztrációs felületen, a rendelés adatlapján is szerkeszthető.
attributes

A rendeléshez csatolt jellemzők.

Példa: {{ attributes.gift-note }}

metafields

A rendelésen lévő metamezők. Használja a következő szintaxist:

metafields.NAMESPACE.KEY

referring_site

Annak a hivatkozónak az URL-címét tartalmazza, amely a vásárlót az üzletbe irányította.

Példa: https://www.google.com/?s=great+products

landing_site

Annak a céloldalnak az elérési útját tartalmazza, amelyet a vásárló használt. Ez az első oldal, amelyet a vásárló látott, amikor megérkezett az üzletbe.

Példa: /products/great-product?ref=my-tracking-token

landing_site_ref

Megvizsgálja a céloldalt, és kinyer belőle egy hivatkozási paramétert. A hivatkozási paraméterek a következők lehetnek: ref, source, r.

Ha a landing_site értéke /products/great-product?ref=my-tracking-token, akkor a landing_site_ref értéke my-tracking-token. Végrehajthat egy adott műveletet, ha a hivatkozás (ref) értéke megegyezik egy bizonyos értékkel:

{% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}
cancelled(logikai) Igaz értéket ad vissza, ha a rendelést törölték.
cancelled_atA rendelés törlésének időpontja.
cancel_reasonA rendelés törlésekor kiválasztott ok. Az alábbiak egyike: készlet, vásárló, elutasítva, csalás vagy egyéb.
has_high_risks?(deprecated)

Igaz értéket ad vissza, ha a rendelés magas kockázatú.

unique_gateways

A rendelés egyedi fizetési szolgáltatóinak listáját adja vissza. Ha például valaki Visa és Mastercard kártyával, valamint készpénzzel fizetett, a visszaadott lista a következő lenne: shopify_payments, cashkövet.

location(POS only)

Megjeleníti a rendelés fizikai helyszínét. Számos helyszín-tulajdonság érhető el, amelyek itt vannak felsorolva. A helyszíneket az adminisztrációs felület Helyszínek területén állíthatja be.

order_status_url

Visszaadja az ehhez a rendeléshez tartozó rendelésállapot-oldalra mutató hivatkozást.

fulfilled_line_items(deprecated)A teljesített sorelemek listája.
unfulfilled_line_items(deprecated)A még nem teljesen teljesített sorelemek listája.
b2b?

Igaz értéket ad vissza, ha a rendelés B2B rendelés. Használja a tulajdonságot B2B változókkal a releváns információk, például a cégnév, a vállalkozás telephelye és a cím megjelenítéséhez az e-mailekben. Például B2B rendelések esetén a következő információkkal egészíthet ki egy sablon fejlécét:

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

A cég, amelynek egy B2B rendelés keretében értékesít.

company.name

A B2B-rendelésen szereplő cég neve.

company.id

A cég azonosítója egy B2B rendelésen.

company_location

A cég telephelye egy B2B rendelésen. Egy Öntől vásárló cégnek több telephelye is lehet.

company_location.name

A vállalkozás telephelyének neve egy B2B rendelésen.

company_location.id

A vállalkozás telephelyének azonosítószáma egy B2B rendelésen.

company_location.shipping_address

A vállalkozás telephelyének szállítási címe egy B2B rendelésen.

company_location.billing_address

A vállalkozás telephelyének számlázási címe egy B2B rendelésen.

customer_order_url

Annak a rendelésnek az új rendelésállapot-oldala, amelyre a vásárló vásárlói fiókok használatával visszavételt kért.

A rendelési megbízás tulajdonságai

Azoknak a Liquid-tulajdonságoknak a leírása, amelyeket az értesítési sablonokban a rendelésimegbízás-objektummal használhat.
TulajdonságLeírás
idA rendelési megbízás egyedi azonosítója belső használatra.
invoice_urlEgy hivatkozás, amelyet a vásárló követhet a számla kifizetéséhez a Shopify biztonságos pénztárában.
reserve_inventory_until

A dátum és időpont, ameddig a rendelési megbízásban szereplő sorelemek le vannak foglalva, például: 2015-05-30T17:43:51+02:00.

A dátumokat a Liquid dátumszűrőjével formázhatja.

userAz utolsó munkatárs, aki módosította a rendelési megbízást.
user.nameA rendelési megbízást utoljára módosító munkatárs neve.
user.emailA rendelési megbízást utoljára módosító munkatárs e-mail-címe.
emailA rendelési megbízáshoz társított e-mail-cím.
nameAz egyedi number a rendelési megbízásnak, kettőskereszt (#) előtaggal ellátva.
numberA rendelési megbízás egyedi száma, a rendelési előtag vagy utótag nélkül.
created_at

A dátum és időpont, amikor a vásárló létrehozta a rendelési megbízást, például: 2009-05-30T17:43:51+02:00.

A dátumokat a Liquid dátumszűrőjével formázhatja.

tagsA rendelés összes címkéjét tartalmazó tömböt adja vissza. A címkék ábécésorrendben szerepelnek. További részletekért tekintse meg a Liquid referenciadokumentációt.
tax_priceA rendelési megbízásban szereplő összes tétel összesített adója.
tax_lines

Az adók adótípusonkénti bontásban:

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

Az adó neve.

Például: QST vagy áfa

tax_line.priceAz adó összege.
tax_line.rateAz adókulcs decimális formában. Például egy 17,5%-os adókulcs 0,175 értéket ad vissza.
tax_line.rate_percentageAz adókulcs százalékos formában. Például egy 0,175-ös rate (kulcs) 17,5 értéket ad vissza.
customerVásárló objektum, amely a vásárlói kimenet jellemzőit tartalmazza.
billing_addressA rendelési megbízás számlázási címe.
billing_address.first_nameA vásárló keresztneve.
billing_address.last_nameA vásárló vezetékneve.
billing_address.companyA cég neve a számlázási címen.
billing_address.phoneA telefonszám a számlázási címen.
shop.nameAz Ön üzletének neve.
shop.phoneAz üzlet telefonszáma.
subtotal_priceA rendelési megbízás sorelemei árának összege a sorelem- vagy kosárkedvezmények levonása után. A részösszeg nem tartalmazza az adókat (kivéve, ha az adók szerepelnek az árakban) és a szállítási költségeket.
discountsA kedvezmények listája.
discounts_amount

Az összes kedvezmény együttes összege.

Példa: +5,00 $

discounts_savings

Az összes kedvezmény által eredményezett megtakarítás összege.

Példa: -5,00 $

total_priceA rendelés teljes ára (részösszeg + szállítási költség - szállítási kedvezmény + adó).
amount_due_now

A rendelési megbízás számláján fizetendő összeg.

requires_shippingVisszaadja a true értéket, ha a rendelési megbízásban van legalább egy olyan tétel, amely szállítást igényel. Visszaadja a false értéket, ha a rendelési megbízásban egyetlen tétel sem igényel szállítást.
shipping_method.title

A szállítási díj neve.

Például: Normál szállítás

shipping_method.priceA szállítási mód ára. Ugyanazt az információt adja vissza, mint a shipping_pricekövet.
shipping_price

A szállítás díja.

Ezt az összeget a Liquid pénzszűrőivel formázhatja.

shipping_address

A szállítási cím.

Megjegyzés: A normál rendelésekkel ellentétben a rendelési megbízás szállítási címe hiányos lehet.

shipping_address.first_nameA szállítási címhez tartozó keresztnév.
shipping_address.companyA cég neve a szállítási címen.
shipping_address.phoneA telefonszám a szállítási címen.
line_itemsA rendelési megbízásban szereplő összes sorelem listája.
item_countA rendelési megbízásban szereplő összes tételmennyiség összege.
noteA rendelési megbízáshoz csatolt megjegyzés. A megjegyzés a vásárlótól származhat, és a Shopify adminisztrációs felületén, a rendelési megbízás részleteinek képernyőjén is szerkeszthető.
metafields

A rendelési megbízás bármely metamezője. Használja a következő szintaxist:

metafields.NAMESPACE.KEY

location

A rendelés fizikai helyszíne. Számos helyszín-tulajdonság érhető el.

A helyszíneket a Shopify adminisztrációs felületének Helyszínek oldalán állíthatja be.

b2b?

Igaz értéket ad vissza, ha a rendelés B2B rendelés. Használja a tulajdonságot B2B változókkal a releváns információk, például a cégnév, a vállalkozás telephelye és a cím megjelenítéséhez az e-mailekben. Például B2B rendelések esetén a következő információkkal egészíthet ki egy sablon fejlécét:

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

A cég, amelynek egy B2B rendelés keretében értékesít.

company.name

A B2B-rendelésen szereplő cég neve.

company.id

A cég azonosítója egy B2B rendelésen.

company_location

A cég telephelye egy B2B rendelésen. Egy Öntől vásárló cégnek több telephelye is lehet.

company_location.name

A vállalkozás telephelyének neve egy B2B rendelésen.

company_location.id

A vállalkozás telephelyének azonosítószáma egy B2B rendelésen.

company_location.shipping_address

A vállalkozás telephelyének szállítási címe egy B2B rendelésen.

company_location.billing_address

A vállalkozás telephelyének számlázási címe egy B2B rendelésen.

payment_methods

A rendelési megbízás végösszegének feldolgozásához rendelkezésre álló mentett fizetési módok listája.

payment_method.payment_instrument

A fizetési eszköz, amely a mentett fizetési mód részleteit tartalmazza.

payment_method.payment_instrument.payment_type

A mentett fizetési mód típusa. Például: „credit_card, apple_pay”

payment_method.payment_instrument.credit_card_brand

A kártya márkája, ha a `payment_type` értéke „credit_card”.

payment_method.payment_instrument.credit_card_company

A kártyatársaság, ha a `payment_type` értéke „credit_card”.

payment_method.payment_instrument.credit_card_company

A kártya utolsó 4 számjegye, ha a `payment_type` értéke „credit_card”.

Fizetési ütemezés tulajdonságai

Az értesítési sablonokban a fizetési ütemezés objektummal használható Liquid-tulajdonságok leírása
TulajdonságLeírás
payment_schedule.amount_due

A fizetési ütemezéshez tartozó fizetendő összeg.

Az összegeket a pénznemükkel együtt a Liquid money filter használatával formázhatja.

payment_schedule.due_at

A fizetési ütemezés esedékességének dátuma.

A dátumokat a Liquid dátumszűrőjével formázhatja.

payment_schedule.due_in_days

Az esedékességig hátralévő napok száma, ha a fizetési ütemezés még esedékes (nincs kifizetve).

payment_schedule.due_later?

`true` értéket ad vissza, ha a fizetési ütemezés nincs kifizetve, és az esedékesség dátuma a jövőben van.

payment_schedule.number_of_days_overdue?

Az esedékesség dátumától eltelt napok száma, ha egy fizetési ütemezés lejárt.

payment_schedule.overdue?

`true` értéket ad vissza, ha a fizetési ütemezés nincs kifizetve, és már lejárt az esedékessége.

Fizetési állapot tulajdonságai

Az értesítési sablonokban a fizetési állapot objektummal használható Liquid-tulajdonságok leírása
TulajdonságLeírás
has_pending_payment

(logikai) `true` értéket ad vissza, ha a rendeléshez függőben lévő fizetésű tranzakció tartozik.

További információ a függőben lévő fizetésekről.

buyer_action_required

(logikai) `true` értéket ad vissza, ha egy rendeléshez függőben lévő fizetésű tranzakció tartozik, és a fizetés feloldásához vásárlói beavatkozás szükséges. Ha ez az érték `true`, és a fizetési mód támogatja a fizetési utasításokat, a buyer_pending_payment_instructions részleteket biztosít, amelyeket a vásárló felhasználhat a vásárlás offline befejezéséhez.

További információ a Liquid tranzakcióobjektumáról.

Csomagösszetevő tulajdonságai

A line_item.bundle_components listában szereplő minden bundle_component a következő tulajdonságokkal rendelkezik. (Csak rendelési megbízások esetén)

Az értesítési sablonokban a csomagösszetevő-objektummal használható Liquid-tulajdonságok leírása
TulajdonságLeírás
bundle_component.image_urlA csomagösszetevő képének URL-je.
bundle_component.product.titleA csomagösszetevő termékének címe.
bundle_component.quantityA csomagösszetevő mennyisége.
bundle_component.variant.title

A csomagösszetevő-változat beállítási értékeinek aktuális nevei, / karakterekkel elválasztva.

Példa: kicsi / piros

Komponens tulajdonságai

A line_item.components listában szereplő minden component a következő tulajdonságokkal rendelkezik. (Csak félbehagyott pénztár esetén) `

Az értesítési sablonokban a komponensobjektummal használható Liquid-tulajdonságok leírása
TulajdonságLeírás
component.image_urlA komponens képének URL-je.
component.product.titleA komponens termékének címe.
component.quantityA komponens mennyisége.
component.variant.title

A komponensváltozat beállítási értékeinek aktuális nevei, / karakterekkel elválasztva.

Példa: kicsi / piros

Sorelem tulajdonságai

A line_items vagy a subtotal_line_items listában szereplő minden line a következő tulajdonságokkal rendelkezik.

Az értesítési sablonokban a sorelemobjektummal használható Liquid-tulajdonságok leírása
TulajdonságLeírás
line.applied_discounts(POS and draft orders only)Az erre a tételre alkalmazott kedvezmények listája (minden kedvezmény rendelkezik a title, code, amount, savings és type tulajdonságokkal).
line.bundle_components(Draft orders only)Azoknak a sorelemeknek a listája, amelyek ennek a tételnek a csomagösszetevői. Csak akkor ad vissza listát, ha ez a sorelem egy termékcsomag.
line.bundle_parent?(Draft orders only)(logikai) `true` értéket ad vissza, ha a sorelem termékcsomag.
line.components(Abandoned checkout only)Azoknak a sorelemeknek a listája, amelyek ennek a tételnek a komponensei.
line.parent?(Abandoned checkout only)(logikai) `true` értéket ad vissza, ha a sorelemnek vannak komponensei.
line.custom(Draft orders only)(logikai) `true` értéket ad vissza, ha a tétel egy rendelési megbízás egyéni soreleme.
line.delivery_agreementAz ehhez a sorelemhez tartozó Szállítási megállapodás.
line.gramsEgyetlen tétel súlya.
line.groupsA tétel sorelemcsoportja.
line.imageVisszaadja az ehhez a sorelemhez tartozó kép URL-címét. Az img_url szűrővel megadott képméreteket is lekérhet, például: {{ line.image | img_url: 'small' }}
line.line_priceAz adott tételre vonatkozó ár és mennyiség szorzata.
line.original_line_priceA sorelemben szereplő tételek teljes ára a kedvezmények alkalmazása előtt.
line.final_line_priceA sorelem összes tételének együttes ára, beleértve az összes sorszintű kedvezmény összegét.
line.pre_tax_priceA sorelemben vásárolt mennyiség és az adó előtti ár szorzata.
line.priceEgyetlen tétel ára.
line.product.metafields

Bármely metamező termékszinten. Használja a következő szintaxist:

line.product.metafields.NAMESPACE.KEY

line.product.titleA termék aktuális neve.
line.product.vendorA tétel szállítója.
line.propertiesEgy tételre vonatkozó egyéni információk tömbjét adja vissza. A sorelem-tulajdonságokat a vásárló adja meg a termékoldalon, mielőtt a terméket a kosárba helyezi.
line.quantityAz adott tétel mennyisége.
line.current_quantityA tétel aktuális mennyisége az eltávolítások után.
line.requires_shipping(logikai) `true` értéket ad vissza, ha a tétel változatánál a Fizikai termék beállítás aktiválva van a termékoldalon.
line.selling_plan_allocationVisszaad egy selling_plan_allocation objektumot, amely leírja, hogy egy értékesítési terv, például egy előfizetés, hogyan befolyásolja a sorelemet.
line.taxable(logikai) `true` értéket ad vissza, ha a tétel változatánál a termékoldalon be van jelölve az „Adók felszámítása erre a termékre” jelölőnégyzet.
line.title

A termék neve az értékesítés időpontjában, amelyet egy kötőjel, majd a változat neve követ az értékesítés időpontjában. A változat neve nem szerepel, ha az „Alapértelmezett cím”.

A vásárlóknak küldött értesítésekben a termék és a változat neve le van fordítva arra a nyelvre, amelyet a vásárló a pénztárnál használt, amennyiben ez a nyelv eltér az üzlet alapértelmezett nyelvétől.
line.urlA sorelem változatának relatív URL-je. A relatív URL nem tartalmazza az üzlet gyökér URL-jét (mystore.myshopify.com).
line.variant.barcodeA termékváltozathoz tartozó vonalkód.
line.variant.compare_at_priceA termékváltozathoz tartozó összehasonlító ár.
line.variant.imageA termékváltozat képe. Csak akkor ad vissza képet, ha a sorelemben a változathoz egyedi kép van hozzárendelve.
line.variant.metafields

A változat szintjén lévő metamezők. Használja a következő szintaxist:

line.variant.metafields.NAMESPACE.KEY

line.variant.skuA termékváltozathoz tartozó cikkszám.
line.variant.title

A változat beállítási értékeinek aktuális nevei / karakterekkel elválasztva.

Példa: kicsi / piros

line.refunded.quantity(within refund notifications)

A visszatérítendő tétel mennyisége. Ezzel a tulajdonsággal azonosítót adhat hozzá a rendelésben szereplő visszatérített tételekhez.

Például: {% if line.refunded_quantity > 0 %}Visszatérített sor azonosítója{% endif %}

Shopify Collective-tételek észlelése az értesítési sablonokban

A Shopify Collective címke a rendelést visszaigazoló e-mail elküldése után kerül a rendelésre, így a {% if tags contains 'Shopify Collective' %} értéke egy rendelésvisszaigazolási sablonban soha nem true. A Shopify Collective-tételek észleléséhez ehelyett a termékszintű címkéket ellenőrizze minden egyes sorelemen:

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

Sorelemcsoport tulajdonságai

A line_item_groups listában szereplő minden line_item_group a következő tulajdonságokkal rendelkezik.

Az értesítési sablonokban a sorelemcsoport-objektummal használható Liquid-tulajdonságok leírásai.
TulajdonságLeírás
line_item_group.display_titleA sorelemcsoport címe.
line_item_group.componentsA csoporthoz tartozó sorelem-összetevők listája.
line_item_group.imageA sorelemcsoport képe.
line_item_group.product_idA sorelemcsoport termékazonosítója.
line_item_group.variantA sorelemcsoport változatobjektuma.
line_item_group.variant_idA sorelemcsoport változatazonosítója.

Visszatérítési tulajdonságok

Az értesítési sablonokban a visszatérítés-objektummal használható Liquid-tulajdonságok leírásai.
TulajdonságLeírás
amountA visszatérített pénzösszeg.
refund_line_itemsA visszatérítendő visszatérítési sorelemek listája.

Visszatérítési sorelem tulajdonságai

A refund_line_items listában szereplő minden refund_line a következő tulajdonságokkal rendelkezik:

Az értesítési sablonokban a visszatérítési sorelemek objektummal használható Liquid-tulajdonságok leírásai.
TulajdonságLeírás
refund_line.line_itemA visszatérített sorelem. Ez hozzáfér a sorelem összes tulajdonságához.
refund_line.quantityA visszatérítendő sorelem mennyisége.

Teljesítési tulajdonságok

Az értesítési sablonokban a teljesítés-objektummal használható Liquid-tulajdonságok leírásai.
TulajdonságLeírás
service_nameAz egyéni szolgáltatás neve, ahogy az a „Beállítások” > „Szállítás és kiszállítás” oldalon meg van adva. (Csak teljesítési kérelem esetén)
fulfillment.estimated_delivery_atBecsült kézbesítési dátum a következő fuvarozók valamelyike által biztosított követési szám alapján (ha elérhető): USPS, FedEx, UPS, kanadai posta (csak Kanada). Ez a tulajdonság csak akkor érhető el, ha fuvarozó által számított díjak vannak használatban.
fulfillment.fulfillment_line_itemsA teljesítendő teljesítési sorelemek listája.
fulfillment.item_countAz összes tétel mennyiségének összege. A teljesítés alatt álló tételek teljes száma.
fulfillment.requires_shipping(logikai) Igaz értéket ad vissza, ha ez a teljesítési kérelem szállítást igényel.
fulfillment.tracking_companyA nyomon követést végző cég.
fulfillment.tracking_numbersA követési számok listája.
fulfillment.tracking_urlsA nyomonkövetési URL-ek listája.
items_to_fulfill(deprecated)Az adott egyedi teljesítési szolgáltatás által teljesítendő sorelemek listája. (Csak teljesítési kérelem esetén)
items_to_fulfill_count(deprecated)A kérelem által teljesítendő tételek teljes száma. (Csak teljesítési kérelem esetén)

Teljesítési sorelem tulajdonságai

A fulfillment_line_items listában szereplő minden fulfillment_line a következő tulajdonságokkal rendelkezik.

Az értesítési sablonokban a teljesítési sorelemek objektummal használható Liquid-tulajdonságok leírásai.
TulajdonságLeírás
fulfillment_line.line_itemA teljesítés alatt álló sorelem. Hozzáférést biztosít a sorelem összes tulajdonságához.
fulfillment_line.quantityA teljesítés alatt álló sorelem mennyisége.

Előkészített csomag tulajdonságai

Az előkészített csomag azokat a tételeket tartalmazza, amelyeket átvételre késznek jelöltek.

Az értesítési sablonokban az előkészítettcsomag-objektummal használható Liquid-tulajdonságok leírásai.
TulajdonságLeírás
item_countAz előkészített csomagban lévő összes tétel mennyiségének összege.
prepared_package_line_itemsAz előkészített csomag sorelemeinek listája.

Előkészített csomag sorelem-tulajdonságok

A prepared_package_line_items listában szereplő minden prepared_package_line_item a következő tulajdonságokkal rendelkezik.

Az értesítési sablonokban az előkészítettcsomag-sorelem objektummal használható Liquid-tulajdonságok leírásai.
TulajdonságLeírás
line_itemA társított sorelem. Hozzáférést biztosít a sorelem összes tulajdonságához.
quantityAnnak a sorelemnek a mennyisége, amelyet átvételre késznek jelöltek.

Kiszállítási tulajdonságok

Az értesítési sablonokban a kiszállítás-objektummal használható Liquid-tulajdonságok leírásai.
TulajdonságLeírás
delivery_agreementsA rendeléshez tartozó összes kiszállítási megállapodás listája.
delivery_instructionsA vásárlóval megosztandó helyi szállítási információk. Ezt az információt a helyi szállítási beállítások között található Kiszállítási információk mező szabályozza.
consolidated_estimated_delivery_timeA vásárlóval megosztandó információk a rendelés kézbesítési dátumairól. Ezt az információt a Szállítás és kézbesítés oldalon beállított Feldolgozási idő beállítás szabályozza. Ha a rendeléshez több kézbesítési mód is tartozik, megjelenik a kézbesítési módok és dátumok listája.
has_multiple_delivery_methods(logikai) Igaz értéket ad vissza, ha a rendeléshez több kézbesítési mód tartozik.

A kiszállítási megállapodás tulajdonságai

Az értesítési sablonokban a kiszállításimegállapodás-objektummal használható Liquid-tulajdonságok leírásai.
TulajdonságLeírás
delivery_agreement.delivery_method_typeA kézbesítési mód típusa.
delivery_agreement.delivery_method_nameA kézbesítési mód típusának fordítása arra a nyelvre, amelyen a vásárló fizetett, ha az eltér az üzlet alapértelmezett nyelvétől.
delivery_agreement.line_item_groupsA kiszállítási megállapodásban lévő, csomagolt sorelem-összetevőket tartalmazó összes sorelemcsoport listája.
delivery_agreement.line_itemsAz ehhez a kiszállítási megállapodáshoz tartozó összes sorelem listája.

Kedvezménytulajdonságok

Kétféle kedvezménytulajdonság létezik.

A discount_applications azt írja le, hogy egy tétel miért és hogyan kapott kedvezményt.

A discount_allocations azt írja le, hogy egy adott kedvezmény hogyan hat egy sorelemre, és hogyan csökkenti az árat. Ezt a tulajdonságot a sorelem szintjén kell használnia.

Ezeket a tulajdonságokat kombinálva sorelem- vagy rendelésszinten is megjelenítheti a kedvezményadatokat.

Példa

Ez a példa ellenőrzi, hogy alkalmaztak-e kedvezményt a sorelemre. Ha a kedvezményt nem rendelésszinten (all) alkalmazták, akkor megjelenik a kedvezmény neve és összege.

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

Az eredmény a következőhöz hasonló lehet:

SPRING5 (-$5.00)

A discount_allocation tulajdonságai

A discount_allocations listában szereplő minden discount_allocation a következő tulajdonságokkal rendelkezik.

A Liquid-tulajdonságok leírása, amelyeket a discount_allocation objektummal használhat az értesítési sablonokban
TulajdonságLeírás
discount_allocation.amountA vásárló által egy sorelemen megspórolt pénzösszeg. Ciklusban kell megadni, ha több kedvezménykód használatát is engedélyezni szeretné.
discount_allocation.discount_applicationAz a kedvezményalkalmazás, amely a sorelemre vonatkozó összeget kiosztja.

A discount_application tulajdonságai

A discount_applications listában szereplő minden discount_application a következő tulajdonságokkal rendelkezik.

A Liquid-tulajdonságok leírása, amelyeket a discount_application objektummal használhat az értesítési sablonokban
TulajdonságLeírás
discount_application.target_selection

Leírja, hogy egy kedvezmény hogyan választja ki a kosárban lévő, kedvezményre jogosult sorelemeket. A következők egyike:

  • all: A kedvezmény az összes sorelemre vonatkozik.
  • entitled: A kedvezmény a sorelemek egy adott alhalmazára vonatkozik, amelyet gyakran egy feltétel határoz meg.
  • explicit: A kedvezmény egy kifejezetten kiválasztott sorelemre vagy szállítási sorra vonatkozik.
discount_application.target_typeA tétel típusa, amelyre a kedvezmény vonatkozik (line_item vagy shipping_line).
discount_application.title

A kedvezmény vásárlóknak megjelenő neve.

Például: Welcome10 vagy CBBWQQAKYBYY

discount_application.total_allocated_amountA teljes összeg, amellyel a kedvezmény csökkenti a rendelés árát.
discount_application.typeA kedvezmény típusa. A következők egyike: automatic, discount_code, manual vagy script.
discount_application.valueA kedvezmény értéke.
discount_application.value_typeA kedvezmény értéktípusa. A következők egyike: fixed_amount vagy percentage.

Előfizetési tulajdonságok

Az előfizetői szerződés, az aktuális számlázási ciklus, valamint annak sorelemei, kézbesítési módja és fizetési módjának adatai elérhetők az összes előfizetési e-mail-sablonhoz.

Az előfizetési értesítési sablonok szerkesztéséhez telepítse a Shopify Subscriptions alkalmazást, majd keresse meg a sablont a Beállítások > Értesítések menüpontban, a Subscriptions szakasz alatt.

Az előfizetői szerződés számlázási ciklusának tulajdonságai

Az előfizetői szerződés és annak számlázási ciklusának tulajdonságaihoz való hozzáféréshez használja a subscription_contract_billing_cycle objektumot.

Példa

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

Eredmény:

This contract is currently paused.

Tulajdonságok

A Liquid-tulajdonságok leírása, amelyeket az előfizetői szerződés számlázási ciklus objektumával használhat az értesítési sablonokban
TulajdonságLeírás
status A szerződés állapota.

A következők egyike: active, paused, cancelled, failed, expired, stale,
delivery_method Az előfizetés kézbesítési módja.

Ha az előfizetés szolgáltatásra vagy digitális termékre vonatkozik, akkor az eredmény nil.
billing_frequencyAz előfizetés számlázásának gyakorisága.
delivery_frequency Az előfizetés kiszállításának gyakorisága.
origin_order Az eredeti rendelés, amelyből az előfizetés létrejött.

Ha az előfizetés nem Shopify-rendelésből jött létre, akkor az eredmény nil.
customerAz előfizetéshez tartozó vásárló.
line_items Az előfizetés számlázási ciklusában szereplő sorelemek.
product_namesAz előfizetés számlázási időszakában szereplő termékek neveinek listája.
update_payment_method_urlAz az URL, amelyen a vásárló frissítheti a szerződéshez tartozó fizetési módot.
shipping_address Az előfizetés szállítási címe.

Ha az előfizetés szolgáltatásra vagy digitális termékre vonatkozik, akkor az eredmény nil.
billing_addressAz előfizetés számlázási címe.
subtotal_priceAz előfizetés sorelemeinek részösszege.
shipping_priceAz előfizetés szállítási díja.
total_taxAz előfizetés teljes adóösszege.
total_priceAz előfizetés teljes ára.
total_discountsAz előfizetés teljes kedvezményösszege.
customer_self_serve_urlAz az önkiszolgáló URL, amelyen a vásárló kezelheti az előfizetéseit.
billing_attempt_expected_dateEnnek a számlázási ciklusnak a számlázási dátuma.
next_billing_dateA következő, át nem ugrott számlázási dátum a jelenlegi számlázási ciklus után.
last_attempted_billing_dateA számlázási ciklus utolsó megkísérelt számlázási dátuma.
days_overdueA napok száma, amióta a számlázás késik ebben a számlázási ciklusban.
payment_instrumentAz előfizetői szerződéshez társított fizetési eszköz. Ezzel a fizetési eszközzel számlázzák ki a vásárlót.

Az előfizetői szerződés sorelemeinek tulajdonságai

A számlázási ciklusban szereplő minden egyes sorelem tulajdonságai. A szerződés sorelem-tulajdonságait a szülő subscription_contract_billing_cycle.line_items tulajdonságon keresztül érheti el.

Példa

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}
A Liquid-tulajdonságok leírása, amelyeket az előfizetői szerződés sorelem objektumával használhat az értesítési sablonokban
TulajdonságLeírás
urlA sorelem termékváltozatának termékadatlapjára mutató URL.
requires_shippingAzt jelzi, hogy a sorelem igényel-e fizikai szállítást.
unit_price_measurementA sorelem egységár-mértékegysége.
selling_plan_allocationA sorelem értékesítési tervének kiosztása.

Az előfizetői szerződés kézbesítési módjának tulajdonságai

Az ebben a számlázási ciklusban használt kézbesítési mód tulajdonságai. A kézbesítési mód tulajdonságai a szülő subscription_contract_billing_cycle.delivery_method tulajdonságon keresztül érhetők el.

Példa

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}
Azoknak a Liquid-tulajdonságoknak a leírása, amelyeket az előfizetői szerződés kézbesítési módjának objektumával használhat az értesítési sablonokban.
TulajdonságLeírás
titleA kézbesítési módhoz társított szállítási opció címe.
type A kézbesítési mód típusa.

A következők egyike: shipping, local vagy pick-up.

Az előfizetői szerződés fizetési eszközének tulajdonságai

Az előfizetői szerződés fizetési eszközének adatai. Ezzel a fizetési eszközzel történik a vásárló kiszámlázása. A fizetési eszköz tulajdonságai a szülő subscription_contract_billing_cycle.payment_instrument tulajdonságon keresztül érhetők el.

Példa

{% 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 }}
Azoknak a Liquid-tulajdonságoknak a leírása, amelyeket az előfizetői szerződés fizetési eszközének objektumával használhat az értesítési sablonokban.
TulajdonságLeírás
payment_type A fizetési eszköz által képviselt fizetési mód típusa.

Kép URL-cím vagy SVG megjelenítéséhez használja a(z) fizetési szűrőket.
credit_card_brandA bankkártya márkája.
credit_card_companyA bankkártya-kibocsátó cég neve.
credit_card_last_four_digitsA bankkártya utolsó 4 számjegye.

Az e-mailes értesítések tulajdonságai

Azoknak a Liquid-tulajdonságoknak a leírása, amelyeket az e-mailes értesítések objektumával használhat az értesítési sablonokban.
TulajdonságLeírás
shop.email_logo_urlA logó URL-címe, amely az adminisztrációs felület E-mail-sablonok testreszabása szekciójában van megadva.
shop.email_logo_widthA logó pixelben megadott szélessége, amely az adminisztrációs felület E-mail-sablonok testreszabása szekciójában van megadva.
shop.email_accent_colorA kiemelő szín HEX-kódja, amely az adminisztrációs felület E-mail-sablonok testreszabása szekciójában van megadva.

Az üzleti jóváírás tulajdonságai

Egy üzleti jóváírás kibocsátásának részleteit tartalmazó tulajdonságok.

Azoknak a Liquid-tulajdonságoknak a leírása, amelyeket a kibocsátott üzleti jóváírás objektumával használhat az értesítési sablonokban.
TulajdonságLeírás
issued_store_credit.amount

A kibocsátott üzleti jóváírás összege.

Ezt az összeget a Liquid pénzszűrőivel formázhatja.

issued_store_credit.expires_at

A kibocsátott üzleti jóváírás lejárati dátuma és ideje.

Ezt az értéket a Liquid dátumszűrőivel formázhatja.

issued_store_credit.balance_after_transaction

Az üzleti jóváírási számla egyenlege a jóváírás kibocsátása után.

Ezt az összeget a Liquid pénzszűrőivel formázhatja.

customerVásárló objektum, amely a vásárlói kimenet jellemzőit tartalmazza.