É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.
Ezen az oldalon
- Rendelés tulajdonságai
- Rendeléstervezet tulajdonságai
- Fizetési ütemezés tulajdonságai
- Fizetési állapot tulajdonságai
- Csomagösszetevő tulajdonságai
- Összetevő tulajdonságai
- Tételsor tulajdonságai
- Tételsorcsoport tulajdonságai
- Visszatérítések tulajdonságai
- Teljesítés tulajdonságai
- Előkészített csomag tulajdonságai
- Kiszállítás tulajdonságai
- Kedvezmény tulajdonságai
- Előfizetés tulajdonságai
- E-mail-értesítés tulajdonságai
- Áruházi jóváírás tulajdonságai
Rendelés tulajdonságai
A rendelés számos tulajdonsága közvetlenül elérhető a Liquid használatával és a sablonokban.
| Tulajdonság | Leí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
|
email | A rendeléshez társított e-mail-cím. |
name |
Általában ez egy kettőskereszt, amelyet a Példa: #1004 |
order_name | Ugyanaz, 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. |
destination | A rendeltetési hely, ahová a tételeket küldeni kell. |
tags | Visszaadja 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. |
transactions | A rendelés tranzakcióinak tömbjét adja vissza. |
tax_price | A 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.title | Az adó neve. Például QST vagy áfa. |
tax_line.price | Az adó összege. |
tax_line.rate | Az adókulcs tizedes tört formában. 0,175 értéket ad vissza, ha az adókulcs 17,5%. |
tax_line.rate_percentage | Az adókulcs ember által olvasható formában. 17,5 értéket ad vissza, ha a kulcs 0,175. |
customer | Vásárló objektum, amely a vásárlói kimenet jellemzőit tartalmazza. |
billing_address | A számlázási cím. |
billing_address.first_name | A vásárló keresztneve. |
billing_address.last_name | A vásárló vezetékneve. |
billing_address.company | Számlázási cégnév. |
billing_address.phone | A számlázási címhez tartozó telefonszám. |
shop.name | Az üzlet neve. |
shop.phone | Az üzlet telefonszáma. |
subtotal_price | A 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. |
discounts | A 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_status | Az 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_price |
A szállítás díja. Példa: |
shipping_address | A szállítási cím. |
shipping_address.first_name | A szállítási címhez tartozó keresztnév. |
shipping_address.company | A szállítási címhez tartozó cégnév. |
shipping_address.phone | A szállítási címhez tartozó telefonszám. |
line_items | A rendelés összes sorelemének listája. |
line_items_including_zero_quantity | A 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_count | Az összes tétel mennyiségének összege. |
fulfillment_status | A rendelés aktuális teljesítési állapota. Az alábbiak egyike: nem teljesített, részleges, teljesített. |
note | A 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: |
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: |
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: |
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: Ha a
{% 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_at | A rendelés törlésének időpontja. |
cancel_reason | A 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: |
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
| Tulajdonság | Leírás |
|---|---|
id | A rendelési megbízás egyedi azonosítója belső használatra. |
invoice_url | Egy 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: A dátumokat a Liquid dátumszűrőjével formázhatja. |
user | Az utolsó munkatárs, aki módosította a rendelési megbízást. |
user.name | A rendelési megbízást utoljára módosító munkatárs neve. |
user.email | A rendelési megbízást utoljára módosító munkatárs e-mail-címe. |
email | A rendelési megbízáshoz társított e-mail-cím. |
name | Az egyedi number a rendelési megbízásnak, kettőskereszt (#) előtaggal ellátva. |
number | A 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: A dátumokat a Liquid dátumszűrőjével formázhatja. |
tags | A 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_price | A 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.price | Az adó összege. |
tax_line.rate | Az adókulcs decimális formában. Például egy 17,5%-os adókulcs 0,175 értéket ad vissza. |
tax_line.rate_percentage | Az adókulcs százalékos formában. Például egy 0,175-ös rate (kulcs) 17,5 értéket ad vissza. |
customer | Vásárló objektum, amely a vásárlói kimenet jellemzőit tartalmazza. |
billing_address | A rendelési megbízás számlázási címe. |
billing_address.first_name | A vásárló keresztneve. |
billing_address.last_name | A vásárló vezetékneve. |
billing_address.company | A cég neve a számlázási címen. |
billing_address.phone | A telefonszám a számlázási címen. |
shop.name | Az Ön üzletének neve. |
shop.phone | Az üzlet telefonszáma. |
subtotal_price | A 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. |
discounts | A 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_price | A 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_shipping | Visszaadja 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.price | A 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 |
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_name | A szállítási címhez tartozó keresztnév. |
shipping_address.company | A cég neve a szállítási címen. |
shipping_address.phone | A telefonszám a szállítási címen. |
line_items | A rendelési megbízásban szereplő összes sorelem listája. |
item_count | A rendelési megbízásban szereplő összes tételmennyiség összege. |
note | A 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
| Tulajdonság | Leí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
| Tulajdonság | Leí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 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)
| Tulajdonság | Leírás |
|---|---|
bundle_component.image_url | A csomagösszetevő képének URL-je. |
bundle_component.product.title | A csomagösszetevő termékének címe. |
bundle_component.quantity | A csomagösszetevő mennyisége. |
bundle_component.variant.title | A csomagösszetevő-változat beállítási értékeinek aktuális nevei, 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)
`
| Tulajdonság | Leírás |
|---|---|
component.image_url | A komponens képének URL-je. |
component.product.title | A komponens termékének címe. |
component.quantity | A komponens mennyisége. |
component.variant.title | A komponensváltozat beállítási értékeinek aktuális nevei, 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.
| Tulajdonság | Leí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_agreement | Az ehhez a sorelemhez tartozó Szállítási megállapodás. |
line.grams | Egyetlen tétel súlya. |
line.groups | A tétel sorelemcsoportja. |
line.image | Visszaadja 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_price | Az adott tételre vonatkozó ár és mennyiség szorzata. |
line.original_line_price | A sorelemben szereplő tételek teljes ára a kedvezmények alkalmazása előtt. |
line.final_line_price | A sorelem összes tételének együttes ára, beleértve az összes sorszintű kedvezmény összegét. |
line.pre_tax_price | A sorelemben vásárolt mennyiség és az adó előtti ár szorzata. |
line.price | Egyetlen tétel ára. |
line.product.metafields | Bármely metamező termékszinten. Használja a következő szintaxist: line.product.metafields.NAMESPACE.KEY |
line.product.title | A termék aktuális neve. |
line.product.vendor | A tétel szállítója. |
line.properties | Egy 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.quantity | Az adott tétel mennyisége. |
line.current_quantity | A 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_allocation | Visszaad 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.url | A 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.barcode | A termékváltozathoz tartozó vonalkód. |
line.variant.compare_at_price | A termékváltozathoz tartozó összehasonlító ár. |
line.variant.image | A 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.sku | A termékváltozathoz tartozó cikkszám. |
line.variant.title | A változat beállítási értékeinek aktuális nevei 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: |
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.
| Tulajdonság | Leírás |
|---|---|
line_item_group.display_title | A sorelemcsoport címe. |
line_item_group.components | A csoporthoz tartozó sorelem-összetevők listája. |
line_item_group.image | A sorelemcsoport képe. |
line_item_group.product_id | A sorelemcsoport termékazonosítója. |
line_item_group.variant | A sorelemcsoport változatobjektuma. |
line_item_group.variant_id | A sorelemcsoport változatazonosítója. |
Visszatérítési tulajdonságok
| Tulajdonság | Leírás |
|---|---|
amount | A visszatérített pénzösszeg. |
refund_line_items | A 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:
| Tulajdonság | Leírás |
|---|---|
refund_line.line_item | A visszatérített sorelem. Ez hozzáfér a sorelem összes tulajdonságához. |
refund_line.quantity | A visszatérítendő sorelem mennyisége. |
Teljesítési tulajdonságok
| Tulajdonság | Leírás |
|---|---|
service_name | Az 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_at | Becsü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_items | A teljesítendő teljesítési sorelemek listája. |
fulfillment.item_count | Az ö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_company | A nyomon követést végző cég. |
fulfillment.tracking_numbers | A követési számok listája. |
fulfillment.tracking_urls | A 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.
| Tulajdonság | Leírás |
|---|---|
fulfillment_line.line_item | A teljesítés alatt álló sorelem. Hozzáférést biztosít a sorelem összes tulajdonságához. |
fulfillment_line.quantity | A 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.
| Tulajdonság | Leírás |
|---|---|
item_count | Az előkészített csomagban lévő összes tétel mennyiségének összege. |
prepared_package_line_items | Az 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.
| Tulajdonság | Leírás |
|---|---|
line_item | A társított sorelem. Hozzáférést biztosít a sorelem összes tulajdonságához. |
quantity | Annak a sorelemnek a mennyisége, amelyet átvételre késznek jelöltek. |
Kiszállítási tulajdonságok
| Tulajdonság | Leírás |
|---|---|
delivery_agreements | A rendeléshez tartozó összes kiszállítási megállapodás listája. |
delivery_instructions | A 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_time | A 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
| Tulajdonság | Leírás |
|---|---|
delivery_agreement.delivery_method_type | A kézbesítési mód típusa. |
delivery_agreement.delivery_method_name | A 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_groups | A kiszállítási megállapodásban lévő, csomagolt sorelem-összetevőket tartalmazó összes sorelemcsoport listája. |
delivery_agreement.line_items | Az 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.
| Tulajdonság | Leírás |
|---|---|
discount_allocation.amount | A 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_application | Az 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.
| Tulajdonság | Leí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:
|
discount_application.target_type | A 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_amount | A teljes összeg, amellyel a kedvezmény csökkenti a rendelés árát. |
discount_application.type | A kedvezmény típusa. A következők egyike: automatic, discount_code, manual vagy script. |
discount_application.value | A kedvezmény értéke. |
discount_application.value_type | A 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
| Tulajdonság | Leí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_frequency | Az 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.
|
customer | Az előfizetéshez tartozó vásárló. |
line_items | Az előfizetés számlázási ciklusában szereplő sorelemek. |
product_names | Az előfizetés számlázási időszakában szereplő termékek neveinek listája. |
update_payment_method_url | Az 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_address | Az előfizetés számlázási címe. |
subtotal_price | Az előfizetés sorelemeinek részösszege. |
shipping_price | Az előfizetés szállítási díja. |
total_tax | Az előfizetés teljes adóösszege. |
total_price | Az előfizetés teljes ára. |
total_discounts | Az előfizetés teljes kedvezményösszege. |
customer_self_serve_url | Az az önkiszolgáló URL, amelyen a vásárló kezelheti az előfizetéseit. |
billing_attempt_expected_date | Ennek a számlázási ciklusnak a számlázási dátuma. |
next_billing_date | A következő, át nem ugrott számlázási dátum a jelenlegi számlázási ciklus után. |
last_attempted_billing_date | A számlázási ciklus utolsó megkísérelt számlázási dátuma. |
days_overdue | A napok száma, amióta a számlázás késik ebben a számlázási ciklusban. |
payment_instrument | Az 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 %}| Tulajdonság | Leírás |
|---|---|
url | A sorelem termékváltozatának termékadatlapjára mutató URL. |
requires_shipping | Azt jelzi, hogy a sorelem igényel-e fizikai szállítást. |
unit_price_measurement | A sorelem egységár-mértékegysége. |
selling_plan_allocation | A 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 %}| Tulajdonság | Leírás |
|---|---|
title | A 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 }}| Tulajdonság | Leí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_brand | A bankkártya márkája. |
credit_card_company | A bankkártya-kibocsátó cég neve. |
credit_card_last_four_digits | A bankkártya utolsó 4 számjegye. |
Az e-mailes értesítések tulajdonságai
| Tulajdonság | Leírás |
|---|---|
shop.email_logo_url | A logó URL-címe, amely az adminisztrációs felület E-mail-sablonok testreszabása szekciójában van megadva. |
shop.email_logo_width | A 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_color | A 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.
| Tulajdonság | Leí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. |
customer | Vásárló objektum, amely a vásárlói kimenet jellemzőit tartalmazza. |