Pranešimų kintamųjų žinynas

Iš Jūsų parduotuvės siunčiami pranešimai atvaizduojami naudojant Liquid. „Liquid“ yra paprasta, lengvai naudojama „Shopify“ programavimo kalba. Tai ta pati programavimo kalba, kuria pagrįstos temos iš „Theme Store“.

Norėdami redaguoti iš Jūsų parduotuvės siunčiamus pranešimus, galite atlikti pagrindinius pritaikymus savo pranešimų šablonuose. Norėdami pasiekti visą pranešimų, kuriuos galite tinkinti, sąrašą, eikite į puslapį Pranešimai savo „Shopify“ administratoriaus skydelyje.

Jei reikia pagalbos atliekant sudėtingesnius pakeitimus arba keičiant tinkintus pranešimų šablonus, galite kreiptis į bendruomenę mūsų forumuose arba galite įdarbinti „Shopify“ partnerį, kad jis atliktų pritaikymus už Jus. Sužinokite daugiau apie „Shopify“ partnerio įdarbinimą.

Užsakymo ypatybės

Daugelis užsakymo ypatybių yra prieinamos tiesiogiai naudojant „Liquid“ ir šablonuose.

„Liquid“ ypatybių, kurias galite naudoti su užsakymo objektu pranešimų šablonuose, aprašymai.
YpatybėAprašymas
id

Unikalus visos sistemos užsakymo ID, skirtas vidiniam naudojimui. Naudokite šį pavyzdį, norėdami sugeneruoti nuorodą į užsakymą savo parduotuvės administratoriaus skydelyje. Pavyzdžiui, savo Naujo užsakymo šablone galite pridėti šį kodą:

Peržiūrėti užsakymą
emailEl. pašto adresas, susietas su užsakymu.
name

Paprastai tai yra grotelių simbolis, po kurio eina order_number.

Pavyzdys: #1004

order_nameTas pats, kas „name“.
order_number

