Prehľad premenných upozornení
Upozornenia odoslané z obchodu sa vykresľujú pomocou jazyka Liquid. Liquid je jednoduchý a ľahko použiteľný programovací jazyk platformy Shopify. Je to ten istý programovací jazyk, v ktorom sú vytvorené témy z obchodu Theme Store.
Ak chcete upraviť upozornenia, ktoré sa odosielajú z obchodu, môžete v šablónach upozornení vykonať základné prispôsobenia. Ak chcete získať prístup k úplnému zoznamu upozornení, ktoré môžete prispôsobiť, prejdite na stránku Upozornenia v administrátorovi Shopify.
Ak potrebujete pomoc so zložitejšími zmenami alebo ak chcete vykonať zmeny vo vlastných šablónach upozornení, môžete sa obrátiť na komunitu na našich fórach alebo si môžete najať Partnera Shopify, ktorý pre vás prispôsobenia urobí. Ďalšie informácie o najatí Partnera Shopify.
Na tejto stránke
- Vlastnosti objednávky
- Vlastnosti konceptu objednávky
- Vlastnosti plánu platieb
- Vlastnosti stavu platby
- Vlastnosti komponentu balíka produktov
- Vlastnosti komponentu
- Vlastnosti samostatnej položky
- Vlastnosti skupiny samostatných položiek
- Vlastnosti vrátenia peňazí
- Vlastnosti plnenia
- Vlastnosti pripraveného balíka
- Vlastnosti doručenia
- Vlastnosti zľavy
- Vlastnosti predplatného
- Vlastnosti e-mailového upozornenia
- Vlastnosti kreditu v obchode
Vlastnosti objednávky
Mnohé vlastnosti objednávky sú k dispozícii priamo prostredníctvom jazyka Liquid a v šablónach.
| Vlastnosť | Opis |
|---|---|
id |
Celosystémové jedinečné ID objednávky na interné použitie. Pomocou nasledujúceho príkladu vygenerujete odkaz na objednávku v sekcii administrátora vo vašom obchode. Napríklad do šablóny Nová objednávka môžete pridať tento kód: Zobraziť objednávku
|
email | E-mail spojený s objednávkou. |
name |
Zvyčajne ide o znak mriežky, za ktorým nasleduje Príklad: #1004 |
order_name | Rovnaké ako názov. |
order_number |
Jedinečné číslo objednávky v obchode bez predpony mriežky # alebo akejkoľvek predpony či prípony, ktorú vlastník obchodu pridal k ID objednávky v nastaveniach obchodu. Príklad: 1004 |
confirmation_number | Náhodne vygenerovaný alfanumerický identifikátor objednávky, ktorý sa môže zákazníkovi zobraziť namiesto sekvenčného názvu objednávky. Pri tejto hodnote nie je zaručené, že bude jedinečná. Príklad: XPAV284CT |
created_at |
Dátum a čas vytvorenia objednávky zákazníkom. Tento údaj môžete naformátovať pomocou filtra dátumov. Príklad: 2009-05-30T17:43:51+02:00 |
payment_terms |
Platobné podmienky určujú dátum splatnosti platby za objednávku. Zistite, ako pridať platobné podmienky do faktúr k objednávkam. Ďalšie podrobnosti nájdete v referenčnej dokumentácii jazyka Liquid pre vlastnosť payment_terms. |
destination | Destinácia, kam sa majú odoslať položky. |
tags | Vráti pole všetkých štítkov objednávky. Štítky sa vracajú v abecednom poradí. Štítky, ktoré sa aplikujú dynamicky pomocou aplikácií alebo funkcií platformy, napríklad štítok Shopify Collective, nemusia byť pri generovaní e-mailového upozornenia k dispozícii. Ak chcete detegovať položky z konkrétnej funkcie, skontrolujte štítky na úrovni produktu pri každej samostatnej položke. Ďalšie podrobnosti nájdete v referenčnej dokumentácii jazyka Liquid. |
transactions | Vráti pole transakcií z objednávky. |
tax_price | Kombinované dane všetkých položiek v objednávke. |
tax_lines |
Dane rozdelené podľa typu zdanenia:
{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }} %) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_line.title | Názov dane. Napríklad QST alebo DPH. |
tax_line.price | Výška dane. |
tax_line.rate | Daňová sadzba vo forme desatinného čísla. Ak ide o sadzbu 17,5 %, vráti sa hodnota 0.175. |
tax_line.rate_percentage | Daňová sadzba v podobe čitateľnej pre ľudí. Ak je sadzba 0.175, vráti hodnotu 17.5. |
customer | Objekt zákazníka obsahujúci atribúty výstupu customer. |
billing_address | Fakturačná adresa. |
billing_address.first_name | Krstné meno zákazníka. |
billing_address.last_name | Priezvisko zákazníka. |
billing_address.company | Názov spoločnosti na fakturáciu. |
billing_address.phone | Telefónne číslo z fakturačnej adresy. |
shop.name | Názov obchodu. |
shop.phone | Telefónne číslo obchodu. |
subtotal_price | Súčet cien samostatných položiek objednávky po odpočítaní akejkoľvek zľavy na samostatnú položku alebo zľavy na košík. Medzisúčet nezahŕňa dane (pokiaľ nie sú zahrnuté v cenách), náklady na dopravu ani prepitné. |
discounts | Zoznam zliav. |
discounts_amount | Celková suma všetkých uplatnených zliav. Príklad: +5,00 $ |
discounts_savings | Výška úspor zo všetkých zliav. Príklad: -5,00 $ |
total_price |
Celková suma objednávky (medzisúčet + náklady na dopravu - zľava na dopravu + daň). |
financial_status | Aktuálny stav platby. Môže ísť o: nil, pending, authorized, paid, voided, refunded. |
requires_shipping | (boolean) Vráti hodnotu true, ak sa v objednávke nachádza aspoň jedna položka, ktorá vyžaduje dopravu. |
shipping_method.title | Názov sadzby za dopravu. V notifikáciách pre zákazníka je názov sadzby za dopravu preložený do jazyka, v ktorom zákazník prešiel pokladňou, ak sa tento jazyk líši od predvoleného jazyka obchodu. Príklad: Štandardná doprava |
shipping_method.price |
Cena dopravy vrátane akejkoľvek zľavy na dopravu. Príklad: |
shipping_price |
Cena dopravy. Príklad: |
shipping_address | Dodacia adresa. |
shipping_address.first_name | Krstné meno pre dodaciu adresu. |
shipping_address.company | Názov spoločnosti pre dodaciu adresu. |
shipping_address.phone | Telefónne číslo z dodacej adresy. |
line_items | Zoznam všetkých samostatných položiek v objednávke. |
line_items_including_zero_quantity | Zoznam všetkých samostatných položiek v objednávke vrátane tých s nulovým množstvom. Samostatné položky majú nulové množstvo, ak boli kompletne refundované. |
line_item_groups(Orders and POS only) | Zoznam všetkých skupín samostatných položiek obsahujúcich komponenty samostatnej položky v objednávke. |
item_count | Súčet množstiev všetkých položiek. |
fulfillment_status | Aktuálny stav vybavenia objednávky. Môže ísť o: unfulfilled, partial, fulfilled. |
note | Poznámka priložená k objednávke. Poznámku môžete získať od zákazníka alebo ju upraviť na obrazovke podrobností o objednávke v administrátorskom paneli. |
attributes |
Akékoľvek atribúty priložené k objednávke. Príklad: |
metafields |
Akékoľvek metapolia v objednávke. Použite nasledujúcu syntax: metafields.NAMESPACE.KEY |
referring_site |
Obsahuje URL adresu odkazujúceho zdroja, ktorý priviedol zákazníka do vášho obchodu. Príklad: |
landing_site |
Obsahuje cestu k vstupnej stránke, ktorú zákazník použil. Ide o prvú stránku, ktorú zákazník pri návšteve obchodu uvidí. Príklad: |
landing_site_ref |
Skontroluje vstupnú stránku a extrahuje z nej referenčný parameter. Referenčné parametre môžu byť: Ak je hodnota
{% if landing_site_ref == 'my-tracking-token' %}
Moja akcia...
{% endif %}
|
cancelled | (boolean) Vráti hodnotu true, ak bola objednávka zrušená. |
cancelled_at | Čas, kedy bola objednávka zrušená. |
cancel_reason | Dôvod vybraný pri zrušení objednávky. Môže ísť o: inventory, customer, declined, fraud alebo other. |
has_high_risks?(deprecated) | Vráti hodnotu true, ak je objednávka vysoko riziková |
unique_gateways |
Vráti zoznam jedinečných poskytovateľov platieb v objednávke. Ak napríklad niekto zaplatil kartou Visa, Mastercard a v hotovosti, vrátený zoznam bude |
location(POS only) |
Zobrazuje fyzickú lokalitu objednávky. K dispozícii je niekoľko vlastností lokality uvedených tu. Lokality môžete nakonfigurovať v časti Lokality v administrátorskom paneli. |
order_status_url |
Vráti odkaz na stránku stavu objednávky pre túto objednávku. |
fulfilled_line_items(deprecated) | Zoznam samostatných položiek, ktoré boli vybavené. |
unfulfilled_line_items(deprecated) | Zoznam samostatných položiek, ktoré neboli kompletne vybavené. |
b2b? |
Vráti hodnotu true, ak ide o objednávku B2B. Túto vlastnosť s premennými B2B môžete použiť na zobrazenie relevantných informácií v e-mailoch, ako sú názov spoločnosti, lokalita spoločnosti a adresa. Napríklad do objednávok B2B môžete pridať hlavičku do šablóny s nasledujúcimi informáciami:
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | Spoločnosť, ktorej predávate v rámci objednávky B2B. |
company.name | Názov spoločnosti v rámci objednávky B2B. |
company.id | ID spoločnosti v rámci objednávky B2B. |
company_location | Lokalita spoločnosti v rámci objednávky B2B. Spoločnosť, ktorá od vás nakupuje, môže mať viac ako jednu lokalitu. |
company_location.name | Názov lokality spoločnosti v rámci objednávky B2B. |
company_location.id | Identifikačné číslo lokality spoločnosti v rámci objednávky B2B. |
company_location.shipping_address | Dodacia adresa lokality spoločnosti v rámci objednávky B2B. |
company_location.billing_address | Fakturačná adresa lokality spoločnosti v rámci objednávky B2B. |
customer_order_url | Nová stránka stavu objednávky pre objednávku, u ktorej zákazník požiadal o vrátenie prostredníctvom zákazníckych účtov. |
Vlastnosti návrhu objednávky
| Vlastnosť | Opis |
|---|---|
id | Jedinečné ID návrhu objednávky na interné použitie. |
invoice_url | Odkaz, na ktorý môže zákazník kliknúť a zaplatiť faktúru prostredníctvom zabezpečenej pokladne Shopify. |
reserve_inventory_until |
Dátum a čas, do ktorého sú samostatné položky v návrhu rezervované, napríklad Dátumy môžete formátovať pomocou filtra dátumov jazyka Liquid. |
user | Posledný člen personálu, ktorý upravil návrh objednávky. |
user.name | Meno posledného člena personálu, ktorý upravil návrh objednávky. |
user.email | E-mailová adresa posledného člena personálu, ktorý upravil návrh objednávky. |
email | E-mailová adresa priradená k návrhu objednávky. |
name | Jedinečné number návrhu objednávky, pred ktorým je znak mriežky #. |
number | Jedinečné číslo návrhu objednávky bez predpony alebo prípony objednávky. |
created_at |
Dátum a čas, kedy zákazník vytvoril návrh objednávky, napríklad Dátumy môžete formátovať pomocou filtra dátumov jazyka Liquid. |
tags | Vráti pole so všetkými štítkami objednávky. Štítky sa vracajú v abecednom poradí. Ďalšie podrobnosti nájdete v referenčnej dokumentácii jazyka Liquid. |
tax_price | Kombinované dane všetkých položiek v návrhu objednávky. |
tax_lines |
Dane rozdelené podľa typu dane:
{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_line.title | Názov dane. Príklady: QST alebo DPH |
tax_line.price | Suma dane. |
tax_line.rate | Daňová sadzba v desatinnom tvare. Napríklad pri daňovej sadzbe 17,5 % sa vráti hodnota 0.175. |
tax_line.rate_percentage | Daňová sadzba v percentuálnom tvare. Napríklad pri hodnote rate 0,175 sa vráti hodnota 17.5. |
customer | Objekt zákazníka obsahujúci atribúty výstupu customer. |
billing_address | Fakturačná adresa pre návrh objednávky. |
billing_address.first_name | Krstné meno zákazníka. |
billing_address.last_name | Priezvisko zákazníka. |
billing_address.company | Názov spoločnosti vo fakturačnej adrese. |
billing_address.phone | Telefónne číslo vo fakturačnej adrese. |
shop.name | Názov vášho obchodu. |
shop.phone | Telefónne číslo obchodu. |
subtotal_price | Súčet cien riadkových položiek návrhu objednávky po odpočítaní akejkoľvek zľavy na riadkovú položku alebo zľavy na košík. Medzisúčet nezahŕňa dane (pokiaľ nie sú dane zahrnuté v cenách) ani náklady na dopravu. |
discounts | Zoznam zliav. |
discounts_amount | Celková suma uplatnených zliav. Príklad: +5,00 $ |
discounts_savings | Celková úspora zo všetkých zliav. Príklad: -5,00 $ |
total_price | Celková cena objednávky (medzisúčet + náklady na dopravu – zľava na dopravu + daň). |
amount_due_now | Suma požadovaná na faktúre za návrh objednávky. |
requires_shipping | Vráti hodnotu true , ak je v návrhu objednávky aspoň jedna položka vyžadujúca dopravu. Vráti hodnotu false , ak žiadne položky v návrhu objednávky nevyžadujú dopravu. |
shipping_method.title | Názov sadzby za dopravu. Príklad: Štandardná doprava |
shipping_method.price | Cena spôsobu dopravy. Vráti rovnaké informácie ako atribút shipping_price. |
shipping_price |
Cena dopravy. Túto sumu môžete formátovať pomocou peňažných filtrov jazyka Liquid. |
shipping_address |
Poznámka: Na rozdiel od bežných objednávok môže byť dodacia adresa pri návrhu objednávky neúplná. |
shipping_address.first_name | Krstné meno pre dodaciu adresu. |
shipping_address.company | Názov spoločnosti v dodacej adrese. |
shipping_address.phone | Telefónne číslo v dodacej adrese. |
line_items | Zoznam všetkých riadkových položiek v návrhu objednávky. |
item_count | Súčet množstiev všetkých položiek v návrhu objednávky. |
note | Poznámka pripojená k návrhu objednávky. Poznámku môžete získať od zákazníka a môžete ju upraviť aj na obrazovke s podrobnosťami o návrhu objednávky u administrátora Shopify. |
metafields |
Všetky metapolia návrhu objednávky. Použite nasledujúcu syntax: metafields.NAMESPACE.KEY |
location |
Fyzická lokalita objednávky. K dispozícii je niekoľko vlastností lokalít. Lokality môžete nakonfigurovať na stránke Lokality u administrátora Shopify. |
b2b? |
Vráti hodnotu true, ak ide o objednávku B2B. Túto vlastnosť s premennými B2B môžete použiť na zobrazenie relevantných informácií v e-mailoch, ako sú názov spoločnosti, lokalita spoločnosti a adresa. Napríklad do objednávok B2B môžete pridať hlavičku do šablóny s nasledujúcimi informáciami:
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | Spoločnosť, ktorej predávate v rámci objednávky B2B. |
company.name | Názov spoločnosti v rámci objednávky B2B. |
company.id | ID spoločnosti v rámci objednávky B2B. |
company_location | Lokalita spoločnosti v rámci objednávky B2B. Spoločnosť, ktorá od vás nakupuje, môže mať viac ako jednu lokalitu. |
company_location.name | Názov lokality spoločnosti v rámci objednávky B2B. |
company_location.id | Identifikačné číslo lokality spoločnosti v rámci objednávky B2B. |
company_location.shipping_address | Dodacia adresa lokality spoločnosti v rámci objednávky B2B. |
company_location.billing_address | Fakturačná adresa lokality spoločnosti v rámci objednávky B2B. |
payment_methods | Zoznam uložených spôsoboch platby, ktoré sú k dispozícii na spracovanie celkovej sumy návrhu objednávky. |
payment_method.payment_instrument | Platobný nástroj, ktorý obsahuje podrobnosti o uloženom spôsobe platby. |
payment_method.payment_instrument.payment_type | Typ uloženého spôsobu platby. Napríklad „credit_card, apple_pay“ |
payment_method.payment_instrument.credit_card_brand | Značka karty, keď je `payment_type` nastavený na „credit_card“ |
payment_method.payment_instrument.credit_card_company | Kartová spoločnosť, keď je `payment_type` nastavený na „credit_card“ |
payment_method.payment_instrument.credit_card_company | Posledné 4 číslice karty, keď je `payment_type` nastavený na „credit_card“ |
Vlastnosti splátkového kalendára
| Vlastnosť | Opis |
|---|---|
payment_schedule.amount_due |
Suma, ktorú je potrebné zaplatiť pre splátkový kalendár. Sumy s menami môžete formátovať pomocou peňažného filtra jazyka Liquid. |
payment_schedule.due_at |
Dátum splatnosti pre splátkový kalendár. Dátumy môžete formátovať pomocou filtra dátumov jazyka Liquid. |
payment_schedule.due_in_days |
Počet dní do dátumu splatnosti, ak je splátkový kalendár stále splatný (nezaplatený). |
payment_schedule.due_later? |
Vráti hodnotu true, ak splátkový kalendár nebol zaplatený a jeho dátum splatnosti je v budúcnosti. |
payment_schedule.number_of_days_overdue? |
Počet dní od dátumu splatnosti, keď je splátkový kalendár po splatnosti. |
payment_schedule.overdue? |
Vráti hodnotu true, ak splátkový kalendár nebol zaplatený a je po dátume splatnosti. |
Vlastnosti stavu platby
| Vlastnosť | Opis |
|---|---|
has_pending_payment |
(logická hodnota) Vráti hodnotu true, ak má objednávka transakciu s čakajúcou platbou. Ďalšie informácie o čakajúcich platbách. |
buyer_action_required |
(logická hodnota) Vráti hodnotu true, ak má objednávka transakciu s čakajúcou platbou a na odblokovanie platby sa vyžaduje akcia zo strany kupujúceho. Keď táto hodnota vráti true a spôsob platby podporuje pokyny na platbu, vlastnosť Ďalšie informácie o objekte transakcie jazyka Liquid. |
Vlastnosti súčasti balíka
Každá súčasť bundle_component v zozname line_item.bundle_components má nasledujúce vlastnosti. (Iba návrhy objednávok)
| Vlastnosť | Opis |
|---|---|
bundle_component.image_url | URL adresa obrázka súčasti balíka. |
bundle_component.product.title | Názov produktu súčasti balíka. |
bundle_component.quantity | Množstvo pre súčasť balíka. |
bundle_component.variant.title | Aktuálne názvy hodnôt možností variantu súčasti balíka, spojené znakmi Príklad: malý / red |
Vlastnosti komponentu
Každý objekt component v zozname line_item.components má nasledujúce vlastnosti. (Len pre opustenú pokladňu)
`
| Vlastnosť | Opis |
|---|---|
component.image_url | URL adresa obrázka komponentu. |
component.product.title | Názov produktu komponentu. |
component.quantity | Množstvo pre komponent. |
component.variant.title | Aktuálne názvy hodnôt možností variantu komponentu, spojené znakom Príklad: malý / red |
Vlastnosti samostatnej položky
Každý objekt line v zozname line_items alebo subtotal_line_items má nasledujúce vlastnosti.
| Vlastnosť | Opis |
|---|---|
line.applied_discounts(POS and draft orders only) | Zoznam zliav uplatnených na túto položku (každá zľava má vlastnosti title, code, amount, savings a type). |
line.bundle_components(Draft orders only) | Zoznam samostatných položiek, ktoré sú komponentmi balíka pre túto položku. Zoznam sa vráti, len ak je táto samostatná položka produkt vo forme balíka. |
line.bundle_parent?(Draft orders only) | (boolean) Vráti hodnotu true, ak je samostatná položka produkt vo forme balíka. |
line.components(Abandoned checkout only) | Zoznam samostatných položiek, ktoré sú komponentmi tejto položky. |
line.parent?(Abandoned checkout only) | (boolean) Vráti hodnotu true, ak má samostatná položka komponenty. |
line.custom(Draft orders only) | (boolean) Vráti hodnotu true, ak je položka vlastnou samostatnou položkou pre návrh objednávky. |
line.delivery_agreement | Zmluva o doručení priradená k tejto samostatnej položke. |
line.grams | Hmotnosť jednej položky. |
line.groups | Skupina samostatných položiek pre túto položku. |
line.image | Vráti URL adresu obrázka priradeného k tejto samostatnej položke. Na získanie konkrétnych veľkostí obrázkov môžete použiť aj filter img_url, napríklad {{ line.image | img_url: 'small' }} |
line.line_price | Cena vynásobená množstvom danej položky. |
line.original_line_price | Celková cena za množstvo položiek v samostatnej položke pred uplatnením zliav. |
line.final_line_price | Celková cena všetkých položiek v samostatnej položke vrátane všetkých súm zliav na úrovni položky. |
line.pre_tax_price | Cena za samostatné položky bez dane vynásobená množstvom zakúpenej samostatnej položky. |
line.price | Cena za jednu položku. |
line.product.metafields | Akékoľvek metapolia na úrovni produktu. Použite nasledujúcu syntax: line.product.metafields.NAMESPACE.KEY |
line.product.title | Aktuálny názov produktu. |
line.product.vendor | Dodávateľ položky. |
line.properties | Vráti pole vlastných informácií pre položku. Vlastnosti samostatnej položky špecifikuje zákazník na stránke produktu pred pridaním produktu do košíka. |
line.quantity | Množstvo pre danú položku. |
line.current_quantity | Aktuálne množstvo položky po odstráneniach. |
line.requires_shipping | (boolean) Vráti hodnotu true, ak má variant pre položku na stránke produktu aktivované nastavenie Fyzický produkt. |
line.selling_plan_allocation | Vráti objekt selling_plan_allocation, ktorý opisuje, aký vplyv má plán predaja, ako napríklad predplatné, na samostatnú položku. |
line.taxable | (boolean) Vráti hodnotu true, ak má variant pre položku na stránke produktu zaškrtnuté zaškrtávacie políčko „Účtovať dane z tohto produktu“. |
line.title | Názov produktu v čase predaja, po ktorom nasleduje pomlčka a názov variantu v čase predaja. Názov variantu nie je zahrnutý, ak ide o „Default Title“. V upozorneniach pre zákazníkov sa názov produktu a názov variantu prekladajú do jazyka, ktorý zákazník použil v pokladni, ak sa tento jazyk líši od predvoleného jazyka obchodu. |
line.url | Relatívna URL adresa variantu samostatnej položky. Relatívna URL adresa nezahŕňa koreňovú URL adresu vášho obchodu (mystore.myshopify.com). |
line.variant.barcode | Čiarový kód priradený k variantu produktu. |
line.variant.compare_at_price | Pôvodná cena priradená k variantu produktu. |
line.variant.image | Obrázok pre variant produktu. Obrázok vráti len vtedy, ak je v samostatnej položke k variantu priradený konkrétny obrázok. |
line.variant.metafields | Akékoľvek metapolia na úrovni variantu. Použite nasledujúcu syntax: line.variant.metafields.NAMESPACE.KEY |
line.variant.sku | SKU priradené k variantu produktu. |
line.variant.title | Aktuálne názvy hodnôt možností variantu, spojené znakom Príklad: malý / red |
line.refunded.quantity(within refund notifications) | Množstvo položky, za ktoré sa majú vrátiť peniaze. Túto vlastnosť môžete použiť na pridanie identifikátora k položkám v objednávke, za ktoré sa vracajú peniaze. Napríklad: |
Zistenie položiek Shopify Collective v šablónach upozornení
Štítok Shopify Collective sa na objednávku aplikuje po odoslaní e-mailu s potvrdením objednávky, takže {% if tags contains 'Shopify Collective' %} nie je v šablóne potvrdenia objednávky nikdy true. Ak chcete zistiť položky Shopify Collective, radšej skontrolujte štítky na úrovni produktu pre každú samostatnú položku:
{% 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 %}Vlastnosti skupiny samostatných položiek
Každý objekt line_item_group v zozname line_item_groups má nasledujúce vlastnosti.
| Vlastnosť | Opis |
|---|---|
line_item_group.display_title | Názov skupiny samostatných položiek. |
line_item_group.components | Zoznam komponentov samostatnej položky patriacich do skupiny. |
line_item_group.image | Obrázok skupiny samostatných položiek. |
line_item_group.product_id | ID produktu pre skupinu samostatných položiek. |
line_item_group.variant | Objekt variantu skupiny samostatných položiek. |
line_item_group.variant_id | ID variantu pre skupinu samostatných položiek. |
Vlastnosti vrátení peňazí
| Vlastnosť | Opis |
|---|---|
amount | Suma vrátených peňazí. |
refund_line_items | Zoznam samostatných položiek vrátenia peňazí, za ktoré sa majú vrátiť peniaze. |
Vlastnosti Refund_line_item
Každý objekt refund_line v zozname refund_line_items má nasledujúce vlastnosti:
| Vlastnosť | Opis |
|---|---|
refund_line.line_item | Položka line_item, za ktorú sa vracajú peniaze. Má prístup ku všetkým vlastnostiam položky line_item. |
refund_line.quantity | Množstvo samostatnej položky, za ktoré sa majú vrátiť peniaze. |
Vlastnosti naplnenia
| Vlastnosť | Opis |
|---|---|
service_name | Názov vlastnej služby definovaný na stránke Nastavenia > Doprava a doručovanie. (Iba pre žiadosť o plnenie) |
fulfillment.estimated_delivery_at | Odhadovaný dátum doručenia na základe sledovacieho čísla (ak je k dispozícii), ktoré poskytol jeden z nasledujúcich prepravcov: USPS, FedEx, UPS, Kanadská pošta (iba Kanada). Táto vlastnosť je dostupná iba vtedy, keď sa používajú sadzby vypočítané prepravcom. |
fulfillment.fulfillment_line_items | Zoznam samostatných položiek naplnenia, ktoré sa majú naplniť. |
fulfillment.item_count | Súčet množstiev všetkých položiek. Celkový počet napĺňaných položiek. |
fulfillment.requires_shipping | (booleovská hodnota) Vráti hodnotu true, ak táto žiadosť o vybavenie vyžaduje dopravu. |
fulfillment.tracking_company | Spoločnosť, ktorá zabezpečuje sledovanie. |
fulfillment.tracking_numbers | Zoznam sledovacích čísel. |
fulfillment.tracking_urls | Zoznam URL na sledovanie. |
items_to_fulfill(deprecated) | Zoznam samostatných položiek, ktoré má naplniť táto konkrétna služba plnenia objednávok na mieru. (Iba žiadosť o vybavenie) |
items_to_fulfill_count(deprecated) | Celkový počet položiek, ktoré sa majú naplniť touto žiadosťou. (Iba žiadosť o vybavenie) |
Vlastnosti objektu fulfillment_line_item
Každý objekt fulfillment_line v zozname fulfillment_line_items má nasledujúce vlastnosti.
| Vlastnosť | Opis |
|---|---|
fulfillment_line.line_item | Napĺňaná položka line_item. Má prístup ku všetkým vlastnostiam položky line_item. |
fulfillment_line.quantity | Množstvo samostatnej položky, ktorá sa napĺňa. |
Vlastnosti pripraveného balíka
Pripravený balík obsahuje položky označené ako pripravené na vyzdvihnutie.
| Vlastnosť | Opis |
|---|---|
item_count | Súčet všetkých množstiev položiek v pripravenom balíku. |
prepared_package_line_items | Zoznam samostatných položiek pripraveného balíka. |
Vlastnosti objektu prepared_package_line_item
Každý objekt prepared_package_line_item v zozname prepared_package_line_items má nasledujúce vlastnosti.
| Vlastnosť | Opis |
|---|---|
line_item | Súvisiaca položka line_item. Má prístup ku všetkým vlastnostiam položky line_item. |
quantity | Množstvo samostatnej položky, ktorá bola označená ako pripravená na vyzdvihnutie. |
Vlastnosti doručenia
| Vlastnosť | Opis |
|---|---|
delivery_agreements | Zoznam všetkých dohôd o doručení pre objednávku. |
delivery_instructions | Informácie o miestnom doručení, ktoré sa majú zdieľať so zákazníkom. Tieto informácie sa ovládajú prostredníctvom poľa Informácie o doručení v nastaveniach miestneho doručenia. |
consolidated_estimated_delivery_time | Informácie o dátumoch doručenia objednávky, ktoré sa majú zdieľať so zákazníkom. Tieto informácie sa ovládajú nastavením Čas spracovania, ktoré nastavíte na stránke Doprava a doručenie. Ak má objednávka viacero spôsobov doručenia, zobrazí sa zoznam spôsobov a dátumov doručenia. |
has_multiple_delivery_methods | (booleovská hodnota) Vráti hodnotu true, ak má objednávka viacero spôsobov doručenia. |
Vlastnosti dohody o doručení
| Vlastnosť | Opis |
|---|---|
delivery_agreement.delivery_method_type | Typ spôsobu doručenia. |
delivery_agreement.delivery_method_name | Typ spôsobu doručenia preložený do jazyka, v ktorom kupujúci dokončil nákup, ak sa tento jazyk líši od predvoleného jazyka obchodu. |
delivery_agreement.line_item_groups | Zoznam všetkých skupín samostatných položiek obsahujúcich komponenty samostatných položiek produktového balíka v dohode o doručení. |
delivery_agreement.line_items | Zoznam všetkých samostatných položiek spojených s touto dohodou o doručení. |
Vlastnosti zľavy
Existujú dva typy vlastností zľavy.
discount_applications popisujú, prečo a ako bola položka zľavnená.
discount_allocations popisujú, ako konkrétna zľava ovplyvňuje samostatnú položku a ako znižuje cenu. Túto vlastnosť by ste mali použiť na úrovni samostatnej položky.
Tieto vlastnosti môžete skombinovať na zobrazenie informácií o zľave na úrovni samostatnej položky alebo objednávky.
Príklad
Tento príklad kontroluje, či bola na samostatnú položku uplatnená zľava. Ak sa zľava neuplatnila na úrovni objednávky (all), zobrazí sa meno zľavy a jej výška.
{% 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 %}Výsledok môže byť podobný tomuto:
SPRING5 (-$5.00)Vlastnosti objektu discount_allocation
Každý objekt discount_allocation v zozname discount_allocations má nasledujúce vlastnosti.
| Vlastnosť | Opis |
|---|---|
discount_allocation.amount | Suma peňazí, ktorú zákazník ušetril na samostatnej položke. Musí sa zadať do slučky, ak chcete povoliť viacero zľavových kódov. |
discount_allocation.discount_application | Uplatnenie zľavy, ktoré prideľuje sumu na samostatnú položku. |
Vlastnosti objektu discount_application
Každý objekt discount_application v zozname discount_applications má nasledujúce vlastnosti.
| Vlastnosť | Opis |
|---|---|
discount_application.target_selection |
Popisuje, ako zľava vyberá samostatné položky v košíku, na ktoré sa má zľava uplatniť. Jedna z možností:
|
discount_application.target_type | Typ položky, na ktorú sa zľava uplatňuje (line_item alebo shipping_line). |
discount_application.title | Meno zľavy zobrazené zákazníkom. Príklady: Welcome10 alebo CBBWQQAKYBYY |
discount_application.total_allocated_amount | Celková suma, o ktorú sa cena objednávky zníži na základe zľavy. |
discount_application.type | Typ zľavy. Jedna z možností: automatic, discount_code, manual alebo script. |
discount_application.value | Hodnota zľavy. |
discount_application.value_type | Typ hodnoty zľavy. Jedna z možností: fixed_amount alebo percentage. |
Vlastnosti predplatného
Podrobnosti o zmluve o predplatnom, aktuálnom fakturačnom období, jeho samostatných položkách, spôsobe doručenia a spôsobe platby sú dostupné pre všetky šablóny e-mailov o predplatnom.
Ak chcete upraviť šablóny upozornení na predplatné, nainštalujte si aplikáciu Shopify Subscriptions a následne šablónu nájdete v časti Nastavenia > Upozornenia v sekcii Subscriptions.
Vlastnosti fakturačného obdobia zmluvy o predplatnom
Na prístup k vlastnostiam zmluvy o predplatnom a jej fakturačného obdobia použite objekt subscription_contract_billing_cycle.
Príklad
{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.Výsledok:
This contract is currently paused.Vlastnosti
| Vlastnosť | Opis |
|---|---|
status |
Stav zmluvy. Jedna z možností: active, paused, cancelled, failed, expired, stale,
|
delivery_method |
Spôsob doručenia predplatného. Ak ide o predplatné pre službu alebo digitálny produkt, vráti sa hodnota nil.
|
billing_frequency | Ako často sa predplatné účtuje. |
delivery_frequency | Ako často sa predplatné doručuje. |
origin_order |
Pôvodná objednávka, ktorou sa predplatné vytvorilo. Ak predplatné nevzniklo z objednávky v službe Shopify, vráti sa hodnota nil.
|
customer | Zákazník s predplatným. |
line_items | Samostatné položky vo fakturačnom období predplatného. |
product_names | Zoznam názvov produktov zahrnutých vo fakturačnom období predplatného. |
update_payment_method_url | Adresa URL, ktorú môže zákazník použiť na aktualizáciu spôsobu platby pre túto zmluvu. |
shipping_address |
Dodacia adresa predplatného. Ak ide o predplatné pre službu alebo digitálny produkt, vráti sa hodnota nil.
|
billing_address | Fakturačná adresa predplatného. |
subtotal_price | Medzisúčet cien samostatných položiek predplatného. |
shipping_price | Cena dopravy za predplatné. |
total_tax | Celková daň predplatného. |
total_price | Celková cena predplatného. |
total_discounts | Celkové zľavy predplatného. |
customer_self_serve_url | Samoobslužná adresa URL, pomocou ktorej môže zákazník spravovať svoje predplatné. |
billing_attempt_expected_date | Dátum fakturácie pre toto fakturačné obdobie. |
next_billing_date | Ďalší nepreskočený dátum fakturácie po tomto fakturačnom období. |
last_attempted_billing_date | Posledný dátum pokusu o fakturáciu pre toto fakturačné obdobie. |
days_overdue | Počet dní po splatnosti fakturácie pre toto fakturačné obdobie. |
payment_instrument | Platobný nástroj priradený k zmluve o predplatnom. Tento platobný nástroj sa používa na vyúčtovanie zákazníkovi. |
Vlastnosti samostatnej položky zmluvy o predplatnom
Vlastnosti každej samostatnej položky zahrnutej vo fakturačnom období. Vlastnosti samostatnej položky zmluvy sú dostupné prostredníctvom nadradenej vlastnosti subscription_contract_billing_cycle.line_items.
Príklad
{% for line_item in subscription_contract_billing_cycle.line_items %}
{{ line_item.url }}
{% endfor %}| Vlastnosť | Opis |
|---|---|
url | Adresa URL stránky s podrobnosťami o produkte pre variant produktu v samostatnej položke. |
requires_shipping | Či samostatná položka vyžaduje fyzickú dopravu. |
unit_price_measurement | Merná jednotka pre jednotkovú cenu samostatnej položky. |
selling_plan_allocation | Pridelenie plánu predaja samostatnej položky. |
Vlastnosti spôsobu doručenia pre zmluvu o predplatnom
Vlastnosti pre spôsob doručenia použitý v tomto fakturačnom období. Vlastnosti spôsobu doručenia sú dostupné prostredníctvom nadradenej vlastnosti subscription_contract_billing_cycle.delivery_method.
Príklad
{% if subscription_contract_billing_cycle.delivery_method != blank %}
Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}| Vlastnosť | Opis |
|---|---|
title | Názov možnosti dopravy priradenej k spôsobu doručenia. |
type |
Typ spôsobu doručenia. Jedna z možností: shipping, local alebo pick-up.
|
Vlastnosti platobného nástroja zmluvy o predplatnom
Podrobnosti o platobnom nástroji pre zmluvu o predplatnom. Tento platobný nástroj sa používa na vyúčtovanie zákazníkovi. Vlastnosti platobného nástroja sú dostupné prostredníctvom nadradenej vlastnosti subscription_contract_billing_cycle.payment_instrument.
Príklad
{% 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 }}| Vlastnosť | Opis |
|---|---|
payment_type |
Typ spôsobu platby, ktorý predstavuje platobný nástroj. Na zobrazenie adresy URL obrázka alebo formátu SVG použite filtre platieb. |
credit_card_brand | Značka kreditnej karty. |
credit_card_company | Názov spoločnosti, ktorá vydala kreditnú kartu. |
credit_card_last_four_digits | Posledné 4 číslice kreditnej karty. |
Vlastnosti e-mailových upozornení
| Vlastnosť | Opis |
|---|---|
shop.email_logo_url | Adresa URL pre logo zadané v sekcii Prispôsobenie šablón e-mailov v administrátorskom paneli. |
shop.email_logo_width | Šírka loga (v pixeloch) zadaná v sekcii Prispôsobenie šablón e-mailov v administrátorskom paneli. |
shop.email_accent_color | Kód HEX pre farbu zvýraznenia zadanú v sekcii Prispôsobenie šablón e-mailov v administrátorskom paneli. |
Vlastnosti kreditu v obchode
Vlastnosti s podrobnosťami o vydaní kreditu v obchode.
| Vlastnosť | Opis |
|---|---|
issued_store_credit.amount |
Suma vydaného kreditu v obchode. Túto sumu môžete formátovať pomocou peňažných filtrov jazyka Liquid. |
issued_store_credit.expires_at |
Dátum a čas uplynutia platnosti vydaného kreditu v obchode. Túto sumu môžete formátovať pomocou filtrov dátumu jazyka Liquid. |
issued_store_credit.balance_after_transaction |
Zostatok na zákazníckom kreditnom účte po vydaní kreditu. Túto sumu môžete formátovať pomocou peňažných filtrov jazyka Liquid. |
customer | Objekt zákazníka obsahujúci atribúty výstupu customer. |