Referenca spremenljivk za obvestila
Obvestila, poslana iz vaše trgovine, so izpisana z uporabo jezika Liquid. Liquid je preprost programski jezik družbe Shopify, ki je enostaven za uporabo. Na istem programskem jeziku temeljijo teme iz tržnice Theme Store.
Če želite urediti obvestila, ki se pošiljajo iz vaše trgovine, lahko osnovno prilagodite predloge obvestil. Za dostop do celotnega seznama obvestil, ki jih lahko prilagodite, odprite stran Obvestila v skrbniku Shopify.
Za pomoč pri naprednejših spremembah ali pri spremembah predlog obvestil po meri se lahko obrnete na skupnost na naših forumih ali pa zaposlite partnerja Shopify Partner, ki bo prilagoditve opravil namesto vas. Več informacij o zaposlitvi partnerja Shopify Partner.
Na tej strani
- Lastnosti naročila
- Lastnosti osnutka naročila
- Lastnosti razporeda plačil
- Lastnosti stanja plačila
- Lastnosti komponent paketa
- Lastnosti komponente
- Lastnosti postavke
- Lastnosti skupine postavk
- Lastnosti vračil denarja
- Lastnosti izpolnitve
- Lastnosti pripravljenega paketa
- Lastnosti dostave
- Lastnosti popusta
- Lastnosti naročnine
- Lastnosti e-poštnih obvestil
- Lastnosti dobroimetja v trgovini
Lastnosti naročila
Veliko lastnosti naročila je neposredno na voljo prek jezika Liquid in v predlogah.
| Lastnost | Opis |
|---|---|
id |
Sistemsko enoličen ID naročila za notranjo uporabo. Naslednji primer uporabite, če želite ustvariti povezavo do naročila v skrbniškem delu trgovine. Na primer, v predlogi Novo naročilo lahko dodate naslednjo kodo: Ogled naročila
|
email | E-pošta, povezana z naročilom. |
name |
Običajno je to znak lora (#), ki mu sledi Primer: #1004 |
order_name | Isto kot ime. |
order_number |
Enolična številka naročila v trgovini, brez predpone z znakom lora (#) in vseh predpon ter pripon, ki jih je ID-ju naročila dodal lastnik trgovine v nastavitvah svoje trgovine. Primer: 1004 |
confirmation_number | Naključno ustvarjena alfanumerična oznaka naročila, ki bo stranki morda prikazana namesto zaporednega imena naročila. Ta vrednost ni nujno enolična. Primer: XPAV284CT |
created_at |
Datum in čas, ko je stranka ustvarila naročilo. To lahko oblikujete z uporabo filtra za datum. Primer: 2009-05-30T17:43:51+02:00 |
payment_terms |
Plačilni pogoji določajo datum, do katerega je treba plačati naročilo. Preberite, kako lahko na račune za naročila dodate plačilne pogoje. Za več podrobnosti si oglejte referenco Liquid za payment_terms. |
destination | Destinacija, kamor je treba poslati kose. |
tags | Vrne polje vseh oznak naročila. Oznake so vrnjene v abecednem vrstnem redu. Oznake, ki jih aplikacije ali funkcije platforme dinamično uporabljajo, kot je na primer oznaka Shopify Collective, pri ustvarjanju e-poštnega obvestila morda ne bodo na voljo. Če želite zaznati kose na podlagi določene funkcije, raje preverite oznake na ravni izdelka pri posamezni postavki. Za več podrobnosti si oglejte referenčno dokumentacijo Liquid. |
transactions | Vrne polje transakcij iz naročila. |
tax_price | Skupni davki vseh kosov v naročilu. |
tax_lines |
Davki, razdeljeni po vrsti obdavčitve:
{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }} %) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_line.title | Ime davka. Na primer QST ali DDV. |
tax_line.price | Znesek davka. |
tax_line.rate | Davčna stopnja kot decimalno število. Vrne 0.175, če je stopnja 17,5 %. |
tax_line.rate_percentage | Davčna stopnja v človeku berljivi obliki. Vrne 17.5, če je stopnja 0.175. |
customer | Objekt stranke, ki vsebuje lastnosti izpisa za stranko. |
billing_address | Naslov za izdajo računa. |
billing_address.first_name | Ime stranke. |
billing_address.last_name | Priimek stranke. |
billing_address.company | Ime podjetja za izdajo računa. |
billing_address.phone | Telefonska številka iz naslova za izdajo računa. |
shop.name | Ime vaše trgovine. |
shop.phone | Telefonska številka vaše trgovine. |
subtotal_price | Vsota cen postavk naročila po odštetju morebitnih popustov na postavko ali popustov v košarici. Vmesni seštevek ne vključuje davkov (razen če so davki vključeni v ceno), stroškov pošiljanja ali napitnin. |
discounts | Seznam popustov. |
discounts_amount | Znesek popusta, uveljavljen z vsemi popusti. Primer: +5,00 $ |
discounts_savings | Znesek prihranka, ki nastane zaradi vseh popustov. Primer: -5,00 $ |
total_price |
Skupni znesek naročila (vmesni seštevek + stroški pošiljanja - popust pri pošiljanju + davek). |
financial_status | Trenutni status plačila. Ena od naslednjih vrednosti: »nil«, pending, authorized, paid, voided, refunded. |
requires_shipping | (logična vrednost) Vrne »true«, če je v naročilu vsaj en kos, ki zahteva dostavo. |
shipping_method.title | Ime poštnine. V obvestilih za stranke je ime poštnine prevedeno v jezik, v katerem je stranka zaključila nakup, če se ta jezik razlikuje od privzetega jezika trgovine. Primer: Standardna dostava |
shipping_method.price |
Cena dostave, vključno z morebitnimi popusti pri pošiljanju. Primer: |
shipping_price |
Cena pošiljanja. Primer: |
shipping_address | Naslov za dostavo. |
shipping_address.first_name | Ime za naslov za dostavo. |
shipping_address.company | Ime podjetja za naslov za dostavo. |
shipping_address.phone | Telefonska številka iz naslova za dostavo. |
line_items | Seznam vseh postavk v naročilu. |
line_items_including_zero_quantity | Seznam vseh postavk v naročilu, vključno s tistimi s količino nič. Postavke imajo količino nič, ko je zanje v celoti izvedeno vračilo denarja. |
line_item_groups(Orders and POS only) | Seznam vseh skupin postavk, ki vsebujejo komponente postavk v naročilu. |
item_count | Vsota količin vseh kosov. |
fulfillment_status | Trenutno stanje izpolnitve naročila. Ena od naslednjih vrednosti: unfulfilled, partial, fulfilled. |
note | Opomba, ki je priložena naročilu. Opombo lahko pridobite od stranke in/ali uredite na zaslonu s podatki o naročilu v skrbniškem vmesniku. |
attributes |
Vsi atributi, ki so bili dodani naročilu. Primer: |
metafields |
Vsa metapolja v naročilu. Uporabite naslednjo sintakso: metafields.NAMESPACE.KEY |
referring_site |
Vsebuje URL napotitvenega vira, ki je stranko pripeljal v vašo trgovino. Primer: |
landing_site |
Vsebuje pot pristajalne strani, ki jo je uporabila stranka. To je prva stran, ki jo je stranka videla, ko je prispela v trgovino. Primer: |
landing_site_ref |
Pregleda pristajalno stran in iz nje izlušči referenčni parameter. Referenčni parametri so lahko: Če je
{% if landing_site_ref == 'my-tracking-token' %}
Moje dejanje …
{% endif %}
|
cancelled | (logična vrednost) Vrne »true«, če je bilo naročilo preklicano. |
cancelled_at | Čas preklica naročila. |
cancel_reason | Razlog, izbran ob preklicu naročila. Ena od naslednjih vrednosti: inventory, customer, declined, fraud ali other. |
has_high_risks?(deprecated) | Vrne »true«, če je naročilo visoko tvegano |
unique_gateways |
Vrne seznam edinstvenih ponudnikov plačilnih storitev za naročilo. Če je nekdo na primer plačal s kartico Visa, Mastercard in gotovino, bi bil vrnjeni seznam |
location(POS only) |
Prikaže fizično lokacijo naročila. Na voljo je več lastnosti lokacije, ki so navedene tukaj. Lokacije lahko konfigurirate v razdelku »Lokacije« v skrbniški plošči. |
order_status_url |
Vrne povezavo do strani stanja naročila za to naročilo. |
fulfilled_line_items(deprecated) | Seznam postavk, ki so bile izpolnjene. |
unfulfilled_line_items(deprecated) | Seznam postavk, ki še niso bile v celoti izpolnjene. |
b2b? |
Vrne »true«, če je naročilo naročilo B2B. Uporabite to lastnost s spremenljivkami B2B za prikaz ustreznih informacij, kot so ime podjetja, lokacija podjetja in naslov v e-poštnih sporočilih. Pri naročilih B2B lahko na primer dodate glavo v predlogo z naslednjimi informacijami:
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | Podjetje, ki mu prodajate pri naročilu B2B. |
company.name | Ime podjetja pri naročilu B2B. |
company.id | ID podjetja pri naročilu B2B. |
company_location | Lokacija podjetja pri naročilu B2B. Podjetje, ki kupuje pri vas, ima lahko več kot eno lokacijo. |
company_location.name | Ime lokacije podjetja pri naročilu B2B. |
company_location.id | Številka ID lokacije podjetja pri naročilu B2B. |
company_location.shipping_address | Naslov za dostavo lokacije podjetja pri naročilu B2B. |
company_location.billing_address | Naslov za izstavitev računa lokacije podjetja pri naročilu B2B. |
customer_order_url | Nova stran stanja naročila za naročilo, za katero je stranka zahtevala vračilo z uporabo računov strank. |
Lastnosti osnutka naročila
| Lastnost | Opis |
|---|---|
id | Edinstven ID osnutka naročila za interno uporabo. |
invoice_url | Povezava, na kateri lahko stranka plača račun s Shopifyjevo varno blagajno. |
reserve_inventory_until |
Datum in čas, do katerega so postavke v osnutku rezervirane, na primer Datume lahko formatirate s filtrom datumov za Liquid. |
user | Zadnji član osebja, ki je spremenil osnutek naročila. |
user.name | Ime zadnjega člana osebja, ki je spremenil osnutek naročila. |
user.email | E-poštni naslov zadnjega člana osebja, ki je spremenil osnutek naročila. |
email | E-poštni naslov, povezan z osnutkom naročila. |
name | Edinstven number osnutka naročila s predpono v obliki znaka za številko #. |
number | Edinstvena številka osnutka naročila brez predpone ali pripone naročila. |
created_at |
Datum in ura, ko je stranka ustvarila osnutek naročila, na primer Datume lahko formatirate s filtrom datumov za Liquid. |
tags | Vrne polje vseh oznak naročila. Oznake so vrnjene v abecednem vrstnem redu. Za več podrobnosti glejte referenčno dokumentacijo Liquid. |
tax_price | Skupni davki vseh kosov v osnutku naročila. |
tax_lines |
Davki, razdeljeni po vrsti davka:
{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_line.title | Ime davka. Primera: QST ali DDV |
tax_line.price | Znesek davka. |
tax_line.rate | Davčna stopnja v decimalni obliki. Na primer, pri davčni stopnji 17,5 % bo vrnjeno 0.175. |
tax_line.rate_percentage | Davčna stopnja v odstotkih. Na primer, za rate 0,175 bo vrnjeno 17.5. |
customer | Objekt stranke, ki vsebuje lastnosti izpisa za stranko. |
billing_address | Naslov za izdajo računa za osnutek naročila. |
billing_address.first_name | Ime stranke. |
billing_address.last_name | Priimek stranke. |
billing_address.company | Ime podjetja na naslovu za izdajo računa. |
billing_address.phone | Telefonska številka na naslovu za izdajo računa. |
shop.name | Ime vaše trgovine. |
shop.phone | Telefonska številka vaše trgovine. |
subtotal_price | Vsota cen postavk osnutka naročila po odštetju morebitnega popusta na postavko ali popusta na košarico. Vmesni seštevek ne vključuje davkov (razen če so davki že vključeni v cene) ali stroškov pošiljanja. |
discounts | Seznam popustov. |
discounts_amount | Znesek popusta, ki se uveljavi z vsemi popusti. Primer: +5,00 $ |
discounts_savings | Znesek prihranka zaradi vseh popustov. Primer: -5,00 $ |
total_price | Skupna cena naročila (vmesni seštevek + stroški pošiljanja - popust pri pošiljanju + davek). |
amount_due_now | Znesek, zahtevan na računu za osnutek naročila. |
requires_shipping | Vrne true , če je v osnutku naročila vsaj en kos, ki zahteva dostavo. Vrne false , če noben kos v osnutku naročila ne zahteva dostave. |
shipping_method.title | Ime poštnine. Primer: Standardna dostava |
shipping_method.price | Cena načina pošiljanja. Vrne iste informacije kot shipping_price. |
shipping_price |
Cena pošiljanja. Ta znesek lahko oblikujete s filtri za denar Liquid. |
shipping_address |
Opomba: Za razliko od rednih naročil je naslov za dostavo pri osnutku naročila lahko nepopoln. |
shipping_address.first_name | Ime za naslov za dostavo. |
shipping_address.company | Ime podjetja na naslovu za dostavo. |
shipping_address.phone | Telefonska številka na naslovu za dostavo. |
line_items | Seznam vseh postavk v osnutku naročila. |
item_count | Vsota količin vseh kosov v osnutku naročila. |
note | Opomba, priložena osnutku naročila. Opombo lahko pridobite od stranke ali pa jo uredite na zaslonu s podrobnostmi o osnutku naročila v skrbniku Shopify. |
metafields |
Katera koli metapolja na osnutku naročila. Uporabite naslednjo sintakso: metafields.NAMESPACE.KEY |
location |
Fizična lokacija naročila. Na voljo je več lastnosti lokacije. Lokacije lahko konfigurirate na strani Lokacije v skrbniku Shopify. |
b2b? |
Vrne »true«, če je naročilo naročilo B2B. Uporabite to lastnost s spremenljivkami B2B za prikaz ustreznih informacij, kot so ime podjetja, lokacija podjetja in naslov v e-poštnih sporočilih. Pri naročilih B2B lahko na primer dodate glavo v predlogo z naslednjimi informacijami:
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | Podjetje, ki mu prodajate pri naročilu B2B. |
company.name | Ime podjetja pri naročilu B2B. |
company.id | ID podjetja pri naročilu B2B. |
company_location | Lokacija podjetja pri naročilu B2B. Podjetje, ki kupuje pri vas, ima lahko več kot eno lokacijo. |
company_location.name | Ime lokacije podjetja pri naročilu B2B. |
company_location.id | Številka ID lokacije podjetja pri naročilu B2B. |
company_location.shipping_address | Naslov za dostavo lokacije podjetja pri naročilu B2B. |
company_location.billing_address | Naslov za izstavitev računa lokacije podjetja pri naročilu B2B. |
payment_methods | Seznam shranjenih načinov plačila, ki so na voljo za obdelavo skupnega zneska osnutka. |
payment_method.payment_instrument | Plačilni instrument, ki vsebuje podrobnosti o shranjenem načinu plačila. |
payment_method.payment_instrument.payment_type | Vrsta shranjenega načina plačila. Npr. »credit_card, apple_pay«. |
payment_method.payment_instrument.credit_card_brand | Blagovna znamka kartice, ko je vrednost `payment_type` »credit_card«. |
payment_method.payment_instrument.credit_card_company | Izdajatelj kartice, ko je vrednost `payment_type` »credit_card«. |
payment_method.payment_instrument.credit_card_company | Zadnje 4 števke kartice, ko je vrednost `payment_type` »credit_card«. |
Lastnosti načrta plačil
| Lastnost | Opis |
|---|---|
payment_schedule.amount_due |
Znesek za plačilo za načrt plačil. Zneske z valutami lahko oblikujete s filtrom za denar Liquid. |
payment_schedule.due_at |
Rok plačila za načrt plačil. Datume lahko formatirate s filtrom datumov za Liquid. |
payment_schedule.due_in_days |
Število dni do roka plačila, če načrt plačil še ni poravnan (neplačan). |
payment_schedule.due_later? |
Vrne »true«, če načrt plačil ni bil plačan in je njegov rok plačila v prihodnosti. |
payment_schedule.number_of_days_overdue? |
Število dni od roka plačila, ko je načrt plačil v zamudi. |
payment_schedule.overdue? |
Vrne »true«, če načrt plačil še ni bil plačan in je rok plačila že potekel. |
Lastnosti stanja plačila
| Lastnost | Opis |
|---|---|
has_pending_payment |
(Logična vrednost) Vrne »true«, če ima naročilo transakcijo s plačilom na čakanju. Več informacij o plačilih na čakanju. |
buyer_action_required |
(Logična vrednost) Vrne »true«, če ima naročilo transakcijo s plačilom na čakanju in je za deblokado plačila potrebno dejanje kupca. Ko ta vrednost vrne »true« in način plačila podpira navodila za plačilo, Več informacij o objektu transakcije Liquid. |
Lastnosti komponente paketa
Vsaka komponenta bundle_component na seznamu line_item.bundle_components ima naslednje lastnosti. (Samo za osnutke naročil)
| Lastnost | Opis |
|---|---|
bundle_component.image_url | URL slike komponente paketa. |
bundle_component.product.title | Naslov izdelka komponente paketa. |
bundle_component.quantity | Količina komponente paketa. |
bundle_component.variant.title | Trenutna imena vrednosti možnosti različice komponente paketa, združena z znaki Primer: majhna / rdeča |
Lastnosti komponente
Vsaka komponenta na seznamu line_item.components ima naslednje lastnosti. (Samo pri zapuščeni blagajni)
`
| Lastnost | Opis |
|---|---|
component.image_url | URL-naslov slike komponente. |
component.product.title | Naslov izdelka komponente. |
component.quantity | Količina za komponento. |
component.variant.title | Trenutna imena vrednosti možnosti različice komponente, povezana z znaki Primer: majhna / rdeča |
Lastnosti postavke
Vsak element line na seznamu line_items ali subtotal_line_items ima naslednje lastnosti.
| Lastnost | Opis |
|---|---|
line.applied_discounts(POS and draft orders only) | Seznam popustov, uporabljenih za ta kos (vsak popust ima lastnosti title, code, amount, savings in type). |
line.bundle_components(Draft orders only) | Seznam postavk, ki so komponente paketa tega kosa. Seznam vrne le, če je ta postavka izdelek v paketu. |
line.bundle_parent?(Draft orders only) | (logična vrednost) Vrne vrednost »true«, če je postavka izdelek v paketu. |
line.components(Abandoned checkout only) | Seznam postavk, ki so komponente tega kosa. |
line.parent?(Abandoned checkout only) | (logična vrednost) Vrne vrednost »true«, če ima postavka komponente. |
line.custom(Draft orders only) | (logična vrednost) Vrne vrednost »true«, če je kos postavka po meri za osnutek naročila. |
line.delivery_agreement | Pogodba o dostavi, povezana s to postavko. |
line.grams | Teža posameznega kosa. |
line.groups | Skupina postavk kosa. |
line.image | Vrne URL-naslov slike, povezane s to postavko. Za pridobivanje določenih velikosti slik lahko uporabite tudi filter img_url, na primer {{ line.image | img_url: 'small' }} |
line.line_price | Cena, pomnožena s količino za ta kos. |
line.original_line_price | Skupna cena količine kosov, vključenih v postavko, pred uporabo popustov. |
line.final_line_price | Skupna cena vseh kosov v postavki, vključno z vsemi zneski popustov na ravni postavke. |
line.pre_tax_price | Cena pred obdavčitvijo za postavke, pomnožena s kupljeno količino postavke. |
line.price | Cena za posamezni kos. |
line.product.metafields | Katera koli metapolja na ravni izdelka. Uporabite naslednjo sintakso: line.product.metafields.NAMESPACE.KEY |
line.product.title | Trenutno ime izdelka. |
line.product.vendor | Prodajalec kosa. |
line.properties | Vrne polje informacij po meri za kos. Lastnosti postavke določi stranka na strani izdelka pred dodajanjem izdelka v košarico. |
line.quantity | Količina za ta kos. |
line.current_quantity | Trenutna količina kosa po odstranitvah. |
line.requires_shipping | (logična vrednost) Vrne vrednost »true«, če ima različica za kos na strani izdelka aktivirano nastavitev Fizični izdelek. |
line.selling_plan_allocation | Vrne objekt selling_plan_allocation, ki opisuje, kako prodajni načrt, kot je naročnina, vpliva na postavko. |
line.taxable | (logična vrednost) Vrne vrednost »true«, če ima različica za kos na strani izdelka obkljukano potrditveno polje »Obračunaj davek za ta izdelek«. |
line.title | Ime izdelka v času prodaje, ki mu sledita pomišljaj in ime različice v času prodaje. Ime različice ni vključeno, če gre za »Privzeti naslov«. V obvestilih za stranke sta ime izdelka in ime različice prevedena v jezik, v katerem je stranka zaključila nakup, če se ta jezik razlikuje od privzetega jezika trgovine. |
line.url | Relativni URL-naslov različice postavke. Relativni URL-naslov ne vključuje korenskega URL-naslova vaše trgovine (mystore.myshopify.com). |
line.variant.barcode | Črtna koda, povezana z različico izdelka. |
line.variant.compare_at_price | Primerjalna cena, povezana z različico izdelka. |
line.variant.image | Slika za različico izdelka. Sliko vrne samo, če je različici v postavki dodeljena določena slika. |
line.variant.metafields | Katera koli metapolja na ravni različice. Uporabite naslednjo sintakso: line.variant.metafields.NAMESPACE.KEY |
line.variant.sku | SKU, povezan z različico izdelka. |
line.variant.title | Trenutna imena vrednosti možnosti različice, povezana z znaki Primer: majhna / rdeča |
line.refunded.quantity(within refund notifications) | Količina kosa za povračilo. To lastnost lahko uporabite za dodajanje oznake kosom s povrnjenimi sredstvi v naročilu. Na primer: |
Zaznavanje kosov Shopify Collective v predlogah obvestil
Oznaka Shopify Collective je dodana naročilu, ko je e-poštno sporočilo s potrditvijo naročila poslano, zato vrednost {% if tags contains 'Shopify Collective' %} v predlogi potrditve naročila ni nikoli true. Za zaznavanje kosov Shopify Collective namesto tega preverite oznake na ravni izdelka za vsako postavko:
{% assign has_collective_item = false %}
{% for line in line_items %}
{% if line.product.tags contains 'Shopify Collective' %}
{% assign has_collective_item = true %}
{% endif %}
{% endfor %}
{% if has_collective_item %}
<!-- Collective-specific content -->
{% endif %}Lastnosti skupine postavk
Vsaka skupina postavk (line_item_group) na seznamu line_item_groups ima naslednje lastnosti.
| Lastnost | Opis |
|---|---|
line_item_group.display_title | Naslov skupine postavk. |
line_item_group.components | Seznam komponent postavke, ki pripadajo skupini. |
line_item_group.image | Slika skupine postavk. |
line_item_group.product_id | ID izdelka skupine postavk. |
line_item_group.variant | Objekt različice skupine postavk. |
line_item_group.variant_id | Identifikator različice skupine postavk. |
Lastnosti povračil
| Lastnost | Opis |
|---|---|
amount | Znesek povrnjenega denarja. |
refund_line_items | Seznam postavk povračila, ki bodo povrnjene. |
Lastnosti postavke povračila (refund_line_item)
Vsaka postavka povračila (refund_line) na seznamu refund_line_items ima naslednje lastnosti:
| Lastnost | Opis |
|---|---|
refund_line.line_item | Postavka line_item, za katero se izvaja povračilo. Omogoča dostop do vseh lastnosti elementa line_item. |
refund_line.quantity | Količina postavke, za katero se izvaja povračilo. |
Lastnosti izpolnitve
| Lastnost | Opis |
|---|---|
service_name | Ime storitve po meri, kot je določeno na strani Nastavitve > Pošiljanje in dostava. (Samo zahteva za izpolnitev) |
fulfillment.estimated_delivery_at | Ocenjen datum dostave na podlagi številke za sledenje (če je na voljo), ki jo zagotovi eden od naslednjih prevoznikov: USPS, FedEx, UPS ali Canada Post (samo za Kanado). Ta lastnost je na voljo samo, ko so v uporabi tarife, ki jih izračuna prevoznik. |
fulfillment.fulfillment_line_items | Seznam postavk za izpolnitev, ki bodo izpolnjene. |
fulfillment.item_count | Vsota vseh količin kosov. Skupno število kosov, ki se izpolnjujejo. |
fulfillment.requires_shipping | (logična vrednost) Vrne »true«, če ta zahteva za izpolnitev zahteva dostavo. |
fulfillment.tracking_company | Podjetje, ki izvaja sledenje. |
fulfillment.tracking_numbers | Seznam številk za sledenje. |
fulfillment.tracking_urls | Seznam URL-naslovov za sledenje. |
items_to_fulfill(deprecated) | Seznam postavk, ki jih bo izpolnila določena storitev za izpolnjevanje naročil strank po meri. (Samo za zahtevo za izpolnitev) |
items_to_fulfill_count(deprecated) | Skupno število kosov, ki bodo izpolnjeni s to zahtevo. (Samo za zahtevo za izpolnitev) |
Lastnosti za fulfillment_line_item
Vsak fulfillment_line na seznamu fulfillment_line_items ima naslednje lastnosti.
| Lastnost | Opis |
|---|---|
fulfillment_line.line_item | Postavka line_item, ki se izpolnjuje. Omogoča dostop do vseh lastnosti elementa line_item. |
fulfillment_line.quantity | Količina postavke, ki se izpolnjuje. |
Lastnosti pripravljenega paketa
Pripravljen paket vključuje kose, označene kot pripravljene na prevzem.
| Lastnost | Opis |
|---|---|
item_count | Vsota vseh količin kosov v pripravljenem paketu. |
prepared_package_line_items | Seznam postavk pripravljenega paketa. |
Lastnosti za prepared_package_line_item
Vsak prepared_package_line_item na seznamu prepared_package_line_items ima naslednje lastnosti.
| Lastnost | Opis |
|---|---|
line_item | Povezana postavka line_item. Omogoča dostop do vseh lastnosti elementa line_item. |
quantity | Količina postavke, ki je bila označena kot pripravljena na prevzem. |
Lastnosti dostave
| Lastnost | Opis |
|---|---|
delivery_agreements | Seznam vseh sporazumov o dostavi za naročilo. |
delivery_instructions | Informacije o lokalni dostavi, ki jih želite deliti s stranko. Te informacije se upravljajo v polju Informacije o dostavi v nastavitvah lokalne dostave. |
consolidated_estimated_delivery_time | Informacije o datumih dostave naročila, ki jih želite deliti s stranko. Te informacije se upravljajo z nastavitvijo Čas obdelave, ki jo nastavite na strani Pošiljanje in dostava. Če ima naročilo več načinov dostave, je prikazan seznam načinov in datumov dostave. |
has_multiple_delivery_methods | (logična vrednost) Vrne »true«, če ima naročilo več načinov dostave. |
Lastnosti sporazuma o dostavi
| Lastnost | Opis |
|---|---|
delivery_agreement.delivery_method_type | Vrsta načina dostave. |
delivery_agreement.delivery_method_name | Vrsta načina dostave, prevedena v jezik, v katerem je kupec izvedel nakup na blagajni, če se jezik razlikuje od privzetega jezika trgovine. |
delivery_agreement.line_item_groups | Seznam vseh skupin postavk, ki vsebujejo komponente postavk v svežnju znotraj sporazuma o dostavi. |
delivery_agreement.line_items | Seznam vseh postavk, povezanih s tem sporazumom o dostavi. |
Lastnosti popusta
Obstajata dve vrsti lastnosti za popuste.
discount_applications opisujejo, zakaj in kako je bil uporabljen popust za kos.
discount_allocations opisujejo, kako določen popust vpliva na postavko in kako zniža ceno. To lastnost morate uporabiti na ravni postavke.
Ti dve lastnosti lahko kombinirate za prikaz informacij o popustu na ravni postavke ali naročila.
Primer
Ta primer preveri, ali je bil za postavko uporabljen popust. Če popust ni bil uporabljen na ravni naročila (all), se prikažeta ime popusta in znesek.
{% if line.discount_allocations %}
{% for discount_allocation in line.discount_allocations %}
{% if discount_allocation.discount_application.target_selection != 'all' %}
{{ discount_allocation.discount_application.title | upcase }}
(-{{ discount_allocation.amount | money }})
{% endif %}
{% endfor %}
{% endif %}Rezultat je lahko podoben temu:
SPRING5 (-$5.00)Lastnosti za discount_allocation
Vsak discount_allocation na seznamu discount_allocations ima naslednje lastnosti.
| Lastnost | Opis |
|---|---|
discount_allocation.amount | Znesek, ki ga stranka prihrani pri postavki. Če želite omogočiti več kod za popust, mora biti vrednost vnesena v zanko. |
discount_allocation.discount_application | Uporaba popusta, ki dodeli znesek na postavko. |
Lastnosti za discount_application
Vsak discount_application na seznamu discount_applications ima naslednje lastnosti.
| Lastnost | Opis |
|---|---|
discount_application.target_selection |
Opisuje, kako popust izbere postavke v košarici, na katere se bo nanašal popust. Ena od naslednjih možnosti:
|
discount_application.target_type | Vrsta kosa, za katerega velja popust (line_item ali shipping_line). |
discount_application.title | Ime popusta, ki je prikazano stranki. Primeri: Welcome10 ali CBBWQQAKYBYY |
discount_application.total_allocated_amount | Skupni znesek, za katerega je cena naročila znižana zaradi popusta. |
discount_application.type | Vrsta popusta. Lahko je: automatic, discount_code, manual ali script. |
discount_application.value | Vrednost popusta. |
discount_application.value_type | Vrsta vrednosti popusta. Lahko je: fixed_amount ali percentage. |
Lastnosti naročnine
Podrobnosti pogodbe o naročnini, trenutno obračunsko obdobje in njegove postavke, način dostave in način plačila so na voljo za vse predloge e-pošte za naročnine.
Če želite urediti predloge za obvestila o naročnini, namestite aplikacijo Shopify Subscriptions in nato poiščite predlogo pod Nastavitve > Obvestila v razdelku Naročnine.
Lastnosti obračunskega cikla pogodbe o naročnini
Če želite dostopati do lastnosti pogodbe o naročnini in njenega obračunskega cikla, uporabite objekt subscription_contract_billing_cycle.
Primer
{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.Rezultat:
This contract is currently paused.Lastnosti
| Lastnost | Opis |
|---|---|
status |
Stanje pogodbe. Lahko je active, paused, cancelled, failed, expired, stale,
|
delivery_method |
Način dostave za naročnino. Če se naročnina nanaša na storitev ali digitalni izdelek, se vrne vrednost nil.
|
billing_frequency | Kako pogosto se naročnina obračunava. |
delivery_frequency | Kako pogosto se naročnina dostavlja. |
origin_order |
Prvotno naročilo, s katerim je bila ustvarjena naročnina. Če naročnina ni bila ustvarjena iz naročila v storitvi Shopify, se vrne vrednost nil.
|
customer | Stranka naročnine. |
line_items | Postavke v obračunskem ciklu naročnine. |
product_names | Seznam imen izdelkov, ki so vključeni v obračunski cikel naročnine. |
update_payment_method_url | URL-naslov, ki ga lahko stranka uporabi za posodobitev načina plačila za to pogodbo. |
shipping_address |
Naslov za dostavo za naročnino. Če se naročnina nanaša na storitev ali digitalni izdelek, se vrne vrednost nil.
|
billing_address | Naslov za izdajo računa za naročnino. |
subtotal_price | Vmesni seštevek cene postavk naročnine. |
shipping_price | Cena dostave naročnine. |
total_tax | Skupni davek naročnine. |
total_price | Skupna cena naročnine. |
total_discounts | Skupni popusti naročnine. |
customer_self_serve_url | URL-naslov samopostrežnega portala, ki ga lahko stranka uporabi za upravljanje svojih naročnin. |
billing_attempt_expected_date | Datum obračuna za ta obračunski cikel. |
next_billing_date | Naslednji nepreskočeni datum obračuna po tem obračunskem ciklu. |
last_attempted_billing_date | Datum zadnjega poskusa obračuna za obračunski cikel. |
days_overdue | Število dni zamude pri obračunu za ta obračunski cikel. |
payment_instrument | Plačilno sredstvo, povezano s pogodbo o naročnini. To plačilno sredstvo se uporablja za obračunavanje stranki. |
Lastnosti postavk pogodbe o naročnini
Lastnosti za vsako postavko, vključeno v obračunski cikel. Do lastnosti postavk pogodbe lahko dostopate prek nadrejene lastnosti subscription_contract_billing_cycle.line_items.
Primer
{% for line_item in subscription_contract_billing_cycle.line_items %}
{{ line_item.url }}
{% endfor %}| Lastnost | Opis |
|---|---|
url | URL-naslov do strani s podrobnostmi o izdelku za različico izdelka v postavki. |
requires_shipping | Ali postavka zahteva fizično dostavo. |
unit_price_measurement | Mera cene na enoto postavke. |
selling_plan_allocation | Dodelitev prodajnega načrta postavke. |
Lastnosti načina dostave pogodbe o naročnini
Lastnosti za način dostave, ki se uporablja v tem obračunskem ciklu. Do lastnosti načina dostave lahko dostopate prek nadrejene lastnosti subscription_contract_billing_cycle.delivery_method.
Primer
{% if subscription_contract_billing_cycle.delivery_method != blank %}
Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}| Lastnost | Opis |
|---|---|
title | Naslov možnosti dostave, povezane z načinom dostave. |
type |
Vrsta načina dostave. Lahko je shipping, local ali pick-up.
|
Lastnosti plačilnega sredstva pogodbe o naročnini
Podrobnosti o plačilnem sredstvu za pogodbo o naročnini. To plačilno sredstvo se uporablja za obračun stranki. Do lastnosti plačilnega sredstva lahko dostopate prek nadrejene lastnosti subscription_contract_billing_cycle.payment_instrument.
Primer
{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}
<img src="{{ instrument.payment_type | payment_type_img_url }} " alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}| Lastnost | Opis |
|---|---|
payment_type |
Vrsta načina plačila, ki ga predstavlja plačilno sredstvo. Za izpis URL-naslova slike ali SVG-ja uporabite filtre plačil. |
credit_card_brand | Blagovna znamka kreditne kartice. |
credit_card_company | Ime podjetja, ki je izdalo kreditno kartico. |
credit_card_last_four_digits | Zadnje 4 števke kreditne kartice. |
Lastnosti e-poštnih obvestil
| Lastnost | Opis |
|---|---|
shop.email_logo_url | URL-naslov za logotip, določen v razdelku Prilagajanje predlog e-pošte v skrbniški plošči. |
shop.email_logo_width | Širina logotipa (v pikslih), določena v razdelku Prilagajanje predlog e-pošte v skrbniški plošči. |
shop.email_accent_color | Šestnajstiška koda za barvo poudarkov, določena v razdelku Prilagajanje predlog e-pošte v skrbniški plošči. |
Lastnosti dobroimetja za nakup
Lastnosti, ki vsebujejo podrobnosti o izdaji dobroimetja za nakup.
| Lastnost | Opis |
|---|---|
issued_store_credit.amount |
Znesek izdanega dobroimetja za nakup. Ta znesek lahko oblikujete s filtri za denar Liquid. |
issued_store_credit.expires_at |
Datum in čas poteka izdanega dobroimetja za nakup. Ta znesek lahko oblikujete s filtri datumov za jezik Liquid. |
issued_store_credit.balance_after_transaction |
Stanje računa z dobroimetjem v trgovini po tem, ko je bilo dobroimetje izdano. Ta znesek lahko oblikujete s filtri za denar Liquid. |
customer | Objekt stranke, ki vsebuje lastnosti izpisa za stranko. |