Unikalus parduotuvės užsakymo numeris be grotelių (#) priešdėlio arba bet kokio kito priešdėlio ar priesagos, kuriuos parduotuvės savininkas pridėjo prie užsakymo ID savo parduotuvės nuostatose.

Pavyzdys: 1004

confirmation_number

Atsitiktinai sugeneruotas raidinis ir skaitmeninis užsakymo identifikatorius, kuris gali būti rodomas klientui vietoj nuoseklaus užsakymo pavadinimo. Nėra garantijos, kad ši vertė bus unikali.

Pavyzdys: XPAV284CT

created_at

Data ir laikas, kada klientas sukūrė užsakymą. Jūs galite tai formatuoti naudodami datos filtrą.

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

payment_terms

Mokėjimo sąlygose nurodoma data, iki kurios turi būti apmokėtas užsakymas.

Sužinokite, kaip pridėti mokėjimo sąlygas prie užsakymo sąskaitų faktūrų.

Daugiau informacijos rasite „Liquid“ dokumentacijoje apie payment_terms.

destinationPaskirties vieta, į kurią turi būti išsiųsti daiktai.
tagsGrąžina visų užsakymo žymų masyvą. Žymos pateikiamos abėcėlės tvarka. Žymos, kurias dinamiškai pritaiko programėlės ar platformos funkcijos, pvz., Shopify Collective žyma, gali būti nepasiekiamos generuojant pranešimo el. laišką. Norėdami aptikti konkrečios funkcijos prekes, verčiau tikrinkite produkto lygio žymas kiekvienoje prekių pozicijoje. Daugiau informacijos rasite „Liquid“ informacinėje dokumentacijoje.
transactionsPateikia užsakymo operacijų masyvą.
tax_priceBendra visų užsakymo prekių mokesčių suma.
tax_lines

Mokesčiai, suskirstyti pagal apmokestinimo tipą:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.titleMokesčio pavadinimas. Pavyzdžiui, QST arba PVM.
tax_line.priceMokesčio suma.
tax_line.rateMokesčio tarifas dešimtaine trupmena. Bus pateikta 0,175, jei tarifas yra 17,5 %.
tax_line.rate_percentageMokesčio tarifas žmonėms suprantamu formatu. Bus pateikta 17,5, jei tarifas yra 0,175.
customerKliento objektas, apimantis kliento išvesties atributus.
billing_addressSąskaitos pateikimo adresas.
billing_address.first_nameKliento vardas.
billing_address.last_nameKliento pavardė.
billing_address.companyĮmonės pavadinimas sąskaitai.
billing_address.phoneTelefono numeris iš sąskaitos pateikimo adreso.
shop.nameJūsų parduotuvės pavadinimas.
shop.phoneJūsų parduotuvės telefono numeris.
subtotal_priceUžsakymo prekių pozicijų kainų suma, atskaičius bet kokią prekių pozicijos ar krepšelio nuolaidą. Į tarpinę sumą neįtraukiami mokesčiai (nebent mokesčiai įtraukti į kainas), pristatymo išlaidos ar arbatpinigiai.
discountsNuolaidų sąrašas.
discounts_amount

Bendra visų pritaikytų nuolaidų suma.

Pavyzdys: +5,00 $

discounts_savings

Sutaupyta suma pritaikius visas nuolaidas.

Pavyzdys: –5,00 $

total_price

Bendra užsakymo suma (tarpinė suma + siuntimo kaina – siuntimo nuolaida + mokesčiai).

financial_statusDabartinė mokėjimo būsena. Viena iš: nil, pending, authorized, paid, voided, refunded.
requires_shipping(Loginė reikšmė) Pateikia „true“ reikšmę, jei užsakyme yra bent viena prekė, kurią reikia išsiųsti.
shipping_method.title

Siuntimo tarifo pavadinimas.

Klientams skirtuose pranešimuose siuntimo tarifo pavadinimas išverčiamas į kalbą, kuria klientas atsiskaitė, kai ta kalba skiriasi nuo numatytosios parduotuvės kalbos.

Pavyzdys: standartinis pristatymas
shipping_method.price

Siuntimo kaina, įskaitant bet kokią siuntimo nuolaidą.

Pavyzdys: {{ shipping_method.price | money }}

shipping_price

Siuntimo kaina.

Pavyzdys: {{ shipping_price | money }}

shipping_addressPristatymo adresas.
shipping_address.first_namePristatymo adrese nurodytas vardas.
shipping_address.companyPristatymo adrese nurodytas įmonės pavadinimas.
shipping_address.phoneTelefono numeris iš pristatymo adreso.
line_itemsVisų užsakymo prekių pozicijų sąrašas.
line_items_including_zero_quantityVisų užsakymo prekių pozicijų sąrašas, įskaitant tas, kurių kiekis yra nulis. Prekių pozicijų kiekis yra nulis, kai už jas visiškai grąžinami pinigai.
line_item_groups(Orders and POS only)Visų užsakymo prekių pozicijų grupių, kuriose yra prekių pozicijų komponentų, sąrašas.
item_countBendra visų prekių kiekių suma.
fulfillment_statusDabartinė užsakymo vykdymo būsena. Viena iš: unfulfilled, partial, fulfilled.
notePrie užsakymo pridėta pastaba. Pastabą galima gauti iš kliento ir (arba) redaguoti užsakymo išsamios informacijos ekrane Jūsų administratoriaus sąsajoje.
attributes

Visi atributai, kurie buvo pridėti prie užsakymo.

Pavyzdys: {{ attributes.gift-note }}

metafields

Visi užsakymo metalaukai. Naudokite šią sintaksę:

metafields.NAMESPACE.KEY

referring_site

Pateikiamas nukreipėjo URL adresas, kuris atvedė klientą į Jūsų parduotuvę.

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

landing_site

Pateikiamas kliento nukreipimo svetainės kelias. Tai pirmasis puslapis, kurį klientas pamatė atėjęs į parduotuvę.

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

landing_site_ref

Peržiūri nukreipimo svetainę ir iš jos išskiria nuorodos parametrą. Nuorodos parametrai gali būti: ref, source, r.

Jei landing_site yra /products/great-product?ref=my-tracking-token, tuomet landing_site_ref yra my-tracking-token. Galite atlikti tam tikrą veiksmą, jei Jūsų ref yra lygus tam tikrai vertei:

{% if landing_site_ref == 'my-tracking-token' %} Mano veiksmas... {% endif %}
cancelled(Loginė reikšmė) Pateikia „true“ reikšmę, jei užsakymas buvo atšauktas.
cancelled_atLaikas, kada užsakymas buvo atšauktas.
cancel_reasonPriežastis, pasirinkta atšaukiant užsakymą. Viena iš: inventory, customer, declined, fraud arba other.
has_high_risks?(deprecated)

Pateikia „true“ reikšmę, jei užsakymas yra didelės rizikos.

unique_gateways

Grąžina unikalių mokėjimo paslaugų teikėjų sąrašą užsakyme. Pavyzdžiui, jei kas nors sumokėjo „Visa“, „Mastercard“ ir grynaisiais pinigais, tada grąžintame sąraše būtų shopify_payments, cash.

location(POS only)

Parodo fizinę užsakymo vietą. Yra kelios galimos vietos ypatybės, išvardytos čia. Vietas galite konfigūruoti administratoriaus skydelio srityje „Vietos“.

order_status_url

Grąžina nuorodą į šio užsakymo būsenos puslapį.

fulfilled_line_items(deprecated)Įvykdytų prekių pozicijų sąrašas.
unfulfilled_line_items(deprecated)Ne visiškai įvykdytų prekių pozicijų sąrašas.
b2b?

Grąžina „true“, jei užsakymas yra B2B užsakymas. Naudokite ypatybę su B2B kintamaisiais, kad el. laiškuose būtų rodoma aktuali informacija, pavyzdžiui, įmonės pavadinimas, įmonės padalinys ir adresas. Pavyzdžiui, B2B užsakymuose galite įtraukti antraštę į šabloną su šia informacija:

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

Įmonė, kuriai parduodate pagal B2B užsakymą.

company.name

Įmonės pavadinimas B2B užsakyme.

company.id

Įmonės ID B2B užsakyme.

company_location

Įmonės padalinys B2B užsakyme. Iš jūsų perkanti įmonė gali turėti daugiau nei vieną padalinį.

company_location.name

Įmonės padalinio pavadinimas B2B užsakyme.

company_location.id

Įmonės padalinio ID numeris B2B užsakyme.

company_location.shipping_address

Įmonės padalinio pristatymo adresas B2B užsakyme.

company_location.billing_address

Įmonės padalinio sąskaitos pateikimo adresas B2B užsakyme.

customer_order_url

Naujas užsakymo būsenos puslapis, skirtas užsakymui, kuriam klientas paprašė grąžinimo naudodamasis klientų paskyromis.

Juodraštinio užsakymo ypatybės

„Liquid“ ypatybių, kurias galite naudoti su juodraštinio užsakymo objektu pranešimų šablonuose, aprašymai
YpatybėAprašymas
idUnikalus juodraštinio užsakymo ID, skirtas vidiniam naudojimui.
invoice_urlNuoroda, kurią klientas gali naudoti sąskaitai faktūrai apmokėti per saugų „Shopify“ atsiskaitymą.
reserve_inventory_until

Data ir laikas, iki kada rezervuojamos juodraščio prekių pozicijos, pavyzdžiui, 2015-05-30T17:43:51+02:00.

Datas galite formatuoti naudodami „Liquid“ datos filtrą.

userPaskutinis darbuotojas, pakeitęs juodraštinį užsakymą.
user.namePaskutinio darbuotojo, pakeitusio juodraštinį užsakymą, vardas ir pavardė.
user.emailPaskutinio darbuotojo, pakeitusio juodraštinį užsakymą, el. pašto adresas.
emailEl. pašto adresas, susietas su juodraštiniu užsakymu.
nameUnikalus number juodraštinio užsakymo pavadinimas, prieš kurį nurodomas grotelių ženklas #.
numberUnikalus juodraštinio užsakymo numeris be užsakymo prefikso ar sufikso.
created_at

Data ir laikas, kada klientas sukūrė juodraštinį užsakymą, pavyzdžiui, 2009-05-30T17:43:51+02:00.

Datas galite formatuoti naudodami „Liquid“ datos filtrą.

tagsPateikia masyvą su visomis užsakymo žymomis. Žymos pateikiamos abėcėlės tvarka. Daugiau informacijos rasite „Liquid“ informacinėje dokumentacijoje.
tax_priceBendra mokesčių suma už visas prekes juodraštiniame užsakyme.
tax_lines

Mokesčiai pagal tipą:

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

Mokesčio pavadinimas.

Pavyzdžiai: QST arba PVM

tax_line.priceMokesčio suma.
tax_line.rateMokesčio tarifas dešimtaine išraiška. Pavyzdžiui, jei mokesčio tarifas yra 17,5 %, bus grąžinama reikšmė 0,175.
tax_line.rate_percentageMokesčio tarifas procentine išraiška. Pavyzdžiui, jei tarifas yra 0,175, bus grąžinama reikšmė 17,5.
customerKliento objektas, apimantis kliento išvesties atributus.
billing_addressJuodraštinio užsakymo sąskaitos pateikimo adresas.
billing_address.first_nameKliento vardas.
billing_address.last_nameKliento pavardė.
billing_address.companyĮmonės pavadinimas sąskaitos pateikimo adrese.
billing_address.phoneTelefono numeris sąskaitos pateikimo adrese.
shop.nameJūsų parduotuvės pavadinimas.
shop.phoneJūsų parduotuvės telefono numeris.
subtotal_priceJuodraštinio užsakymo prekių pozicijų kainų suma, atėmus bet kokią prekių pozicijos ar krepšelio nuolaidą. Į tarpinę sumą neįtraukiami mokesčiai (nebent mokesčiai įskaičiuoti į kainas) arba siuntimo kaina.
discountsNuolaidų sąrašas.
discounts_amount

Visų pritaikytų nuolaidų suma.

Pavyzdys: +5,00 $

discounts_savings

Sutaupyta suma pritaikius visas nuolaidas.

Pavyzdys: –5,00 $

total_priceBendra užsakymo kaina (tarpinė suma + siuntimo kaina – pristatymo nuolaida + mokesčiai).
amount_due_now

Reikalinga suma pagal juodraštinio užsakymo sąskaitą faktūrą.

requires_shippingGrąžina true jei juodraštiniame užsakyme yra bent viena prekė, kurią reikia pristatyti. Grąžina false jei juodraštiniame užsakyme nėra prekių, kurias reikia pristatyti.
shipping_method.title

Siuntimo tarifo pavadinimas.

Pavyzdys: standartinis pristatymas

shipping_method.priceSiuntimo būdo kaina. Grąžina tą pačią informaciją, kaip ir shipping_price.
shipping_price

Siuntimo kaina.

Šią sumą galite formatuoti naudodami „Liquid“ pinigų filtrus.

shipping_address

Pristatymo adresas.

Pastaba: skirtingai nuo įprastų užsakymų, juodraštinio užsakymo pristatymo adresas gali būti nepilnas.

shipping_address.first_namePristatymo adrese nurodytas vardas.
shipping_address.companyĮmonės pavadinimas pristatymo adrese.
shipping_address.phoneTelefono numeris pristatymo adrese.
line_itemsVisų juodraštiniame užsakyme esančių prekių pozicijų sąrašas.
item_countVisų prekių kiekių suma juodraštiniame užsakyme.
notePrie juodraštinio užsakymo pridėta pastaba. Pastabą galima gauti iš kliento, taip pat ją galima redaguoti juodraštinio užsakymo informacijos ekrane, jūsų „Shopify“ administratoriaus skydelyje.
metafields

Visi juodraštinio užsakymo metalaukai. Naudokite šią sintaksę:

metafields.NAMESPACE.KEY

location

Fizinė užsakymo vieta. Yra kelios galimos vietos ypatybės.

Vietas galite konfigūruoti savo „Shopify“ administratoriaus skydelio puslapyje Vietos.

b2b?

Grąžina „true“, jei užsakymas yra B2B užsakymas. Naudokite ypatybę su B2B kintamaisiais, kad el. laiškuose būtų rodoma aktuali informacija, pavyzdžiui, įmonės pavadinimas, įmonės padalinys ir adresas. Pavyzdžiui, B2B užsakymuose galite įtraukti antraštę į šabloną su šia informacija:

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

Įmonė, kuriai parduodate pagal B2B užsakymą.

company.name

Įmonės pavadinimas B2B užsakyme.

company.id

Įmonės ID B2B užsakyme.

company_location

Įmonės padalinys B2B užsakyme. Iš jūsų perkanti įmonė gali turėti daugiau nei vieną padalinį.

company_location.name

Įmonės padalinio pavadinimas B2B užsakyme.

company_location.id

Įmonės padalinio ID numeris B2B užsakyme.

company_location.shipping_address

Įmonės padalinio pristatymo adresas B2B užsakyme.

company_location.billing_address

Įmonės padalinio sąskaitos pateikimo adresas B2B užsakyme.

payment_methods

Išsaugotų mokėjimo būdų, kuriuos galima naudoti juodraščio bendrai sumai apdoroti, sąrašas.

payment_method.payment_instrument

Mokėjimo priemonė, kurioje pateikiama išsami informacija apie išsaugotą mokėjimo būdą.

payment_method.payment_instrument.payment_type

Išsaugoto mokėjimo būdo tipas. Pvz., „credit_card, apple_pay“

payment_method.payment_instrument.credit_card_brand

Kortelės prekės ženklas, kai `payment_type` yra „credit_card“

payment_method.payment_instrument.credit_card_company

Kortelės įmonė, kai `payment_type` yra „credit_card“

payment_method.payment_instrument.credit_card_company

Paskutiniai 4 kortelės skaitmenys, kai `payment_type` yra „credit_card“

Mokėjimų tvarkaraščio savybės

`Liquid` savybių, kurias galite naudoti su mokėjimų tvarkaraščio objektu pranešimų šablonuose, aprašai
YpatybėAprašymas
payment_schedule.amount_due

Mokėtina suma pagal mokėjimų tvarkaraštį.

Galite formatuoti sumas su valiutomis, naudodami `Liquid` pinigų filtrą.

payment_schedule.due_at

Mokėjimo terminas pagal mokėjimų tvarkaraštį.

Datas galite formatuoti naudodami „Liquid“ datos filtrą.

payment_schedule.due_in_days

Dienų skaičius iki mokėjimo termino, jei mokėjimas pagal tvarkaraštį vis dar laukiamas (neapmokėtas).

payment_schedule.due_later?

Pateikia reikšmę „true“, jei pagal mokėjimų tvarkaraštį nebuvo sumokėta ir mokėjimo terminas yra ateityje.

payment_schedule.number_of_days_overdue?

Dienų skaičius nuo mokėjimo termino, kai mokėjimas pagal tvarkaraštį yra pradelstas.

payment_schedule.overdue?

Pateikia reikšmę „true“, jei pagal mokėjimų tvarkaraštį nebuvo sumokėta ir jo mokėjimo terminas praėjęs.

Mokėjimo būsenos savybės

`Liquid` savybių, kurias galite naudoti su mokėjimo būsenos objektu pranešimų šablonuose, aprašai
YpatybėAprašymas
has_pending_payment

(loginė reikšmė) Pateikia reikšmę „true“, jei užsakyme yra operacija su laukiamu mokėjimu.

Sužinokite daugiau apie laukiamus mokėjimus.

buyer_action_required

(loginė reikšmė) Pateikia reikšmę „true“, jei užsakyme yra operacija su laukiamu mokėjimu ir mokėjimui atblokuoti reikalingas pirkėjo veiksmas. Kai ši reikšmė yra „true“ ir mokėjimo būdas palaiko mokėjimo nurodymus, buyer_pending_payment_instructions pateikiama išsami informacija, kurią klientas gali naudoti pirkimui užbaigti neprisijungus.

Sužinokite daugiau apie `Liquid` operacijos objektą.

Rinkinio komponento savybės

Kiekvienas bundle_component sąraše line_item.bundle_components turi šias savybes. (Tik juodraštiniams užsakymams)

`Liquid` savybių, kurias galite naudoti su rinkinio komponento objektu pranešimų šablonuose, aprašai
YpatybėAprašymas
bundle_component.image_urlRinkinio komponento paveikslėlio URL.
bundle_component.product.titleRinkinio komponento produkto pavadinimas.
bundle_component.quantityRinkinio komponento kiekis.
bundle_component.variant.title

Rinkinio komponento varianto parinkčių reikšmių dabartiniai pavadinimai, sujungti / simboliais.

Pavyzdys: mažas / raudona

Komponento savybės

Kiekvienas component sąraše line_item.components turi šias savybes. (Tik paliktiems atsiskaitymams) `

`Liquid` savybių, kurias galite naudoti su komponento objektu pranešimų šablonuose, aprašai
YpatybėAprašymas
component.image_urlKomponento paveikslėlio URL.
component.product.titleKomponento produkto pavadinimas.
component.quantityKomponento kiekis.
component.variant.title

Komponento varianto parinkčių reikšmių dabartiniai pavadinimai, sujungti / simboliais.

Pavyzdys: mažas / raudona

Prekių pozicijos savybės

Kiekviena line sąraše line_items arba subtotal_line_items turi šias savybes.

`Liquid` savybių, kurias galite naudoti su prekių pozicijos objektu pranešimų šablonuose, aprašai
YpatybėAprašymas
line.applied_discounts(POS and draft orders only)Šiam daiktui taikomų nuolaidų sąrašas (kiekviena nuolaida turi title, code, amount, savings ir type savybes).
line.bundle_components(Draft orders only)Prekių pozicijų, kurios yra šio daikto rinkinio komponentai, sąrašas. Sąrašas pateikiamas tik tuo atveju, jei ši prekių pozicija yra rinkinio produktas.
line.bundle_parent?(Draft orders only)(loginė reikšmė) Pateikia reikšmę „true“, jei prekių pozicija yra rinkinio produktas.
line.components(Abandoned checkout only)Prekių pozicijų, kurios yra šio daikto komponentai, sąrašas.
line.parent?(Abandoned checkout only)(loginė reikšmė) Pateikia reikšmę „true“, jei prekių pozicija turi komponentų.
line.custom(Draft orders only)(loginė reikšmė) Pateikia reikšmę „true“, jei daiktas yra pasirinktinė juodraštinio užsakymo prekių pozicija.
line.delivery_agreementSu šia prekių pozicija susijusi Pristatymo sutartis.
line.gramsVieno daikto svoris.
line.groupsUžsakymo eilutės grupė daiktui.
line.imagePateikia su šia prekių pozicija susieto paveikslėlio URL. Taip pat galite naudoti img_url filtrą, kad gautumėte konkrečių dydžių paveikslėlius, pavyzdžiui, {{ line.image | img_url: 'small' }}.
line.line_priceTo daikto kaina, padauginta iš kiekio.
line.original_line_priceBendra prekių pozicijoje esančių daiktų kaina prieš pritaikant nuolaidas.
line.final_line_priceBendra visų prekių pozicijoje esančių daiktų kaina, įskaitant visas pozicijos lygio nuolaidų sumas.
line.pre_tax_pricePrekių pozicijų kaina be mokesčių, padauginta iš nupirktos prekių pozicijos kiekio.
line.priceVieno daikto kaina.
line.product.metafields

Visi metalaukai produkto lygmeniu. Naudokite šią sintaksę:

line.product.metafields.NAMESPACE.KEY

line.product.titleDabartinis produkto pavadinimas.
line.product.vendorDaikto pardavėjas.
line.propertiesPateikia pasirinktinės informacijos apie daiktą masyvą. Prekių pozicijos savybes klientas nurodo produkto puslapyje prieš pridedant produktą į krepšelį.
line.quantityTo daikto kiekis.
line.current_quantityDabartinis daikto kiekis po pašalinimų.
line.requires_shipping(loginė reikšmė) Pateikia reikšmę „true“, jei daikto variantui produkto puslapyje yra suaktyvintas nustatymas Fizinis produktas.
line.selling_plan_allocationPateikia selling_plan_allocation objektą, kuris aprašo, kaip pardavimo planas, pavyzdžiui, prenumerata, paveikia prekių poziciją.
line.taxable(loginė reikšmė) Pateikia reikšmę „true“, jei daikto variantui produkto puslapyje yra pažymėtas žymimasis laukelis „Taikyti mokesčius šiam produktui“.
line.title

Produkto pavadinimas pardavimo metu, po kurio eina brūkšnelis ir varianto pavadinimas pardavimo metu. Varianto pavadinimas neįtraukiamas, kai jis yra „Numatytasis pavadinimas“.

Klientams skirtuose pranešimuose produkto ir varianto pavadinimai yra verčiami į kalbą, kuria klientas atsiskaitė, jei ji skiriasi nuo numatytosios parduotuvės kalbos.
line.urlSantykinis prekių pozicijos varianto URL. Santykinis URL neapima Jūsų parduotuvės pagrindinio URL (mystore.myshopify.com).
line.variant.barcodeSu produkto variantu susietas brūkšninis kodas.
line.variant.compare_at_priceSu produkto variantu susieta palyginamoji kaina.
line.variant.imageProdukto varianto vaizdas. Vaizdas pateikiamas tik tuo atveju, jei prekių pozicijoje variantui priskirtas konkretus vaizdas.
line.variant.metafields

Visi metalaukai varianto lygmenyje. Naudokite šią sintaksę:

line.variant.metafields.NAMESPACE.KEY

line.variant.skuSu produkto variantu susietas SKU.
line.variant.title

Dabartiniai varianto parinkčių reikšmių pavadinimai, sujungti / simboliais.

Pavyzdys: mažas / raudona

line.refunded.quantity(within refund notifications)

Grąžintinos prekės kiekis. Galite naudoti šią ypatybę, kad pridėtumėte identifikatorių prie užsakyme esančių grąžinamų prekių.

Pavyzdžiui: {% if line.refunded_quantity > 0 %}Refunded line identifier{% endif %}

„Shopify Collective“ prekių aptikimas pranešimų šablonuose

Shopify Collective žyma užsakymui pritaikoma išsiuntus užsakymo patvirtinimo el. laišką, todėl {% if tags contains 'Shopify Collective' %} niekada nėra true užsakymo patvirtinimo šablone. Norėdami aptikti „Shopify Collective“ prekes, verčiau tikrinkite produkto lygio žymas kiekvienoje prekių pozicijoje:

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

Prekių pozicijų grupės ypatybės

Kiekviena line_item_group sąraše line_item_groups turi šias ypatybes.

„Liquid“ ypatybių, kurias galite naudoti su prekių pozicijų grupės objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
line_item_group.display_titlePrekių pozicijų grupės pavadinimas.
line_item_group.componentsGrupei priklausančių prekių pozicijų komponentų sąrašas.
line_item_group.imagePrekių pozicijų grupės vaizdas.
line_item_group.product_idPrekių pozicijų grupės produkto ID.
line_item_group.variantPrekių pozicijų grupės varianto objektas.
line_item_group.variant_idPrekių pozicijų grupės varianto ID.

Pinigų grąžinimo ypatybės

„Liquid“ ypatybių, kurias galite naudoti su pinigų grąžinimo objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
amountGrąžinta pinigų suma.
refund_line_itemsGrąžinamų pinigų už prekių pozicijas sąrašas.

Refund_line_item ypatybės

Kiekviena refund_line sąraše refund_line_items turi šias ypatybes:

„Liquid“ ypatybių, kurias galite naudoti su grąžinamų prekių pozicijų objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
refund_line.line_itemPrekių pozicija (line_item), už kurią grąžinami pinigai. Suteikiama prieiga prie visų prekių pozicijos ypatybių.
refund_line.quantityGrąžinamos prekių pozicijos kiekis.

Užsakymo įvykdymo ypatybės

„Liquid“ ypatybių, kurias galite naudoti su užsakymo įvykdymo objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
service_nameTinkintos paslaugos pavadinimas, nustatytas puslapyje Nustatymai > Siuntimas ir pristatymas. (Tik įvykdymo užklausoms)
fulfillment.estimated_delivery_atNumatoma pristatymo data, pagrįsta sekimo numeriu (jei yra), kurį pateikė vienas iš šių vežėjų: USPS, „FedEx“, UPS, Kanados paštas (tik Kanadoje). Ši ypatybė pasiekiama tik tada, kai naudojami vežėjo apskaičiuoti įkainiai.
fulfillment.fulfillment_line_itemsVykdytinų prekių pozicijų sąrašas.
fulfillment.item_countVisų prekių kiekių suma. Bendras vykdomų prekių skaičius.
fulfillment.requires_shipping(loginė reikšmė) Pateikia „true“, jei šiai įvykdymo užklausai reikalingas pristatymas.
fulfillment.tracking_companyStebėjimą vykdanti įmonė.
fulfillment.tracking_numbersSekimo numerių sąrašas.
fulfillment.tracking_urlsStebėjimo URL sąrašas.
items_to_fulfill(deprecated)Prekių pozicijų, kurias turi įvykdyti ši konkreti pritaikyta įvykdymo paslauga, sąrašas. (Tik įvykdymo užklausai)
items_to_fulfill_count(deprecated)Bendras prekių skaičius, kurias reikia įvykdyti pagal šią užklausą. (Tik įvykdymo užklausai)

Vykdomos prekių pozicijos ypatybės

Kiekviena fulfillment_line fulfillment_line_items sąraše turi šias ypatybes.

„Liquid“ ypatybių, kurias galite naudoti su vykdomų prekių pozicijų objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
fulfillment_line.line_itemVykdoma prekių pozicija (line_item). Suteikiama prieiga prie visų prekių pozicijos ypatybių.
fulfillment_line.quantityVykdomos prekių pozicijos kiekis.

Paruoštos siuntos ypatybės

Paruoštą siuntą sudaro prekės, pažymėtos kaip paruoštos atsiimti.

„Liquid“ ypatybių, kurias galite naudoti su paruoštos siuntos objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
item_countVisų prekių kiekių suma paruoštoje siuntoje.
prepared_package_line_itemsParuoštos siuntos prekių pozicijų sąrašas.

Paruoštos siuntos prekių pozicijos ypatybės

Kiekviena prepared_package_line_item prepared_package_line_items sąraše turi šias ypatybes.

„Liquid“ ypatybių, kurias galite naudoti su paruoštos siuntos prekių pozicijos objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
line_itemSusijusi prekių pozicija (line_item). Suteikiama prieiga prie visų prekių pozicijos ypatybių.
quantityPrekių pozicijos kiekis, pažymėtas kaip paruoštas atsiimti.

Pristatymo ypatybės

„Liquid“ ypatybių, kurias galite naudoti su pristatymo objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
delivery_agreementsVisų užsakymo pristatymo susitarimų sąrašas.
delivery_instructionsVietinio pristatymo informacija, skirta bendrinti su klientu. Ši informacija valdoma laukelyje Pristatymo informacija, esančiame Jūsų vietinio pristatymo nustatymuose.
consolidated_estimated_delivery_timeUžsakymo pristatymo datų informacija, skirta bendrinti su klientu. Ši informacija valdoma apdorojimo laiko nustatymu, kurį nustatote savo puslapyje Siuntimas ir pristatymas. Kai užsakymas turi kelis pristatymo būdus, rodomas pristatymo būdų ir datų sąrašas.
has_multiple_delivery_methods(loginė reikšmė) Pateikia „true“, jei užsakymas turi kelis pristatymo būdus.

Pristatymo susitarimo ypatybės

„Liquid“ ypatybių, kurias galite naudoti su pristatymo susitarimo objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
delivery_agreement.delivery_method_typePristatymo būdo tipas.
delivery_agreement.delivery_method_namePristatymo būdo tipas, išverstas į kalbą, kuria pirkėjas atsiskaitė, jei ta kalba skiriasi nuo numatytosios parduotuvės kalbos.
delivery_agreement.line_item_groupsVisų prekių pozicijų grupių, kuriose yra susietų prekių pozicijų komponentų pristatymo susitarime, sąrašas.
delivery_agreement.line_itemsVisų su šiuo pristatymo susitarimu susijusių prekių pozicijų sąrašas.

Nuolaidos ypatybės

Yra dviejų tipų nuolaidų ypatybės.

discount_applications aprašo, kodėl ir kaip daiktui buvo pritaikyta nuolaida.

discount_allocations aprašo, kaip konkreti nuolaida paveikia prekių poziciją ir kaip ji sumažina kainą. Šią ypatybę turėtumėte naudoti prekių pozicijos lygmeniu.

Galite derinti šias ypatybes, kad parodytumėte nuolaidos informaciją prekių pozicijos arba užsakymo lygmeniu.

Pavyzdys

Šiame pavyzdyje tikrinama, ar prekių pozicijai buvo pritaikyta nuolaida. Jei nuolaida nebuvo pritaikyta užsakymo lygmeniu (all), rodomas nuolaidos pavadinimas ir suma.

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

Rezultatas gali būti panašus į šį:

SPRING5 (-$5.00)

„Discount_allocation“ ypatybės

Kiekvienas discount_allocation, esantis discount_allocations sąraše, turi šias ypatybes.

„Liquid“ ypatybių, kurias galite naudoti su „discount_allocation“ objektu pranešimų šablonuose, aprašai
YpatybėAprašymas
discount_allocation.amountPinigų suma, kurią klientas sutaupo pirkdamas prekių poziciją. Turi būti įvesta cikle, jei norite leisti naudoti kelis nuolaidų kodus.
discount_allocation.discount_applicationNuolaidos taikymas, kuris paskirsto sumą prekių pozicijai.

„Discount_application“ ypatybės

Kiekvienas discount_application, esantis discount_applications sąraše, turi šias ypatybes.

„Liquid“ ypatybių, kurias galite naudoti su „discount_application“ objektu pranešimų šablonuose, aprašai
YpatybėAprašymas
discount_application.target_selection

Aprašo, kaip nuolaida pasirenka prekių pozicijas krepšelyje, kurioms bus taikoma nuolaida. Viena iš:

  • all: nuolaida taikoma visoms prekių pozicijoms.
  • entitled: nuolaida taikoma konkrečiam prekių pozicijų poaibiui, dažnai apibrėžtam sąlyga.
  • explicit: nuolaida taikoma konkrečiai pasirinktai prekių pozicijai arba pristatymo eilutei.
discount_application.target_typeDaikto tipas, kuriam taikoma nuolaida (line_item arba shipping_line).
discount_application.title

Klientui rodomas nuolaidos pavadinimas.

Pavyzdžiai: Welcome10 arba CBBWQQAKYBYY

discount_application.total_allocated_amountBendra suma, kuria nuolaida sumažina užsakymo kainą.
discount_application.typeNuolaidos tipas. Vienas iš: automatic, discount_code, manual arba script.
discount_application.valueNuolaidos vertė.
discount_application.value_typeNuolaidos vertės tipas. Vienas iš: fixed_amount arba percentage.

Prenumeratos ypatybės

Išsami informacija apie prenumeratos sutartį, dabartinį atsiskaitymo ciklą ir jo prekių pozicijas, pristatymo būdą ir mokėjimo būdą yra prieinama visuose prenumeratos el. laiškų šablonuose.

Norėdami redaguoti prenumeratos pranešimų šablonus, įdiekite „Shopify Subscriptions“ programėlę, tada raskite šabloną Nustatymų > Pranešimų dalyje Prenumeratos.

Prenumeratos sutarties atsiskaitymo ciklo ypatybės

Norėdami pasiekti prenumeratos sutarties ir jos atsiskaitymo ciklo ypatybes, naudokite objektą subscription_contract_billing_cycle.

Pavyzdys

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

Rezultatas:

This contract is currently paused.

Ypatybės

„Liquid“ ypatybių, kurias galite naudoti su prenumeratos sutarties atsiskaitymo ciklo objektu pranešimų šablonuose, aprašai
YpatybėAprašymas
status Sutarties būsena.

Viena iš: active, paused, cancelled, failed, expired, stale,
delivery_method Prenumeratos pristatymo būdas.

Jei prenumeruojama paslauga arba skaitmeninis produktas, grąžinama nil.
billing_frequencyPrenumeratos atsiskaitymo dažnumas.
delivery_frequency Prenumeratos pristatymo dažnumas.
origin_order Pirminis užsakymas, kuriuo sukurta prenumerata.

Jei prenumerata nebuvo sukurta iš „Shopify“ užsakymo, grąžinama nil.
customerPrenumeratos klientas.
line_items Prekių pozicijos abonemento atsiskaitymo cikle.
product_namesProduktų, įtrauktų į abonemento atsiskaitymo ciklą, pavadinimų sąrašas.
update_payment_method_urlURL, kurį klientas gali naudoti norėdamas atnaujinti šios sutarties mokėjimo būdą.
shipping_address Prenumeratos pristatymo adresas.

Jei prenumeruojama paslauga arba skaitmeninis produktas, grąžinama nil.
billing_addressPrenumeratos sąskaitos pateikimo adresas.
subtotal_priceTarpinė prenumeratos prekių pozicijų kaina.
shipping_pricePrenumeratos pristatymo kaina.
total_taxBendra prenumeratos mokesčių suma.
total_priceBendra prenumeratos kaina.
total_discountsBendra prenumeratos nuolaidų suma.
customer_self_serve_urlSavitarnos URL, kurį klientas gali naudoti norėdamas tvarkyti savo prenumeratas.
billing_attempt_expected_dateŠio atsiskaitymo ciklo sąskaitos pateikimo data.
next_billing_dateKita nepraleista sąskaitos pateikimo data po šio atsiskaitymo ciklo.
last_attempted_billing_datePaskutinė bandyta sąskaitos pateikimo data atsiskaitymo ciklui.
days_overdueDienų skaičius, kiek vėluojama apmokėti sąskaitą už šį atsiskaitymo ciklą.
payment_instrumentMokėjimo priemonė, susieta su prenumeratos sutartimi. Ši mokėjimo priemonė naudojama sąskaitai klientui pateikti.

Prenumeratos sutarties prekių pozicijos ypatybės

Kiekvienos prekių pozicijos, įtrauktos į atsiskaitymo ciklą, ypatybės. Pasiekite sutarties prekių pozicijos ypatybes per pirminę ypatybę subscription_contract_billing_cycle.line_items.

Pavyzdys

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}
„Liquid“ ypatybių, kurias galite naudoti su prenumeratos sutarties prekių pozicijos objektu pranešimų šablonuose, aprašai
YpatybėAprašymas
urlPrekių pozicijos gaminio varianto išsamios informacijos puslapio URL.
requires_shippingAr prekių pozicijai reikalingas fizinis pristatymas.
unit_price_measurementPrekių pozicijos vieneto kainos matavimas.
selling_plan_allocationPrekių pozicijos pardavimo plano paskirstymas.

Prenumeratos sutarties pristatymo būdo ypatybės

Pristatymo būdo, naudojamo šiame atsiskaitymo cikle, savybės. Pristatymo būdo savybes pasiekite per pirminę savybę subscription_contract_billing_cycle.delivery_method.

Pavyzdys

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}
„Liquid“ savybių, kurias galite naudoti su prenumeratos sutarties pristatymo būdo objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
titleSu pristatymo būdu susietos pristatymo parinkties pavadinimas.
type Pristatymo būdo tipas.

Vienas iš šių: shipping, local arba pick-up.

Prenumeratos sutarties mokėjimo priemonės savybės

Išsami informacija apie prenumeratos sutarties mokėjimo priemonę. Ši mokėjimo priemonė naudojama sąskaitoms klientui išrašyti. Mokėjimo priemonės savybes pasiekite per pirminę savybę subscription_contract_billing_cycle.payment_instrument.

Pavyzdys

{% 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 }}
„Liquid“ savybių, kurias galite naudoti su prenumeratos sutarties mokėjimo priemonės objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
payment_type Mokėjimo priemonės nurodomas mokėjimo būdo tipas.

Norėdami pateikti paveikslėlio URL arba SVG, naudokite mokėjimo filtrus.
credit_card_brandKreditinės kortelės prekės ženklas.
credit_card_companyKreditinių kortelių įmonės pavadinimas.
credit_card_last_four_digitsPaskutiniai 4 kreditinės kortelės skaitmenys.

El. pašto pranešimų savybės

„Liquid“ savybių, kurias galite naudoti su el. pašto pranešimų objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
shop.email_logo_urlLogotipo URL, nurodytas administratoriaus skydelio skiltyje El. pašto šablonų pritaikymas.
shop.email_logo_widthLogotipo plotis (pikseliais), nurodytas administratoriaus skydelio skiltyje El. pašto šablonų pritaikymas.
shop.email_accent_colorAkcento spalvos HEX kodas, nurodytas administratoriaus skydelio skiltyje El. pašto šablonų pritaikymas.

Parduotuvės kredito savybės

Savybės, kuriose pateikiama išsami informacija apie parduotuvės kredito išdavimą.

„Liquid“ savybių, kurias galite naudoti su išduoto parduotuvės kredito objektu pranešimų šablonuose, aprašai.
YpatybėAprašymas
issued_store_credit.amount

Išduoto parduotuvės kredito suma.

Šią sumą galite formatuoti naudodami „Liquid“ pinigų filtrus.

issued_store_credit.expires_at

Išduoto parduotuvės kredito galiojimo pabaigos data ir laikas.

Šią sumą galite formatuoti naudodami „Liquid“ datų filtrus.

issued_store_credit.balance_after_transaction

Parduotuvės kredito sąskaitos likutis po kredito išdavimo.

Šią sumą galite formatuoti naudodami „Liquid“ pinigų filtrus.

customerKliento objektas, apimantis kliento išvesties atributus.